Infrastructure/GettingStarted

From FedoraProject

< Infrastructure(Difference between revisions)
Jump to: navigation, search
(moving the text and link around for docs)
(What is next?)
 
(15 intermediate revisions by 7 users not shown)
Line 5: Line 5:
  
 
We're looking for dedicated and energetic people to join the fun times in the Fedora Infrastructure team. What fun stuff will you do to support and grow the Fedora community?
 
We're looking for dedicated and energetic people to join the fun times in the Fedora Infrastructure team. What fun stuff will you do to support and grow the Fedora community?
* You will help Design and Implement Highly Available and Fault Tolerant Systems
+
* You will help design and implement highly available and fault tolerant systems
* Fix System Issues for Grateful Fedora developers
+
* Fix system issues for grateful Fedora developers
* Maintain the Servers that make the Fedora Project possible
+
* Maintain the servers that make the Fedora Project possible
* Create and Maintain Custom Tools and Applications to Automate Systems Maintenance
+
* Create and maintain custom tools and applications to automate systems maintenance
* Create and Maintain Tools and Applications to Enhance and Grow the Fedora community
+
* Create and maintain tools and applications to enhance and grow the Fedora community
 
+
  
 
The skills you should possess or be willing to learn to do this work include:
 
The skills you should possess or be willing to learn to do this work include:
* Being Polite
+
* Being polite
* How to Help Fellow Hackers
+
* Being patient
* How to Write Systems Administration Scripts
+
* How to help fellow hackers
* How to Write Web Applications
+
* How to write systems administration scripts
** We primarily use Python, SQL and Associated Technologies
+
* How to write web applications
 +
** We primarily use Python, SQL and associated technologies
 
** Other equivalent technologies are welcome
 
** Other equivalent technologies are welcome
 
** We can especially use skills in this area or folks that are willing to learn
 
** We can especially use skills in this area or folks that are willing to learn
* How the Fedora Project Works "Behind the Scenes"
+
* How the Fedora Project works "behind the scenes"
 
+
  
 
It would be great if
 
It would be great if
* You Have Previous Systems Admin Experience
+
* You have previous systems admin experience
* Have Access to Your Own Testing Machines
+
* Have access to your own testing machines
 
**Our resources are limited, especially for testing!
 
**Our resources are limited, especially for testing!
* Work in Other Areas of Fedora like Packaging or Documentation
+
* Work in other areas of Fedora like packaging or documentation
  
 
== Getting Started ==
 
== Getting Started ==
Read through the [[Infrastructure/GettingStarted#Primary_Steps | ''Primary Steps'']] to learn how to start on the path to helping the Fedora Infrastructure group and then when you're ready for more, read through the [[Infrastructure/GettingStarted#What_do_I_do_next? | ''What do I do next?'']] section.
 
  
===Primary Steps===
+
See below for a list of steps or head down to the [[Infrastructure/GettingStarted#QuickStart | Quick Start]] section if you just want to submit a single change or fix.
 +
 
 +
===First steps===
  
 
* First you will need to read through and understand [[how to be a successful contributor]].
 
* First you will need to read through and understand [[how to be a successful contributor]].
 
* Next you will need to create a [[Infrastructure/AccountSystem| Fedora Account]]:
 
* Next you will need to create a [[Infrastructure/AccountSystem| Fedora Account]]:
 
** This account will be used for just about everything you do as a member of the Fedora Community
 
** This account will be used for just about everything you do as a member of the Fedora Community
** You will need it to sign the [http://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement FPCA]) which is required to contribute to the Fedora Community
+
** You will need it to sign the [[Legal:Fedora_Project_Contributor_Agreement|FPCA]] which is required to contribute to the Fedora Community
 
** You will need it to login to various systems associated with the Infrastructure Group
 
** You will need it to login to various systems associated with the Infrastructure Group
 
** You will need it to upload code changes, make changes to this wiki and etc.  
 
** You will need it to upload code changes, make changes to this wiki and etc.  
* After you have created your account and signed the CLA, you should then subscribe to the [https://admin.fedoraproject.org/mailman/listinfo/infrastructure Fedora Infrastructure Mailing List] as you will use this to send your "Hello World!" to the Fedora Infrastructure Team as well as communicate with other team members
+
* After you have created your account and signed the FPCA, you should then subscribe to the [https://lists.fedoraproject.org/admin/lists/infrastructure.lists.fedoraproject.org/ Fedora Infrastructure Mailing List] as you will use this to send your "Hello World!" to the Fedora Infrastructure Team as well as communicate with other team members
* When you are ready to send your [mailto:infrastructure@lists.fedoraproject.org introduction to the group] your subject should be 'Meeting Agenda Item: Introduction ''Your Name''' and the message body should include:
+
* When you are ready send a [mailto:infrastructure@lists.fedoraproject.org introduction to the group], your subject should be 'Meeting Agenda Item: Introduction ''Your Name'''. The message body should include:
**Your IRC handle [http://fedoraproject.org/wiki/Communicate/IRCHowTo (What's this?)]
+
** Your IRC handle
**What skills you have to offer and which you would like to learn
+
*** [[Communicate/IRCHowTo|''What's this?'']]
**What you would like to work on and quite possibly which [https://fedorahosted.org/fedora-infrastructure/report/1 outstanding issues] you would like to help resolve
+
*** [https://fedoramagazine.org/beginners-guide-irc/ Beginner's Guide to IRC]
**After you send your "Hello World!" to the Fedora Infrastructure Group a greeter should respond to you on the mailing list offering to help you get started. But don't feel like you have to wait for this message, you can also join the #fedora-admin channel on IRC and ask for a greeter to help you out!
+
** What skills you have to offer and which you would like to learn. This can include...
 +
*** Programming languages you are familiar with or have used
 +
*** Systems administration skills, certifications, and technologies you have or have used (or wish to learn)
 +
*** Any associations you have (e.g. local hackerspace / makerspace, Linux User Groups, employer, etc.)
 +
* What you want to learn
 +
** What you would like to work on and quite possibly which [http://pagure.io/fedora-infrastructure/issues outstanding issues] you would like to help resolve
 +
* Any initial questions you have for the team
 +
** Be patient, as sometimes folks are busy and might not reply to your email quickly. You may get a faster response on IRC.  
 +
** join the #fedora-admin channel on IRC and attend the next IRC meeting.
 +
** Watch [http://fedoramagazine.org/?p=642 some videos] intended to introduce new contributors to the team.
  
===What do I do next?===
+
===What is next?===
After you've completed the steps outlined in the [[Infrastructure/GettingStarted#Primary_Steps | ''Primary Steps'']] section you should
+
  
* Regularly attend the [[Infrastructure/Meetings|Weekly Meetings]] on IRC and be sure to introduce yourself the first time you attend.
+
After you've completed the steps outlined in the [[Infrastructure/GettingStarted#Primary_Steps | ''First Steps'']] section you should
 +
 
 +
* Regularly attend the [[Infrastructure/Meetings|Weekly Meetings]] on IRC and be sure to introduce yourself the first time you attend. There is a section at the start of the meeting where you can give a short introduction of yourself to the rest of the team.
 
* Take some time to learn about the [https://fedoraproject.org/wiki/Infrastructure/Services services] the Fedora Infrastructure Group develops, deploys and maintains.
 
* Take some time to learn about the [https://fedoraproject.org/wiki/Infrastructure/Services services] the Fedora Infrastructure Group develops, deploys and maintains.
* Pick a [[Infrastructure/FIGs|FIG]] and become familiar with the team lead and members.
 
 
* Ask about joining the [[Infrastructure_Apprentice|Fedora Infrastructure Apprentice]] (fi-apprentice) group.
 
* Ask about joining the [[Infrastructure_Apprentice|Fedora Infrastructure Apprentice]] (fi-apprentice) group.
* [[Infrastructure/GettingSponsored|Get Sponsored]].  Find sponsors in the FIG you've selected and keep bugging them until someone says yes.  Constantly coming back and saying I want to help says a lot but picking an [https://fedorahosted.org/fedora-infrastructure/report/1 item to resolve] and showing that you've researched a solution or would like to help solve it says even more!
+
* Read up on SOPs [https://infrastructure.fedoraproject.org/infra/docs/ ] you find interesting. These are a good point of reference for hosts related to an app. They give an overview of how things work for that app.
* Read up a SOP [http://infrastructure.fedoraproject.org/infra/docs/ ] related to one of your interest. These are a good point of reference for hosts related to an app. They give an overview of how things work for that app.
+
* Idle in IRC and chime in with questions or offers to help when you see an interesting problem being discussed.
 
+
* Setup [[Gobby|Gobby]] so you can see and add to our weekly meeting agenda.
 +
* Look at our [https://fedoraproject.org/easyfix/#fedora-infrastructure Fedora Infrastructure Easyfix] issues for one that is of interest.
  
 
If you don't have the time to be involved on a regular basis at this point, please feel free to watch over things and report bugs and RFEs as you see fit.  Showing interest now is a great way to make it easier to join the team's activities later!
 
If you don't have the time to be involved on a regular basis at this point, please feel free to watch over things and report bugs and RFEs as you see fit.  Showing interest now is a great way to make it easier to join the team's activities later!
 +
 +
===QuickStart===
 +
 +
* If you just want to make a single change or fix a single issue, then just jump right in at attach a patch for it to the existing issue, or post a patch to the mailing list. Note that we still would like you to create an account and sign the FPCA so we can properly license your contributions.
  
 
== How the team works ==
 
== How the team works ==
  
The Fedora Infrastructure Group consists of volunteers and Red Hat employees.  Our preferred method of communication is IRC on freenode.net in {{fpchat|#fedora-admin}} channel though we also heavily use the Fedora {{fplist|Infrastructure}} Mailing List.  We try to be as transparent as possible though when security is involved we'll probably use our private list.
+
The Fedora Infrastructure Group consists of volunteers and Red Hat employees.  Our preferred method of communication is IRC on freenode.net in {{fpchat|#fedora-admin}} channel though we also heavily use the Fedora {{fplist|Infrastructure}} Mailing List.  We try to be as transparent as possible, and default to open.
 +
 
 +
New members are encouraged to join the list, IRC and attend meetings.
 +
 
 +
Asking questions (in any of our public areas: IRC, lists, meetings) is encouraged. Unless there's an outage or people are busy we are happy to try and explain how something is setup or works.
  
New members are encouraged to join the list and attend a few meetings before they request sponsorship. Getting a feel for how the group works is important and should not be neglected.
+
The team is a meritocracy, which means those people who solve issues and do work are given more privileges over time. In general don't worry about the access and privileges, instead try and solve problems and prove that you will be around and reliable over time and you will be setup with what you need to do that work. Since we are a small team we don't usually have the cycles to do full time mentoring of new contributors, so you will be expected to be a "self starter" and able to gather information on your own. We are happy to answer questions when you get stuck.
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]

Latest revision as of 15:20, 7 December 2016

Infrastructure InfrastructureTeamN1.png


Contents

[edit] Help Wanted

We're looking for dedicated and energetic people to join the fun times in the Fedora Infrastructure team. What fun stuff will you do to support and grow the Fedora community?

  • You will help design and implement highly available and fault tolerant systems
  • Fix system issues for grateful Fedora developers
  • Maintain the servers that make the Fedora Project possible
  • Create and maintain custom tools and applications to automate systems maintenance
  • Create and maintain tools and applications to enhance and grow the Fedora community

The skills you should possess or be willing to learn to do this work include:

  • Being polite
  • Being patient
  • How to help fellow hackers
  • How to write systems administration scripts
  • How to write web applications
    • We primarily use Python, SQL and associated technologies
    • Other equivalent technologies are welcome
    • We can especially use skills in this area or folks that are willing to learn
  • How the Fedora Project works "behind the scenes"

It would be great if

  • You have previous systems admin experience
  • Have access to your own testing machines
    • Our resources are limited, especially for testing!
  • Work in other areas of Fedora like packaging or documentation

[edit] Getting Started

See below for a list of steps or head down to the Quick Start section if you just want to submit a single change or fix.

[edit] First steps

  • First you will need to read through and understand how to be a successful contributor.
  • Next you will need to create a Fedora Account:
    • This account will be used for just about everything you do as a member of the Fedora Community
    • You will need it to sign the FPCA which is required to contribute to the Fedora Community
    • You will need it to login to various systems associated with the Infrastructure Group
    • You will need it to upload code changes, make changes to this wiki and etc.
  • After you have created your account and signed the FPCA, you should then subscribe to the Fedora Infrastructure Mailing List as you will use this to send your "Hello World!" to the Fedora Infrastructure Team as well as communicate with other team members
  • When you are ready send a introduction to the group, your subject should be 'Meeting Agenda Item: Introduction Your Name'. The message body should include:
    • Your IRC handle
    • What skills you have to offer and which you would like to learn. This can include...
      • Programming languages you are familiar with or have used
      • Systems administration skills, certifications, and technologies you have or have used (or wish to learn)
      • Any associations you have (e.g. local hackerspace / makerspace, Linux User Groups, employer, etc.)
  • What you want to learn
    • What you would like to work on and quite possibly which outstanding issues you would like to help resolve
  • Any initial questions you have for the team
    • Be patient, as sometimes folks are busy and might not reply to your email quickly. You may get a faster response on IRC.
    • join the #fedora-admin channel on IRC and attend the next IRC meeting.
    • Watch some videos intended to introduce new contributors to the team.

[edit] What is next?

After you've completed the steps outlined in the First Steps section you should

  • Regularly attend the Weekly Meetings on IRC and be sure to introduce yourself the first time you attend. There is a section at the start of the meeting where you can give a short introduction of yourself to the rest of the team.
  • Take some time to learn about the services the Fedora Infrastructure Group develops, deploys and maintains.
  • Ask about joining the Fedora Infrastructure Apprentice (fi-apprentice) group.
  • Read up on SOPs [1] you find interesting. These are a good point of reference for hosts related to an app. They give an overview of how things work for that app.
  • Idle in IRC and chime in with questions or offers to help when you see an interesting problem being discussed.
  • Setup Gobby so you can see and add to our weekly meeting agenda.
  • Look at our Fedora Infrastructure Easyfix issues for one that is of interest.

If you don't have the time to be involved on a regular basis at this point, please feel free to watch over things and report bugs and RFEs as you see fit. Showing interest now is a great way to make it easier to join the team's activities later!

[edit] QuickStart

  • If you just want to make a single change or fix a single issue, then just jump right in at attach a patch for it to the existing issue, or post a patch to the mailing list. Note that we still would like you to create an account and sign the FPCA so we can properly license your contributions.

[edit] How the team works

The Fedora Infrastructure Group consists of volunteers and Red Hat employees. Our preferred method of communication is IRC on freenode.net in #fedora-admin[?] channel though we also heavily use the Fedora Infrastructure Mailing List. We try to be as transparent as possible, and default to open.

New members are encouraged to join the list, IRC and attend meetings.

Asking questions (in any of our public areas: IRC, lists, meetings) is encouraged. Unless there's an outage or people are busy we are happy to try and explain how something is setup or works.

The team is a meritocracy, which means those people who solve issues and do work are given more privileges over time. In general don't worry about the access and privileges, instead try and solve problems and prove that you will be around and reliable over time and you will be setup with what you need to do that work. Since we are a small team we don't usually have the cycles to do full time mentoring of new contributors, so you will be expected to be a "self starter" and able to gather information on your own. We are happy to answer questions when you get stuck.