External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-01-09 23:12:08 -03:30
Code Issues Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
sean-m-sullivan 2021-02-23 11:50:29 -06:00
parent 74a5247d9d
commit ce21dec0d0
1 changed files with 18 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
docs/collections.md
View File

@ -4,26 +4,23 @@ AWX supports the use of Ansible Collections. This section will give ways to use
### Project Collections Requirements ### Project Collections Requirements
If you specify a collections requirements file in SCM at `collections/requirements.yml`, If you specify a collections requirements file in SCM at `collections/requirements.yml` of a project,
then AWX will install collections from that file to a special cache folder in project updates. then AWX will install collections from that file to a special cache folder in project updates.
Before a job runs, the roles and/or collections will be copied from the special Before a job runs, the roles and/or collections will be copied from the special
cache folder to the job temporary folder. cache folder to the job temporary folder.
The invocation looks like: The invocation looks like:
``` ```
ansible-galaxy collection install -r requirements.yml -p <project cache location>/requirements_collections ansible-galaxy collection install -r requirements.yml -p <project cache location>/_<project #>__<project name>/stage/requirements_collections
``` ```
Example of the resultant job `tmp` directory where job is running: Example of the resultant job `tmp` directory where job is running:
``` ```
├── project
│   ├── ansible.cfg
│   └── debug.yml
├── requirements_collections ├── requirements_collections
│   └── ansible_collections │   └── ansible_collections
│   └── collection_namespace │   └── namespace
│   └── collection_name │   └── collection_name
│   ├── FILES.json │   ├── FILES.json
│   ├── MANIFEST.json │   ├── MANIFEST.json
@ -38,22 +35,20 @@ Example of the resultant job `tmp` directory where job is running:
│   │   │   └── stuff.j2 │   │   │   └── stuff.j2
│   └── tests │   └── tests
│   └── main.yml │   └── main.yml
├── requirements_roles └── requirements_roles
│   └── username.role_name    └── namespace.role_name
│   ├── defaults    ├── defaults
│   │   └── main.yml    │   └── main.yml
│   ├── meta    ├── meta
│   │   └── main.yml    │   └── main.yml
│   ├── README.md    ├── README.md
│   ├── tasks    ├── tasks
│   │   ├── main.yml    │   ├── main.yml
│   │   └── some_role.yml    │   └── some_role.yml
│   ├── templates    ├── templates
│   │   └── stuff.j2    │   └── stuff.j2
│   └── vars    └── vars
│   └── Archlinux.yml    └── Archlinux.yml
└── tmp_6wod58k
``` ```
### Cache Folder Mechanics ### Cache Folder Mechanics