Laboratório: Provisionamento automatizado de um servidor clínico Linux com Ansible

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

12

Validações

4

Versões da documentação consultada

Ansible a versão estável atual · OpenSSH a versão estável atual

Topologia

Duas máquinas virtuais em rede privada: uma controladora (Ansible) e uma alvo (servidor clínico). O controlador acessa o alvo via SSH (porta 22). Exemplo: controlador em 192.168.56.10, alvo em 192.168.56.20.

           +-------------------+
           |  VM1: Controlador|
           |  (Ansible)       |
           |  192.168.56.10   |
           +--------+---------+
                    |
           (rede privada)
                    |
           +--------+---------+
           |  VM2: Alvo       |
           |  (Servidor Linux)|
           |  192.168.56.20   |
           +------------------+

Equipamentos e software

Roteiro

1. Preparar as máquinas virtuais

   Crie duas VMs Ubuntu Server 22.04 LTS, conectadas à mesma rede privada. Uma será o controlador (Ansible), outra o alvo (servidor clínico).

   O que você deve ver: Ambas as VMs ligadas, com IPs privados acessíveis entre si.

2. Atualizar os sistemas operacionais

   Mantenha ambos os sistemas atualizados para evitar falhas por pacotes antigos.

   sudo apt update && sudo apt upgrade -yCopiar

   O que você deve ver: Nenhum pacote pendente de atualização.

3. Instalar o OpenSSH no alvo

   O Ansible usa SSH para se conectar. Instale e inicie o serviço no servidor alvo.

   sudo apt install openssh-server -y
   sudo systemctl enable --now sshCopiar

   O que você deve ver: Serviço SSH ativo e escutando na porta 22.

4. Instalar o Ansible no controlador

   O controlador precisa do Ansible instalado para orquestrar as automações.

   sudo apt install ansible -yCopiar

   O que você deve ver: Comando 'ansible --version' retorna informações da versão.

5. Configurar autenticação SSH sem senha

   Para automação, o controlador deve acessar o alvo via chave SSH, sem senha.

   ssh-keygen -t ed25519 -C "ansible-lab"
   ssh-copy-id usuario@192.168.56.20Copiar

   O que você deve ver: Acesso SSH do controlador ao alvo sem pedir senha.

6. Testar conectividade SSH

   Confirme que o controlador acessa o alvo via SSH.

   ssh usuario@192.168.56.20 'hostname'Copiar

   O que você deve ver: Nome do host do alvo exibido no terminal.

7. Criar inventário Ansible

   O inventário define quais hosts o Ansible vai gerenciar.

   echo '[clinica]
   192.168.56.20 ansible_user=usuario' > ~/inventarioCopiar

   O que você deve ver: Arquivo inventario criado com IP do alvo e usuário.

8. Criar playbook básico de provisionamento

   Um playbook YAML descreve as tarefas de configuração do servidor clínico.

   nano ~/provisiona_clinica.ymlCopiar

   O que você deve ver: Arquivo salvo com conteúdo YAML válido.

9. Exemplo de playbook de provisionamento

   Inclua tarefas como atualização, instalação de pacotes clínicos e hardening.

   Conteúdo do arquivo:
   
   ---
   - hosts: clinica
     become: yes
     tasks:
       - name: Atualizar pacotes
         apt:
           update_cache: yes
           upgrade: dist
       - name: Instalar pacote de prontuário eletrônico (exemplo: GNU Health)
         apt:
           name: gnuhealth
           state: present
       - name: Garantir firewall ativo
         ufw:
           state: enabled
           policy: deny
       - name: Permitir SSH
         ufw:
           rule: allow
           port: 22
           proto: tcpCopiar

   O que você deve ver: Playbook YAML salvo corretamente. Consulte yaml.org/spec para sintaxe.

10. Executar o playbook

    Rode o playbook para provisionar e configurar o servidor clínico.

    ansible-playbook -i ~/inventario ~/provisiona_clinica.ymlCopiar

    O que você deve ver: Saída com status de cada tarefa (ok, changed, failed).

11. Verificar logs e estado do servidor

    Confira se as mudanças foram aplicadas no alvo.

    ssh usuario@192.168.56.20 'dpkg -l | grep gnuhealth && sudo ufw status'Copiar

    O que você deve ver: Pacote gnuhealth instalado e firewall ativo, SSH permitido.

12. Reaplicar o playbook (idempotência)

    Execute novamente para garantir que tarefas não sejam repetidas desnecessariamente.

    ansible-playbook -i ~/inventario ~/provisiona_clinica.ymlCopiar

    O que você deve ver: Tarefas reportadas como 'ok', sem mudanças desnecessárias.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Use chaves SSH fortes e exclusivas para automação
• Restrinja o acesso SSH apenas ao controlador
• Ative e configure o firewall (UFW) no alvo
• Revise permissões sudo do usuário remoto
• Remova serviços desnecessários do servidor clínico

Checklist final

• Duas VMs Ubuntu Server 22.04 LTS acessíveis entre si
• OpenSSH ativo no alvo
• Ansible instalado no controlador
• Acesso SSH sem senha do controlador para o alvo
• Inventário e playbook criados
• Playbook executado com sucesso e idempotência validada