1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
## Collection tools
Tools used for building, maintaining, and testing the collection.
### Template Galaxy
The `template_galaxy.yml` playbook ran as a pre-requisite for building the collection.
```
make awx_collection_build
```
### Generate
This will template resource modules (like `group`, for groups in inventory) from a boilerplate template.
It is intended as a tool for writing new modules or enforcing consistency.
### Integration Testing
These instructions assume you have ansible-core and the collection installed.
To install the collection in-place (to pick up any local changes to source)
the `make symlink_collection` will symlink the `awx_collection/` folder to
the appropriate place under `~/.ansible/collections`.
This is a shortcut for quick validation of tests that bypasses `ansible-test`.
To use this, you need the `~/.tower_cli.cfg` config file populated,
which can be done via the deprecated `tower-cli login <username>` or manually
writing it, where the format looks like:
```
[general]
host = https://localhost:8043/
verify_ssl = false
username = admin
password = password
```
TODO: adjust playbook to allow using environment variables as well.
To run some sample modules:
```
ansible-playbook -i localhost, awx_collection/tools/integration_testing.yml
```
To run just one module (the most common use case), use the `-e test=<name>`.
```
ansible-playbook -i localhost, awx_collection/tools/integration_testing.yml -e test=host
```
If you want to run _all_ the tests, then you need to pass in the whole list.
This will take significant time and is not ideal from an error-handling perspective,
but this is a way to do it:
```
ansible-playbook -i localhost, awx_collection/tools/integration_testing.yml -e test=$(ls -1Am awx_collection/tests/integration/targets/ | tr -d '[:space:]')
```
Depending on the module, you may need special dependencies.
For instance, the rrule lookup plugins need `pytz`.
These will be satisfied if you install requirements in `awx_collection/requirements.txt`.
|
