Get started with Ansible - an introduction for Python developers Ansible: Provisioning and Configuration Management Molecule: Test your Ansible Playbooks on Docker, Vagrant or Cloud Vagrant: Test images with vagrant

1. Ansible Workshop for Pythonistas
Get Started with Best Practices
Mihai Criveti, Cloud Native Competency Leader at IBM
January 21, 2020
1

2. User Stories
Ansible: Provisioning and Configuration Management
Molecule: Test your Ansible Playbooks on Docker, Vagrant or Cloud
Vagrant: Test images with vagrant
2

3. User Stories

4. Bootstrap Python
As a: UNIX and Linux system administrator
I want to:
• automatically install the required python version on the system
• Python 2 on RHEL 7 or older systems, supporting yum and selinux
• Python 3 on RHEL 8 or Fedora, supporting dnf
• Python 3 on Debian systems
So that: I can manage the system using Ansible.
https://galaxy.ansible.com/crivetimihai/bootstrap
3

5. Configure Users
As a: UNIX and Linux system administrator
I want to:
• add users and groups to the system from a list
• configure defined or random passwords, optionally store them in a vault
• configure SSH key access
So that: I can automate my OS post-deployment and user management steps.
https://galaxy.ansible.com/crivetimihai/users
4

6. Setup dotfiles
As a: Linux User
I want to:
• copy my dotfiles and cofiguration to a new or existing system
• keep my configuration under version control and use symlinks
So that: I can easily move between systems.
https://galaxy.ansible.com/crivetimihai/dotfiles
5

7. Install Anaconda
As a: Pythonista
I want to: install Anaconda Python
So that: use conda and install python modules as a regular user.
https://galaxy.ansible.com/crivetimihai/anaconda
6

8. Install VS Code
As a: Developer
I want to: Install Visual Studio Code (VSCode) and modules
So that: I can write code.
https://galaxy.ansible.com/crivetimihai/vscode
7

9. Install Docker
As a: UNIX and Linux system administrator
I want to: Install Docker-CE
So that: I can build and run containers.
https://galaxy.ansible.com/crivetimihai/docker
8

10. Example Usage
Install and run
ansible-galaxy install crivetimihai.bootstrap
ansible-playbook bootstrap-playbook.yml
playbook
- name: bootstrap python
hosts: all
gather_facts: false
tasks:
- name: bootstrap is configured
import_role:
name: crivetimihai.bootstrap
9

11. Ansible: Provisioning and
Configuration Management

12. Application Deployment, Configuration Management, Continuous Delivery
Figure 1: Ansible Overview
10

13. What can I do with Ansible?
Figure 2: Ansible Features
11

14. Ansible Supports Technologies You Use Today
Figure 3: Ansible Technologies
12

15. Ansible Overview
Figure 4: Ansible Overview
13

16. Ansible Tower
Figure 5: Ansible Tower
14

17. Ansible for Enterprise: Architecture
15

18. Getting Started with Ansible
Install ansible from pip
pip install ansible
Running ad-hoc commands
ansible -m setup localhost
localhost | SUCCESS => {
"ansible_facts": {
"ansible_all_ipv4_addresses": [
"172.18.0.1",
"172.19.0.1",
"172.17.0.1",
"141.125.85.138",
"10.196.49.9",
"192.168.122.1"
16

19. Getting Help
Search for an appropriate module (~3000 existing) and get help
ansible-doc -l | grep pip
Using the examples section
ansible-doc pip
# Install (Bottle) into the specified (virtualenv), using Python 2.7
- pip:
name: bottle
virtualenv: /my_app/venv
virtualenv_command: virtualenv-2.7
17

20. Using ansible-doc snippet
ansible-doc -s pip
- name: Manages Python library dependencies
pip:
chdir: # cd into this directory
editable: # Pass the editable flag.
executable: # The explicit executable or a pathname
extra_args: # Extra arguments passed to pip.
name: # Python library to install or the url
requirements: # The path to a pip requirements file
state: # absent, forcereinstall, latest, present
18

21. Ansible Playbooks
Run ansible:
ansible-playbook -i localhost, playbook.yml
playbook.yml
- hosts: all
connection: local
become: yes
gather_facts: yes
roles:
- role: kvm
19

22. What’s inside a playbook?
tasks/install.yml
- name: install RedHat packages
package:
name: "{{ redhat_packages }}"
state: present
become: yes
vars/main.yml
redhat_packages:
- policycoreutils-python-utils
- qemu-kvm
- qemu-img
20

23. Molecule: Test your Ansible
Playbooks on Docker, Vagrant or
Cloud

24. Ansible Molecule
Creating a vagrant or docker machine and trigger goss tests:
molecule create -s vagrant-centos-7
molecule converge -s vagrant-centos-7
molecule login
In one step
molecule test
Another OS:
molecule create -s docker-ubuntu-18.04
21

25. Inside Molecule
molecule.yml with Fedora 30 running on Docker
driver:
name: docker
provider:
name: docker
lint:
name: yamllint
platforms:
- name: pandoc-fedora-30
image: fedora:30
dockerfile: ../resources/Dockerfile.j2
provisioner:
name: ansible
22

26. Molecule Cookie Cutter Templates
Cookiecutter: Better Project Templates
• Cookiecutter creates projects from project templates, e.g. Ansible role structure,
with molecule tests.
• Molecule provides a native cookiecutter interface, so developers can provide their
own templates.
Create a new role from a template, with molecule tests included
molecule init template
--url https://github.com/crivetimihai/ansible_cookiecutter.git
--role-name httpd
23

27. Vagrant: Test images with
vagrant

28. Test images locally with Vagrant
Run vagrant up on a Vagrantfile
Vagrant.configure("2") do |config|
config.vm.box = "centos-8-base"
config.vm.hostname = "centos8.lab.local"
config.vm.network "private_network", ip: "172.16.6.4"
config.vm.provider "virtualbox" do |vb|
vb.cpus = "2"
vb.memory = "2048"
vb.customize ["modifyvm", :id, "--vram", "256"]
end
end
24