Curso de Ansible

Acompanhando curso de Ansible da Alura

Aula 1

Executar o primeiro comando Ansible:

ansible -vvvv wordpress -u vagrant --private-key .vagrant/machines/wordpress/virtualbox/private_key -i hosts -m shell -a 'echo Hello, world'

Desta forma, baseado na máquina Vagrant criada e no arquivo host, é passado um comando para a máquina dando um "Hello, world"

172.17.177.40 | SUCCESS | rc=0 >>
Hello, world

lucaspolo@nb:~/storage/cursos/alura/ansible$

Aula 2: Criação do primeiro playbook

Definiremos o nosso playbook através do arquivo que criaremos provisioning.yml.

---
- hosts: all
  tasks:
    - shell: 'echo hello > /vagrant/world.txt'

Assim, agora o comando que iremos executar para que ele leia este arquivo e trabalhe é o seguinte:

lucaspolo@nb:/storage/cursos/alura/ansible$ ansible-playbook provisioning.yml -u vagrant -i hosts --private-key .vagrant/machines/wordpress/virtualbox/private_key

PLAY [all] ************************************************************************************************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************************************************************************************
ok: [172.17.177.40]

TASK [shell] **********************************************************************************************************************************************************************************
changed: [172.17.177.40]

PLAY RECAP ************************************************************************************************************************************************************************************
172.17.177.40              : ok=2    changed=1    unreachable=0    failed=0

Assim, agora acessando a máquina com o comando vagrant ssh e verificando o diretório /vagrant podemos ver que foi criado o arquivo world.txt. Nossa receita funcionou e podemos seguir adiante com a configuração.

Alteramos o nosso playbook para que agora ele execute o comando apt como root (através do comando become):

---
- hosts: all
  tasks:
  - apt:
      name: php5
      state: latest
    become: yes

Quando executarmos novamente ele irá mostrar que está executando o comando e seu devido status:

lucaspolo@nb:/storage/cursos/alura/ansible$ ansible-playbook provisioning.yml -u vagrant -i hosts --private-key .vagrant/machines/wordpress/virtualbox/private_key

PLAY [all] ************************************************************************************************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************************************************************************************
ok: [172.17.177.40]

TASK [apt] ************************************************************************************************************************************************************************************
changed: [172.17.177.40]

PLAY RECAP ************************************************************************************************************************************************************************************
172.17.177.40              : ok=2    changed=1    unreachable=0    failed=0

Agora que conseguimos instalar o PHP, podemos prosseguir e instalar o Apache 2 e o modphp apenas incluindo eles no provisionamento. Aproveitaremos e incluiremos também nomes descritivos:

---
- hosts: all
  tasks:
  - name: 'Instala o PHP 5 na última versão'
    apt:
      name: php5
      state: latest
    become: yes
  - name: 'Instala o Apache 2'
    apt:
      name: apache2
      state: latest
    become: yes
  - name: 'Instala o modphp'
    apt:
      name: libapache2-mod-php5
      state: latest
    become: yes

Com isto, basta rodar novamente o ansible-playbook e ele irá instalar as dependências. Confira aqui se a página default do Apache aparece.

Aula 3: Boas práticas

Como podemos ver, temos código repetido dentro do nosso arquivo. Para ajudar nisso é possível iterar sobre uma lista passada para dentro do playbook para que possamos repetir o mesmo comando para diversos itens:

---
- hosts: all
  tasks:
  - name: 'Instala pacotes de dependência do sistema operacional'
    apt:
      name: "{{ item }}"
      state: latest
    become: yes
    with_items:
      - php5
      - apache2
      - libapache2-mod-php5
      - php5-gd
      - libssh2-php
      - php5-mcrypt
      - mysql-server-5.6
      - python-mysqldb
      - php5-mysql

Assim ele instalará todos os pacotes necessários para executarmos nosso trabalho.

Agora, podemos também reduzir a necessidade de passar o usuário e caminho da chave privada quando executamos ansible-playbook, para isto basta alterarmos o arquivo hosts:

[wordpress]
172.17.177.40 ansible_user=vagrant ansible_ssh_private_key="/storage/cursos/alura/ansible/.vagrant/machines/wordpress/virtualbox/private_key"

Desta forma o comando ficará bem mais enxuto:

ansible-playbook provisioning.yml -i hosts

Aula 4: Preparando o banco de dados

Para criar o banco de dados é bem simples, basta incluirmos um novo comando dentro do playbook, passando o nome do banco, o usuário e o state:

---
- hosts: all
  tasks:
  ...outras tasks
  - name: 'Cria o banco do MySQL'
    mysql_db:
      name: wordpress_db
      login_user: root
      state: present

Após rodarmos novamente o ansible-playbook podemos conferir a criação do banco de dados.

Para criarmos o usuário do banco de dados também criaremos uma nova task, desta vez usando o módulo mysql_user:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Cria o usuário do banco de dados'
    mysql_user:
      login_user: root
      name: wordpress_user
      password: 12345
      priv: 'wordpress_db.*:ALL'
      state: present

Aula 5: Instalação do servidor e deploy da aplicação

Precisamos agora baixar o Wordpress para a nossa máquina, para isto podemos usar a task get_url:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Download do arquivo de instalação do Wordpress'
    get_url:
      url: 'https://wordpress.org/latest.tar.gz'
      dest: '/tmp/wordpress.tar.gz'

Após isso é necessário descompactar a pasta dentro do seu destino, podemos usar a task unarchive:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Descompacta o arquivo do Wordpress'
    unarchive:
      src: '/tmp/wordpress.tar.gz'
      dest: '/var/www/'
      remote_src: yes
    become: yes

Para a task saber que o arquivo de origem está na máquina remota é necessário colocar o parametro remote_src como yes. Outra necessidade é executar a task como root, para isto o become yes.

Agora é necessário criar o arquivo de configuração do Wordpress, para isto vamos copiar o arquivo de exemplo que ele já possui no diretório:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Copiar o arquivo de configuração'
    copy:
      src: '/var/www/wordpress/wp-config-sample.php'
      dest: '/var/www/wordpress/wp-config.php'
      remote_src: yes
    become: yes

Após copia-lo, vamos alterar suas configurações, o arquivo possui palavras chaves que devem ser substituidas, podemos usar a task replace para realizar esta tarefa. Como iremos tratar três pontos diferentes, vamos novamente utilizar uma lista de parâmetros, só que desta vez composta:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Alterar configurações do Wordpress'
    replace:
      path: '/var/www/wordpress/wp-config.php'
      regexp: "{{ item.regex }}"
      replace: "{{ item.value }}"
    with_items:
      - { regex: 'database_name_here', value: 'wordpress_db' }
      - { regex: 'username_here', value: 'wordpress_user' }
      - { regex: 'password_here', value: '12345' }
    become: yes

Agora que temos o banco de dados e o Wordpress configurados, podemos então configurar o Apache para iniciar a partir do diretório do Wordpress, para isto basta copiarmos um arquivo de configuração:

- hosts: all
  tasks:
  ...outras tasks
  - name: 'Copiar o arquivo 000-default.conf para o diretório do Apache'
    copy:
      src: 'files/000-default.conf'
      dest: '/etc/apache2/sites-available/000-default.conf'
    become: yes

Após a criação desta nova task é necessário reiniciarmos o Apache para que ele considere a nova configuração, para isto a melhor prática é associarmos um handler a esta nossa task de cópia do arquivo de configuração. Primeiro criaremos o nosso handler, antes da sequência das tasks (no inicio do arquivo playbook). Muito similar a uma task, usaremos a service que ajuda a controlar os serviços que estão executando:

- hosts: all
  handlers:
  - name: restart apache
    service:
      name: apache2
      state: restarted
    become: yes

Agora alteramos nossa task de cópia do arquivo de configuração para chamarmos nosso handler quando ela executar:

- hosts: all
  ...handlers
  tasks:
  ...outras tasks
  - name: 'Copiar o arquivo 000-default.conf para o diretório do Apache'
    copy:
      src: 'files/000-default.conf'
      dest: '/etc/apache2/sites-available/000-default.conf'
    become: yes
    notify:
      - restart apache

Agora ao executarmos o playbook e entrarmos no servidor, já entraremos no Wordpress, onde podemos configura-lo normalmente.

Aula 6: Separando banco e aplicação

Para separarmos a aplicação do banco de dados é necessário definirmos em hosts qual é o novo servidor (de BD):

[wordpress]
172.17.177.40 ansible_user=vagrant ansible_ssh_private_key_file="/storage/cursos/alura/ansible/.vagrant/machines/wordpress/virtualbox/private_key"

[database]
172.17.177.42 ansible_user=vagrant ansible_ssh_private_key_file="/storage/cursos/alura/ansible/.vagrant/machines/mysql/virtualbox/private_key"

Depois disso precisamos separar no playbook qual é a configuração de cada servidor, além é claro de alterar a configuração do host de banco de dados do Wordpress e a configuração de acesso do MySQL (que por padrão só permite localhost):

---
- hosts: database
  handlers:
    - name: restart mysql
      service:
        name: mysql
        state: restarted
      become: yes

  tasks:
  - name: 'Instala pacotes de dependência do sistema operacional'
    apt:
      name: "{{ item }}"
      state: latest
    become: yes
    with_items:
      - mysql-server-5.6
      - python-mysqldb
  ...outras tasks

- hosts: wordpress
  handlers:
  - name: restart apache
    service:
      name: apache2
      state: restarted
    become: yes
  tasks:
  - name: 'Instala pacotes de dependência do sistema operacional'
    apt:
      name: "{{ item }}"
      state: latest
    become: yes
    with_items:
      - php5
      - apache2
      - libapache2-mod-php5
      - php5-gd
      - libssh2-php
      - php5-mcrypt
      - php5-mysql
  ... outras tasks
  - name: 'Copiar o arquivo 000-default.conf para o diretório do Apache'
    copy:
      src: 'files/000-default.conf'
      dest: '/etc/apache2/sites-available/000-default.conf'
    become: yes
    notify:
      - restart apache

Aula 7: Trabalhando com variáveis e templates

Como podemos ver no nosso código atual, repetimos muitas vezes os mesmos nomes, para facilitar isto dentro do nosso playbook é possível utilizar variáveis, permitindo assim elimitar repetições de constantes. Para isto é necessário criarmos um arquivo yml dentro de um diretório chamado group_var. Este arquivo irá contar nossas variáveis:

---
wp_db_name: wordpress_db
wp_db_user: wordpress_user
wp_db_pass: 12345
wp_installation_dir: '/var/www/wordpress'
wp_host_ip: '172.17.177.40'
wp_db_ip: '172.17.177.42'

Depois de criado o nosso arquivo de variáveis podemos utiliza-las dentro do nosso playbook, para isto basta invoca-las através do seu nome colocando-as dentro de chaves duplas, ficando {{ variavel }}, como nos exemplos abaixo:

---
- hosts: database
  ...
  tasks:
  - name: 'Instala pacotes de dependência do sistema operacional'
    apt:
      name: "{{ item }}"
      state: latest
    become: yes
    with_items:
      - mysql-server-5.6
      - python-mysqldb
  - name: 'Cria o banco do MySQL'
    mysql_db:
      name: "{{ wp_db_name }}"
      login_user: root
      state: present

Ao executar as variáveis serão substituidas pelos seus respectivos valores.

A utilização de variáveis facilitou a configuração, porém dentro do arquivo 000-default.conf ainda temos o apontamento para um diretório de forma estáttica. Podemos ajustar isso utilizando templates, onde colocaremos dentro do arquivo a variável utilizada e utilizaremos uma task tempĺate para substituir o arquivo.

Primeiro colocamos a variável em nosso arquivo:

        # match this virtual host. For the default virtual host (this file) this
        # value is not decisive as it is used as a last resort host regardless.
        # However, you must set it for any further virtual host explicitly.
        #ServerName www.example.com  

        ServerAdmin webmaster@localhost
        DocumentRoot {{ wp_installation_dir }}

        # Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
        # error, crit, alert, emerg.
        # It is also possible to configure the loglevel for particular
        # modules, e.g.
        #LogLevel info ssl:warn

Salvamos este arquivo em diretório templates, depois criamos a nossa task no lugar da anterior, onde copiávamos o arquivo:

  - name: 'Configura Apache para servir Wordpress'
    template:
      src: 'templates/000-default.conf.j2'
      dest: '/etc/apache2/sites-available/000-default.conf'
    become: yes
    notify:
      - restart apache

Assim ele irá copiar o arquivo aplicando a variável necessária.

Aula 8: Usando roles, dependências e defaults

Podemos separa mais eficientemente nossas regras com a utilização de roles, onde cada role realiza um conjunto de tarefas específicos. As roles seguem uma composição através de diretório similar a do arquivo de provisionamento, onde o diretório principal é o nome da role, possuindo dentro o diretório tasks e handlers, cada um com seu respectivo main.yml, seus arquivo de template e outros.

Desta forma, podemos estruturar nosso projeto da seguinte forma:

roles
├── mysql
│   ├── files
│   │   └── my.cnf
│   ├── handlers
│   │   └── main.yml
│   └── tasks
│       └── main.yml
├── webserver
│   ├── handlers
│   │   └── main.yml
│   └── tasks
│       └── main.yml
└── wordpress
    ├── handlers
    │   └── main.yml
    ├── tasks
    │   └── main.yml
    └── templates
        └── 000-default.conf.j2

As roles recebem apenas seu código principal, por exemplo as tasks em webserver, como você já está no diretório tasks, não é necessário informar no arquivo:

---
- name: 'Instala pacotes de dependência do sistema operacional'
  apt:
    name: "{{ item }}"
    state: latest
  become: yes
  with_items:
    - php5
    - apache2
    - libapache2-mod-php5
    - php5-gd
    - libssh2-php
    - php5-mcrypt
    - php5-mysql

Desta forma o arquivo playbook principal fica bem mais enxuto:

---
- hosts: database
  roles:
    - mysql
- hosts: wordpress
  roles:
    - webserver
    - wordpress

É importante perceber que as nossas roles dependem de variáveis que são passadas através do group_vars, mas caso o usuário não defina elas podemos definir valores padrões criando um diretório chamado defaults. Dentro dele teremos nossa definição de variável com seu valor padrão, caso o usuário não passe nenhum valor, este será assumido:

---
wp_host_ip:
  - localhost
  - '127.0.0.1'

Além disso também podemos definir dependências entre roles, para isto é importante que possamos declarar estas depêndencias (por exemplo, como wordpress depende de webserver), para isto criamos apenas um diretório meta na role e declaramos a dependência no main.yml:

---
dependencies:
  - webserver