Here are the setup directions you have to perform one time for the workshop provisioner.
- One Time Setup
- Table Of Contents
- 1. Create an Amazon AWS account.
- 2. Create an Access Key ID and Secret Access Key.
- 3. Install the following packages
- 4. Set your Access Key ID and Secret Access Key
- 5. Clone the workshops repo:
- 6. Run the requirements.yml file to ensure all the Ansible collection prerequisites are met.
- 7. Subscribe to AWS marketplace images
- 8. One time setup Complete
- Automation controller Instructions
- Go to the AWS Article if you need help on opening an AWS account.
- New to AWS and not sure what this step means? Click here
- Save the ID and key for later.
| package | dnf |
pip |
|---|---|---|
| git | git |
N/A |
| ansible-core 2.11 or newer | ansible-core |
ansible-core |
boto3 - required for amazon.aws collection |
python3-boto3 |
boto3 |
| netaddr | python3-netaddr |
netaddr |
| passlib | python3-passlib |
passlib |
| Requests | python3-requests |
requests |
Example installation with dnf:
dnf install python3-boto
Example installation with pip (recommended to use a virtualenv):
python3 -m pip install boto3
For the network workshop you must also install paramiko version 2.8.1
| package | dnf |
pip |
|---|---|---|
| paramiko | python3-paramiko |
paramiko==2.8.1 |
python3 -m pip install paramiko==2.8.1
Recommended to use pip for this package since we don't have exchaustive test list of every OS and what paramiko version ships with it.
Why paramiko 2.8.1? See issue: 76737. Paramiko will be replaced by libssh in the future.
The windows workshops will also require pywinrm and requests-credssp
| package | dnf |
pip |
|---|---|---|
| pywinrm | python3-winrm |
pywinrm |
| requests-credssp | python3-requests-credssp |
requests-credssp |
Are you using Automation Controller (formerly Ansible Tower)? Automation Controller Instructions
The access key and secret access key that you created from Step 2 should be stored under ~/.aws/credentials
[root@centos ~]# cat ~/.aws/credentials
[default]
aws_access_key_id = ABCDEFGHIJKLMNOP
aws_secret_access_key = ABCDEFGHIJKLMNOP/ABCDEFGHIJKLMNOP
If you haven't done so already make sure you have the repo cloned to the machine executing the playbook
git clone https://github.com/ansible/workshops.git
cd workshops/

 ansible-galaxy collection install -r collections/requirements.yml 
Some of the workshops require specific images provided via the AWS marketplace:
- For Networking you will need the Cisco CSR (Cloud Services Router) Click here, the Arista CloudEOS Router (PAYG) Click here, AND the Juniper vSRX NextGen Firewall Click here
- For F5 you will need the F5 BIG-IP Click here
- For the security workshop the Check Point CloudGuard Security Management and the Check Point CloudGuard Network Security
Return to workshop provisioner instructions
NOTE Sean needs to update this for Execution Environments (EE), the plan is to automatically create an EE that will spin up workshops with all requirements built-in.
Are you using Red Hat Ansible Automation Controller to provision Ansible Automation Workshops? (e.g. is your control node Ansible Automation Controller?) Make sure to use umask for the installation of boto3 on the control node. https://docs.ansible.com/ansible-tower/latest/html/upgrade-migration-guide/virtualenv.html
[user@centos ~]$ sudo -i
[root@centos ~]# source /var/lib/awx/venv/ansible/bin/activate
[root@centos ~]# umask 0022
[root@centos ~]# dnf install -y python3-boto3
[root@centos ~]# deactivate
Please file issues on Github. Please fill out all required information. Your issue will be closed if you skip required information in the Github issues template.
