DOC-02: Architecture and Configuration (IaC)
Version: 1.0 Context: Definition of infrastructure as code.
0views
Version: 1.0 Context: Infrastructure as Code definition.
1. Directory Structure
Sección titulada «1. Estructura de Directorios»On the Ubuntu server, the entire application will reside in /home/<usuario>/redmine. The mandatory structure is as follows to ensure persistence:
~/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.)To create it quickly:
mkdir -p ~/redmine/{config,files,mysql_data,plugins,themes}2. Email Configuration (SMTP Azure / Office 365)
Sección titulada «2. Configuración de Correo (SMTP Azure / Office 365)»File: ~/redmine/config/configuration.yml
This configuration enables sending notifications using Office 365 accounts. Port 587 with TLS is used.
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. Orchestration (docker-compose.yml)
Sección titulada «3. Orquestación (docker-compose.yml)»File: ~/redmine/docker-compose.yml
This file defines services, networks, and volumes. Connectivity (redmine_db) has been corrected and passwords have been secured.
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. Infrastructure Validation Criteria
Sección titulada «4. Criterios de Validación de Infraestructura»- ✓ SMTP Security: TLS connection on port 587 authenticated via encrypted passwords that are not exposed in the repository.
- ✓ Docker Isolation: Private virtual networks and persistent volumes correctly configured for database and attachments.
- ✓ Resilience: Named and local volumes configured on the Ubuntu host to guarantee zero data loss.

