Blame docs/index.md

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
ee6248
ee6248
## Available Environments
ee6248
ee6248
While the same automation code should be used to configure all infra/services nodes within CentOS Infra, it's worth knowing that we still "divide" it into sub-sections, and so having different environments.
6d98f4
Let's just have a quick look at the existing environments, *each* using its own dedicated [Ansible](ansible/index.md) inventory, and so various settings and/or permitted access :
ee6248
ee6248
  * `CentOS main` : if not defined, all the nodes considered as "production" nodes and managed as such
ee6248
    * `CentOS staging` (STG) : pre-prod environment, with limited number of nodes, but mostly used to test changes/deployments before being rolled-out to the `CentOS main` one
ee6248
    * `CentOS dev`  (DEV) : really ephemeral setup pointing to very low spec machines (usually VMs) to test new stack/applications and write automation before being then deployed in `CentOS staging`
ee6248
  * `CentOS CI` : everything that is configuring/deploying the infra behind `ci.centos.org` domain (public or internal)
ee6248
  * `CentOS Stream MVBE` : dedicated/isolated environment for CentOS Stream 9 buildsys and having its own inventory/rollout strategy
6f32ae
6f32ae
6f32ae
## CentOS Infra team
6f32ae
6d98f4
See the [dedicated section](infra/team.md)