---
# System prepended metadata

title: Ansible docs publishing process
tags: [Documentation]

---

###### tags: `Documentation`

# Ansible docs publishing process

This document provides an audit of the Jenkins jobs that publish Ansible content and update the docsite at `docs.ansible.com`. 


Documentation source for `docs.ansible.com`:

- https://github.com/ansible/ansible/tree/devel/docs/docsite
- https://github.com/ansible/product-docs
- https://github.com/ansible/docsite

## AAP Jenkins

This section describes the jobs that run on the AAP Jenkins instance.

Build_Ansible_Package_Docs
Builds the Ansible package documentation. This is Ansible core + the collections.
Migrated from Ansible Eng Jenkins.

Build_Ansible_Package_Docs_Automated
Periodically builds the default branch from git HEAD to docs.ansible.com/ansible-core/devel/
Includes core and all collections.
Migrated from Ansible Eng Jenkins.

Build_AWX_Cli_Docs
Builds Controller CLI docs at: https://docs.ansible.com/automation-controller/latest/html/controllercli/ 
Migrated from Ansible Eng Jenkins.

Build_Docsite
Builds static pages and layout for docs.ansible.com from the ansible/docsite repo.
Duplicate job on Ansible Eng Jenkins.

Build_Tower_Swagger_Docs
Builds swagger.json and commits it to ansible/product-docs/controllerapi/source/_swagger/.

Sync_Release_Mirrors
Performs an rsync of content from the docs/releases master to the docs/releases mirrors. Basically synchronizes content to ec2 vms.

## Ansible Eng Jenkins

This section describes the jobs that run on the Ansible Eng Jenkins instance.

Build_210_docs
Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation.

Build_Ancient_Docs
Builds legacy documentation for Ansible 2.3 and 2.4.
Details in Building Ancient Ansible Docs

Build_Ansible_Core_Docs_Automated
Periodically builds the default branch from git HEAD to docs.ansible.com/ansible-core/devel/
Includes core and the builtin collections.

Build_Ansible_Docs
Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation.

Build_Ansible_Package_Docs
No longer in use.
Migrated to AAP Jenkins.

Build_Ansible_Package_Docs_Automated
No longer in use.
Migrated to Ansible Eng Jenkins.

Build_AWX_CLI_Docs
No longer in use.
Migrated from Ansible Eng Jenkins.

Build_Docsite
Builds static pages and layout for docs.ansible.com from the ansible/docsite repo.
Duplicate job on AAP Jenkins.

Build_Tower_Docs
Builds Controller documentation at: https://docs.ansible.com/automation-controller/latest/ 
Documentation - Backport job
Cherry-picks commits between branches in the ansible/product-docs repository.
Test-centos9
Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation.


