Ansible - exemplos para automação de TI

Este repositório contém recursos de aprendizagem relacionados ao Ansible. O Vagrant é usado para criar ambientes do controlador e dos hosts gerenciados.

Ambiente de execução

Para criar o ambiente de execução devemos:

• Instalar o Virtual Box;
• Instalar o Vagrant;
• Clonar este repostório;
• Executar o Vagrant usando o terminal dentro do repositório local:

vagrant up

• Conectar no host controlador (senha=vagrant, se for solicitada):

vagrant ssh ansible

• Entrar no diretório do projeto:

cd livro/

Importante: A máquina virtual Windows vem desabilitada por padrão devido ao seu tamanho. Para testar os hosts com sistema Windows, retire os comentários das linhas com as configurações da máquina virtual Windows no arquivo Vagrantfile, recarregue o ambiente com vagrant up.

Com o ambiente pronto, os comandos dos exemplos do livro estão reunidos, organizados por capítulo e acompanhados de uma breve explicação, em comandos.md. Consulte esse arquivo para localizar o comando correspondente a cada capítulo e execute-o no diretório do projeto.

⚠️ Avisos:

• O arquivo com a máquina virtual do Windows é muito grande e seu download e alguns comandos do Vagrant podem demorar muito dependendo da configuração de rede e do computador em que as máquinas virtuais estão sendo executadas.

• Os ambientes do Vagrant foram testados. Porém, problemas com as máquinas virtuais durante o carregamento (vagrant up) ainda podem ocorrer. A maior parte dos problemas é bem relatada nas páginas de grupos de discussão. Em último caso, a reconstrução das máquinas virtuais pode solucionar a maior parte dos problemas:

vagrant halt
vagrant destroy
vagrant up

• Para executar o caso de uso relacionado ao gerenciamento de contêineres na nuvem, é necessário ter uma conta no provedor AWS.

Fatos relacionados aos hosts

A tabela a seguir apresenta um conjunto de fatos coletados pelo Ansible dos hosts do inventário hosts.ini. Os atributos system, os_family e distribution, armazenados na estrutura ansible_facts, descrevem o sistema operacional de cada host.

hostname	system	os_family	distribution
cloud	Linux	Debian	Ubuntu
db	Linux	Debian	Debian
lab[01:03]	Linux	Debian	Ubuntu
nas	Linux	Debian	Debian
off1	Win32NT	Windows	--
simula	Linux	Debian	Ubuntu
ti1	Linux	Debian	Ubuntu
w3	Linux	RedHat	Almalinux
web	Linux	Debian	Debian

Roles provenientes do Ansible Galaxy

Os roles provenientes do Ansible Galaxy citados no livro são listados a seguir:

• ajholanda.googlechrome [Github]
• ajholanda.vscode [Github]
• ajholanda.x2goclient [Github]

Informações complementares

As informações complementares ampliam o conteúdo apresentado no livro, mas não foram incluídas diretamente em seu texto, por serem facilmente encontradas por meio de sistemas de busca ou apresentarem grande variabilidade conforme o sistema operacional ou a distribuição Linux utilizada.

Instalação

Os links dos guias de instalação dos programas usados no livro são listados a seguir:

• Ansible;

• ansible-lint;

• Ansible Molecule;

• Chocolatey (Windows);

• yamllint.

Autenticação

• Guia de manipulação de chaves públicas para autenticação SSH sem senha. [English]

Boas práticas

• Recomendações de boas práticas para o Ansible.[English]

🤝 Contribuição

Qualquer contribuição é bem-vinda. Basta abrir uma solicitação de correção ou enviar a correção.