DOC-02: Arquitectura y Configuración (IaC)
Versão: 1.0 Contexto: Definição da infraestrutura como código.
0lecturas
Versão: 1.0\r\nContexto: Definição da infraestrutura como código.
1. Estrutura de Diretórios
Sección titulada «1. Estructura de Directorios»No servidor Ubuntu, toda a aplicação residirá em /home/<usuario>/redmine. A estrutura obrigatória é a seguinte para assegurar a persistência:
~/redmine/├── docker-compose.yml # Orquestador de servicios├── config/│ └── configuration.yml # Configuración de SMTP (Correo)├── files/ # Adjuntos subidos por usuarios (Persistente)├── mysql_data/ # Base de datos (Persistente)├── plugins/ # Plugins instalados (Agile, Checklists, etc.)└── themes/ # Temas visuales (Circle, etc.)Para criá-la rapidamente:
mkdir -p ~/redmine/{config,files,mysql_data,plugins,themes}2. Configuração de E-mail (SMTP Azure / Office 365)
Sección titulada «2. Configuración de Correo (SMTP Azure / Office 365)»Archivo: ~/redmine/config/configuration.yml
Esta configuração habilita o envio de notificações usando contas do Office 365. Utiliza-se a porta 587 com TLS.
production: email_delivery: delivery_method: :smtp smtp_settings: enable_starttls_auto: true address: "smtp.office365.com" port: 587 domain: "portelcore.local" authentication: :login # Credenciales de aplicación (Ejemplo de contraseña de aplicación) user_name: "portel_user@portelcore.local" password: "a1b2c3d4e5f6g7h8"3. Orquestração (docker-compose.yml)
Sección titulada «3. Orquestación (docker-compose.yml)»Archivo: ~/redmine/docker-compose.yml
Este archivo define los servicios, redes y volúmenes. Se ha corregido la conectividad (redmine_db) y se han asegurado las contraseñas.
services: redmine: image: redmine:latest restart: always ports: - "5588:3000" environment: # Apunta al nombre del servicio de base de datos definido abajo REDMINE_DB_MYSQL: redmine_db # Contraseña entre comillas dobles (MANDATORIO por caracteres especiales) - Ejemplo demostrativo REDMINE_DB_PASSWORD: "db_pass_demo_987654321_!" # Clave de sesión generada con OpenSSL (Persistencia de login) - Ejemplo demostrativo SECRET_KEY_BASE: "db_secret_key_base_demo_987654321_generada_para_el_laboratorio_inmutable" volumes: # Mapeo: Ruta Host Ubuntu : Ruta Contenedor (Inmutable) - ./files:/usr/src/redmine/files - ./config/configuration.yml:/usr/src/redmine/config/configuration.yml - ./themes:/usr/src/redmine/themes - ./plugins:/usr/src/redmine/plugins - redmine_gems:/usr/local/bundle depends_on: - redmine_db
redmine_db: image: mysql:5.7 restart: always environment: MYSQL_ROOT_PASSWORD: "db_pass_demo_987654321_!" MYSQL_DATABASE: redmine MYSQL_USER: redmine MYSQL_PASSWORD: "db_pass_demo_987654321_!" volumes: - ./mysql_data:/var/lib/mysql
volumes: redmine_gems:4. Critérios de Validação de Infraestrutura
Sección titulada «4. Criterios de Validación de Infraestructura»- Seguridad SMTP: Conexión TLS en el puerto 587 autenticada mediante contraseñas cifradas y no expuestas en el repositorio.
- Aislamiento Docker: Redes virtuales privadas y volúmenes persistentes correctamente configurados para base de datos y adjuntos.
- Resiliencia: Volúmenes nombrados y locales configurados en el host Ubuntu para garantizar cero pérdida de datos.

