External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-03-10 14:09:28 -02:30
Code Issues Packages Projects Releases Wiki Activity

Updated build_system docs

Browse Source
This commit is contained in:
James Laska
2014-12-03 08:43:10 -05:00
parent 987fd4b3e0
commit 4d99e917ce
1 changed files with 17 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
docs/build_system.md
View File

@@ -1,10 +1,10 @@
Build and Release Process Build and Release Process
========================= =========================
This document describes the AWX Software build and release process. This document describes the Ansible Tower Software build and release process.
This process includes the automation of the packaging for Debian/Ubuntu This process includes the automation of the packaging for Debian/Ubuntu and
and Fedora/EL (Enterprise Linux), as well as the creation of various Fedora/EL (Enterprise Linux), as well as the creation of various software
software repositories which are used by the default playbook setup. repositories which are used by the default playbook setup.
Packaging Details Packaging Details
----------------------------- -----------------------------
@@ -47,10 +47,6 @@ The sdist build is the first step in the packaging process. This step is
responsible for assembling the files to be packaged into a .tar.gz, which responsible for assembling the files to be packaged into a .tar.gz, which
can then be installed itself via pip or used later for the RPM/DEB builds. can then be installed itself via pip or used later for the RPM/DEB builds.
We are currently overriding the default python sdist function, as we are
pre-compiling all .py files into .pyc's and removing the plain source. This
is handled by the function `sdist_awx()` in `setup.py`.
The resulting tar.gz file will be named: The resulting tar.gz file will be named:
ansible-tower-${VERSION}-${RELEASE}.tar.gz ansible-tower-${VERSION}-${RELEASE}.tar.gz
@@ -198,8 +194,8 @@ In order to create apt repositories, the reprepro package was also installed.
There are currently three classes of jobs configured in Jenkins: There are currently three classes of jobs configured in Jenkins:
- RPM/DEB builds for Ansible Core - `Build_Ansible_{RPM,DEB,TAR,Docs}` builds for Ansible
- RPM/DEB builds for AWX (and tar packaging of the setup playbook/scripts) - `Build_Tower_{RPM,DEB,TAR,Docs}` builds for Ansible Tower
- Automated Scans which kick-off the prior two jobs - Automated Scans which kick-off the prior two jobs
The automated scans work by checking for new tags in the git repository for The automated scans work by checking for new tags in the git repository for
@@ -243,29 +239,28 @@ Repositories
The nightly repositories are hosted on the AnsibleWorks Jenkins server, and can The nightly repositories are hosted on the AnsibleWorks Jenkins server, and can
be found at the following location: be found at the following location:
http://50.116.42.103/awx_nightlies_RTYUIOPOIUYTYU/ http://50.116.42.103/ansible-tower_nightlies_RTYUIOPOIUYTYU/
There are two sub-folders: `deb/` and `rpm/`. There are several sub-folders, including `deb/`, `rpm/`, `docs/` and `setup/`
The `rpm/` folder itself contains sub-folders for each distribution/architecture The `rpm/` folder itself contains sub-folders for each distribution/architecture
that we support, for example: that we support, for example:
- epel-6-{i386,x86_64} - epel-6-{i386,x86_64}
- fedora-17-{i386,x86_64} - epel-7-{i386,x86_64}
- fedora-18-{i386,x86_64}
- fedora-19-{i386,x86_64}
The `deb/` folder contains several subfolders, which correspond to the normal The `deb/` folder contains several subfolders, which correspond to the normal
apt repository structure. All .deb files are located under `pool/`, while the `dists/` apt repository structure. All .deb files are located under `pool/`, while the `dists/`
directory contains the distribution-specific information. directory contains the distribution-specific information.
These nightly repositories can be used by the AWX setup playbook by running the The `docs/` folder contains the PDF documentation.
`setup.sh` shell script with the following option:
./setup.sh -e "aw_repo_url=http://50.116.42.103/awx_nightlies_RTYUIOPOIUYTYU" The `setup/` folder contains the Ansible Tower setup playbook tar.gz file.
> Note that if this is not a fresh installation, you should run the following: These nightly repositories can be used by the Ansible Tower setup playbook by
> "yum clean all --enablerepo=ansibleworks-awx" in order to clean out the yum cache. running the `setup.sh` shell script with the following option:
./setup.sh -e "aw_repo_url=http://50.116.42.103/ansible-tower_nightlies_RTYUIOPOIUYTYU"
### Official Releases ### ### Official Releases ###
@@ -274,7 +269,5 @@ found at the following location:
http://releases.ansible.com/ansible-tower/ http://releases.ansible.com/ansible-tower/
The AWX setup playbook will use this repo location by default. The Ansible Tower setup playbook will use this repo location by default.