diff --git a/modules/sysadmin_guide/nav.adoc b/modules/sysadmin_guide/nav.adoc index ad7d756..62984ed 100644 --- a/modules/sysadmin_guide/nav.adoc +++ b/modules/sysadmin_guide/nav.adoc @@ -48,7 +48,6 @@ ** xref:haproxy.adoc[Haproxy Infrastructure - SOP] ** xref:hotfix.adoc[HOTFIXES - SOP] ** xref:hotness.adoc[The New Hotness - SOP] -** xref:index.adoc[index - SOP in review ] ** xref:infra-git-repo.adoc[infra-git-repo - SOP in review ] ** xref:infra-hostrename.adoc[infra-hostrename - SOP in review ] ** xref:infra-raidmismatch.adoc[infra-raidmismatch - SOP in review ] diff --git a/modules/sysadmin_guide/pages/index.adoc b/modules/sysadmin_guide/pages/index.adoc index c8098a5..9c0bef9 100644 --- a/modules/sysadmin_guide/pages/index.adoc +++ b/modules/sysadmin_guide/pages/index.adoc @@ -2,19 +2,19 @@ Welcome to The Fedora Infrastructure system administration guide. -[[sysadmin-getting-started]] == Getting Started If you haven't already, you should complete the general -`getting-started` guide. Once you've completed that, you're ready to get +https://fedora-infra-docs.readthedocs.io/en/latest/index.html#getting-started[Getting Started] guide. +Once you've completed that, you're ready to get involved in the -https://admin.fedoraproject.org/accounts/group/view/fi-apprentice[Fedora +https://accounts.fedoraproject.org/group/fi-apprentice/[Fedora Infrastructure Apprentice] group. === Fedora Infrastructure Apprentice The -https://admin.fedoraproject.org/accounts/group/view/fi-apprentice[Fedora +https://accounts.fedoraproject.org/group/fi-apprentice/[Fedora Infrastructure Apprentice] group in the Fedora Account System grants read-only access to many Fedora infrastructure machines. This group is used for new folks to look around at the infrastructure setup, check @@ -23,7 +23,6 @@ moving forward. This also allows apprentices to examine and gather info on problems, then propose solutions. [NOTE] -.Note ==== This group will be pruned often of inactive folks who miss the monthly email check-in on the @@ -33,7 +32,7 @@ re-join later when you have more time, we just want to make sure the group only has active members. ==== -Members of the https://admin.fedoraproject.org/accounts/group/view/fi-apprentice[Fedora +Members of the https://accounts.fedoraproject.org/group/fi-apprentice/[Fedora Infrastructure Apprentice] group have ssh/shell access to many machines, but no sudo rights or ability to commit to the https://pagure.io/fedora-infra/ansible/[Ansible repository] (but they do @@ -41,7 +40,7 @@ have read-only access). Apprentice can, however, contribute to the infrastructure documentation by making a pull request to the https://pagure.io/infra-docs/[infra-docs] repository. Access is via the bastion.fedoraproject.org machine and from there to each machine. See -the `ssh-sop` for instructions on how to set up SSH. You can see a list +the xref:ssh.adoc[ssh-sop] for instructions on how to set up SSH. You can see a list of hosts that allow apprentice access by using: .... @@ -64,10 +63,10 @@ https://pagure.io/fedora-infra/ansible/[Ansible repository], you should make your change, produce a patch with `git diff`, and attach it to the infrastructure ticket you are working on. It will then be reviewed. -[[sops]] == Standard Operating Procedures Below is a table of contents containing all the standard operating procedures for Fedora Infrastructure applications. For information on how to write a new standard operating procedure, consult the guide on -`develop-sops`. +https://fedora-infra-docs.readthedocs.io/en/latest/dev-guide/sops.html#develop-sops[Developing +Standard Operating Procedures].