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

Add collection integration test instructions to the README

Browse Source
This commit is contained in:
Caleb Boylan
2020-02-28 19:48:18 -08:00
parent afbeacf499
commit d14bf00f6c
1 changed files with 25 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
awx_collection/README.md
View File

@@ -37,7 +37,7 @@ To use this collection in AWX, you should create a custom virtual environment in
to set the job template `extra_vars` to include `ansible_python_interpreter` to set the job template `extra_vars` to include `ansible_python_interpreter`
to be the Python in that virtual environment. to be the Python in that virtual environment.
## Running Tests ## Running Unit Tests
Tests to verify compatibility with the most recent AWX code are Tests to verify compatibility with the most recent AWX code are
in `awx_collection/test/awx`. These tests require that Python packages in `awx_collection/test/awx`. These tests require that Python packages
@@ -71,6 +71,30 @@ pip install -e .
PYTHONPATH=awx_collection:$PYTHONPATH py.test awx_collection/test/awx/ PYTHONPATH=awx_collection:$PYTHONPATH py.test awx_collection/test/awx/
``` ```
## Running Integration tests Tests
The integration tests require a virtualenv with `ansible` >= 2.9 and `tower_cli`.
The collection must first be installed, which can be done using `make install_collection`.
You also need a configuration file at `~/.tower_cli.cfg` or
`/etc/tower/tower_cli.cfg` with the credentials for accessing tower. This can
be populated using `tower-cli`:
```
tower-cli config host $HOST
tower-cli config username $USERNAME
tower-cli config password $PASSWORD
# This tells the tower-cli not to veriffy the ssl certs in the tower, if your tower has good certs you should leave this to true
tower-cli config verify_ssl false
```
Finally you can run the tests:
```
# ansible-test must be run from the directory in which the collection is installed
cd ~/.ansible/collections/ansible_collections/awx/awx/
ansible-test integration
```
## Building ## Building
The build target `make build_collection` will template out a `galaxy.yml` file The build target `make build_collection` will template out a `galaxy.yml` file