|
 |
12bb45 |
# CentOS Infra and Releng documentation
|
|
|
12bb45 |
|
|
|
b4b5b5 |
!!! note
|
|
|
b4b5b5 |
This site is dedicated to CentOS Infrastructure documentation and is considered ***Work in progress***
|
|
|
b4b5b5 |
The goal is to consolidate various documentation[s] we have either through ansible inventories, some other git private repositories and/or elsewhere.
|
|
|
12bb45 |
|
|
|
12bb45 |
|
|
|
b4b5b5 |
This `CentOS Infra and Releng Documentation` site contains some explanations and SOPs (Standard Operating Procedure) *but* isn't a substitute for upsream documentation from all applications/components used in the CentOS Infra. So consider this a central place that will contain :
|
|
|
12bb45 |
|
|
|
b4b5b5 |
* pointers to upstream documentation (if existing)
|
|
|
b4b5b5 |
* specific notes/details about how it's implemented in infra
|
|
|
b4b5b5 |
* link[s] to Ansible Role[s] (which is/are really the `source of truth` on how app/infra is deployed and maintained)
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
Also worth knowing that it will *not* contain any sensitive information, obviously only shared through `crypted` media between trusted CentOS infra team members (but it might contain though link to other online documentation or git repositories themselves needed some authentication/ACL in place at that level, so "out of scope" for this documentation)
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
## Infra overview
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
The CentOS infra is built on top of both :
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
* [Red Hat](http://www.redhat.com) sponsored and hosted infrastructure (running critical services to build and deliver CentOS Linux / CentOS Stream / Special Interest Group[s] (SIG) content/artifacts
|
|
|
b4b5b5 |
* [Community sponsored](https://www.centos.org/sponsors) infra with machines all around the world (mostly dedicated bare-metal machines)
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
Feel free to browse all top-level sections to have a look at all services used/deployed within the CentOS infra.
|
|
|
b4b5b5 |
Each section *should* contain (as noted above) :
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
* pointers to upstream documentation (Read It First !)
|
|
|
b4b5b5 |
* pointers to Ansible role covering it
|
|
|
b4b5b5 |
* some URLs for the application (if any and/or public)
|
|
|
b4b5b5 |
* level of access needed to configure/update/deploy it
|
|
|
b4b5b5 |
* how the application/infra/service is monitored
|
|
|
b4b5b5 |
* some SOPs for `daily/common` operations/tasks
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
Worth also knowing that this site is automatically rendered from a [git repository](https://git.centos.org/centos/centos-infra-docs) (including also a way to render it locally to browse it through localhost) , so feel free to also submit Pull Request there if you find something that needs to be fixed/updated !
|
|
|
b4b5b5 |
|
|
|
b4b5b5 |
!!! tip
|
|
|
b4b5b5 |
You can use the `search` feature/box on top level to search for some specific topics or keywords
|