i-Diário Ansible Playbook

Repositório de automação para instalação e configuração completa da aplicação i-Diário utilizando Ansible.

---

📦 Estrutura do Projeto

.
├── group_vars/
│   ├── all/
│   │   └── *.yml                       # Variáveis globais
│   ├── development/
│   │   └── main.yml                    # Configuração do ambiente de development
│   ├── staging/
│   │   └── main.yml                    # Configuração do ambiente de staging
│   └── production/
│       └── main.yml                    # Configuração do ambiente de production
│
├── roles/
│   ├── common/
│   ├── postgresql/
│   ├── redis-server/
│   ├── nginx/
│   └── i-diario
│
├── inventory.ini                       # Inventário dos hosts
└── playbook.yml                        # Playbook principal

---

🛠️ Preparando o Playbook

1. Edite o arquivo inventory.ini e adicione seus servidores. Exemplo:

[ieducar]
10.0.0.1 ansible_user=root
10.0.0.2 ansible_user=ubuntu ansible_become=true ansible_become_method=sudo

Para mais opções de configuração, consulte o arquivo inventory.ini.example ou os arquivos em group_vars.

---

🔐 Modo de Autenticação no Servidor de Destino

Chave SSH (recomendado)

ssh-keygen -t rsa
chmod 400 ~/.ssh/id_rsa
ansible-playbook add-key.yml -i inventory.ini --key-file ~/.ssh/id_rsa --extra-vars "key=~/.ssh/id_rsa.pub"

Senha (alternativo)

ansible-playbook playbook.yml -i inventory.ini --ask-pass

---

🚀 Executando o Playbook

Com chave SSH

ansible-playbook playbook.yml -i inventory.ini --key-file ~/.ssh/id_rsa

Com senha

ansible-playbook playbook.yml -i inventory.ini --ask-pass

Selecionando o ambiente

ansible-playbook playbook.yml -i inventory.ini -l staging

---

🛠️ Funcionalidades

• Instalação do i-Educar com base na branch ou tag desejada
• Suporte a múltiplos ambientes (development, staging, producao)
• Instalação automática de:
  • PostgreSQL otimizado para RAM disponível
  • Redis
  • NGINX com suporte a domínio e SSL (Let's Encrypt ou manual)
• Geração automática do secrets.yml e database.yml com variáveis sensíveis
• Permissões ajustadas com ACL para usuário e grupo www-data
• Geração automática de certificados SSL com Certbot (quando habilitado)
• Cópia automática de certificados fornecidos manualmente (quando configurado)
• Geração condicional de arquivos NGINX com base nas variáveis idiario_with_domain, idiario_use_ssl e idiario_use_letsencrypt

---

📋 Requisitos

• Ubuntu Server 20.04 com acesso via SSH
• Ansible 2.14+
• Permissões de root ou usuário sudo

---

🧩 Considerações sobre Domínio e SSL

Acesso via IP (sem domínio)

• idiario_with_domain: false

Acesso via domínio sem SSL

• idiario_with_domain: true
• idiario_use_ssl: false

Acesso via domínio com SSL automático (Let's Encrypt)

• idiario_with_domain: true
• idiario_use_ssl: true
• idiario_use_letsencrypt: true
• Requer que o domínio esteja apontado para o IP do servidor

Acesso via domínio com certificado próprio

• idiario_with_domain: true
• idiario_use_ssl: true
• idiario_use_letsencrypt: false
• Informar:
  • idiario_ssl_certificate_path
  • idiario_ssl_certificate_key_path
  • idiario_ssl_certificate_src
  • idiario_ssl_certificate_key_src

---

📄 Licença

Este projeto segue os princípios de software livre e está sob a licença GPL v2.0.

---

Para mais informações sobre o i-Educar: https://ieducar.org