setup.md

One Time Setup

Here are the setup directions you have to perform one time for the ../provisioner.

Table Of Contents

• Setup
• Tower Instructions

Setup

1. Create an Amazon AWS account.

2. Create an Access Key ID and Secret Access Key. Save the ID and key for later.

• New to AWS and not sure what this step means? Click here

3. Install the following packages using pip

    pip install boto boto3 netaddr passlib pywinrm requests requests-credssp
   

Are you using Tower? Tower Instructions

4. Set your Access Key ID and Secret Access Key from Step 2 under ~/.aws/credentials

[root@centos ~]# cat ~/.aws/credentials
[default]
aws_access_key_id = ABCDEFGHIJKLMNOP
aws_secret_access_key = ABCDEFGHIJKLMNOP/ABCDEFGHIJKLMNOP

5. Clone the workshops repo:

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/provisioner

6. Run the requirements.yml file to ensure all the Ansible collection prerequisites are met.  bash ansible-galaxy collection install -r requirements.yml 

7. Some of the workshops require certain images provided via the AWS marketplace:

• For Networking you will need the Cisco CSR (Cloud Services Router) Click here, the Arista vEOS Router 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

Tower Instructions

Are you using Red Hat Ansible Tower to provision Ansible Automation Workshops? (e.g. is your control node Ansible Tower?) 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 ~]# pip install --upgrade boto3
[root@centos ~]# deactivate

Getting Help

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.