Ir al contenido

DOC-03: Implementatie, beveiliging en inbedrijfstelling

Tactisch procedure en security best practices voor de provisioning van lokale permissies, de onveranderlijke generatie van secrets en een gecontroleerde opstart van de Redmine-stack.

0lecturas

In tegenstelling tot andere bestandssystemen in testomgevingen, vereisen volumes die binnen containers in bedrijfsomgevingen met Linux een strikte toewijzing van eigendom en permissies om de veiligheid te garanderen. De interne engine van Redmine voert zijn threads uit onder een geïsoleerde systeemgebruiker met de identificator (UID/GID) 999.

Als we de eigendomswijziging op de Ubuntu-host weglaten, zal de applicatie weliswaar opstarten, maar onmiddellijk falen bij het proberen te schrijven van bijlagen, het compileren van aangepaste stylesheets of het dumpen van logtraces, wat leidt tot stille uitzonderingen in de database.

Voordat u de infrastructuur initialiseert, voert u de opdracht voor het opschonen van rechten uit vanuit de werkmap in de hostterminal:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo chown -R 999:999 files themes plugins mysql_data config

[!WARNING] Toegangsbeveiliging: Onder geen enkel voorbehoud mag je globale, permissieve machtigingen van het type chmod -R 777 op deze mappen in zakelijke omgevingen toewijzen. Dit zou ernstige kwetsbaarheden voor externe injectie van bestanden openen als een Redmine-plug-in beveiligingslekken zou bevatten.


2. Onveranderlijke generatie van geheimen (Rails-sessies)

Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»

Redmine slaat sessietokens versleuteld op in de client-cookies met behulp van de declaratieve sleutel SECRET_KEY_BASE. Om sessiekaping of kwaadaardige interceptie in de browser te voorkomen, moet deze sleutel een hoge entropie hebben en volledig onveranderlijk en geheim blijven.

Als u in de toekomst de sleutel opnieuw moet genereren vanwege een periodieke cyberbeveiligingsaudit, voert u de veilige cryptografische willekeurigheidsopdracht uit:

Ventana de terminal
openssl rand -hex 64

Kopieer het resulterende alfanumerieke blok en update onmiddellijk de variabele SECRET_KEY_BASE in uw bestand docker-compose.yml voordat de stack opnieuw wordt opgestart.


Om de geïsoleerde netwerkafhankelijkheden en persistentiecontainers in daemon-modus (achtergrond) te compileren, structureren en op te starten:

Ventana de terminal
cd ~/redmine
docker compose up -d

Docker Compose zal automatisch de virtuele netwerken aanmaken, de geconfigureerde volumes mounten en wachten tot de MySQL-database-engine klaar is om de SQL-structuur van Redmine te initialiseren.


Zorg voor een correcte opstart van de services met behulp van de tactische foutopsporingsopdrachten:

Ventana de terminal
docker compose ps

Succescriterium: Beide containers (redmine en redmine_db) moeten de status Up of healthy weergeven.

Om het initialisatieproces van de database en de interne tabelmigratie uitgevoerd door Rails analytisch te monitoren:

Ventana de terminal
docker compose logs -f redmine

Verwacht resultaat: Zoek aan het einde van de stroom het actieve socketlog: Listening on 0.0.0.0:3000 (dat extern is toegewezen aan de veilige bedrijfs poort 5588).


5. Oplossen van veelvoorkomende conflicten (Troubleshooting)

Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»
  • Veel voorkomende oorzaken:
    • Ontbrekende eigendomsrechten in de gedeelde hostdirectories (het weglaten van het commando chown ).
    • Syntactische inspringingsfouten in het YAML-bestand van docker-compose.yml.
  • Oplossing: Stop de engine (docker compose down), controleer de gedetailleerde socket-foutlogs via docker compose logs en voer de rechtencorrectie opnieuw uit met chown -R 999:999.
  • Veel voorkomende oorzaak:
    • De naam die is toegewezen aan de variabele REDMINE_DB_MYSQL komt niet exact overeen met de definitie van de servicenaam in het Compose-bestand.
  • Oplossing: Open het orchestratiebestand en controleer of beide blokken dezelfde geünificeerde DNS-identifier delen: redmine_db.

📊 Checklist voor succesvolle deployment

Sección titulada «📊 Checklist de Éxito en el Despliegue»
  • ✓ Correcte bestandseigenschappen: Alle gemounte directories zijn geconfigureerd met UID/GID 999 om fouten bij het schrijven te voorkomen.
  • ✓ Robuuste sessie-geheimen: Variabele SECRET_KEY_BASE gegenereerd met OpenSSL en geïsoleerd van publieke omgevingen.
  • ✓ Actieve netwerk-sockets: Veilige mapping op poort 5588 die correct reageert met Rails-logredirectie.
  • ✓ Gekoppelde orchestratie: De primaire applicatieservice wordt vertraagd bij het onmiddellijk opstarten via de richtlijn depends_on totdat de MySQL-initialisatie succesvol is voltooid.