Ir al contenido

DOC-03: Wdrożenie, Bezpieczeństwo i Uruchomienie

Procedura taktyczna i najlepsze praktyki bezpieczeństwa dotyczące zaopatrywania w uprawnienia lokalne, nierozłącznej generacji sekretów i kontrolowanego uruchamiania stosu Redmine.

0odwiedzin

1. Zarządzanie uprawnieniami (krytyczny krok w systemie Linux)

Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»

W przeciwieństwie do innych systemów plików w środowiskach testowych, woluminy montowane w kontenerach w korporacyjnych środowiskach systemu Linux wymagają ścisłego przypisania własności i uprawnień w celu zapewnienia bezpieczeństwa. Wewnętrzny silnik Redmine uruchamia swoje wątki pod izolowanym użytkownikiem systemu z identyfikatorem (UID/GID) 999.

Jeśli pominiesz zmianę właściciela na hoście Ubuntu, aplikacja uruchomi się, ale natychmiast się awaryjnie zatrzyma podczas próby zapisu plików załączników, kompilacji arkuszy stylów niestandardowych lub zrzucania śladów logów, powodując ciche wyjątki w bazie danych.

Przed zainicjowaniem infrastruktury wykonaj polecenie czyszczenia uprawnień z katalogu roboczego w terminalu hosta:

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

[!WARNING] Bezpieczeństwo dostępu: Pod żadnym pozorem nie przypisuj globalnych uprawnień permisywnych typu chmod -R 777 do tych folderów w środowiskach korporacyjnych. To otworzyłoby wektory luki w zabezpieczeniach dla zdalnej iniekcji plików, jeśli któryś z pluginów Redmine miałby luki w zabezpieczeniach.


Redmine przechowuje tokeny sesji w sposób zaszyfrowany w ciasteczkach klienta za pomocą deklaracyjnego klucza SECRET_KEY_BASE. Aby uniknąć porwania sesji lub złośliwego przechwycenia w przeglądarce, ten klucz musi mieć wysoką entropię i być całkowicie niezmienny i utajniony.

Jeśli w przyszłości będziesz musiał ponownie wygenerować klucz ze względu na okresowy audyt cyberbezpieczeństwa, wykonaj polecenie bezpiecznej losowości kryptograficznej:

Ventana de terminal
openssl rand -hex 64

Skopiuj wynikowy blok alfanumeryczny i zaktualizuj natychmiast zmienną SECRET_KEY_BASE w swoim pliku docker-compose.yml przed restartem stacka.


Aby skompilować, ustrukturyzować i uruchomić zależności sieci izolowanych i kontenery trwałości w trybie demona (w tle):

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

Docker Compose automatycznie utworzy sieci wirtualne, zamontuje skonfigurowane wolumeny i czeka, aż silnik bazy danych MySQL będzie gotowy do zainicjowania struktury SQL Redmine.


4. Diagnostyka stanu i śledzenie dzienników

Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»

Upewnij się, że usługi zostały prawidłowo uruchomione za pomocą poleceń debugowania:

Ventana de terminal
docker compose ps

Kryterium Sukcesu: Obaj kontenerzy (redmine i redmine_db) muszą wyświetlać stan Up lub healthy.

4.2. Audyt śledzenia w czasie rzeczywistym

Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»

Aby monitorować analitycznie proces inicjacji bazy danych i wewnętrznej migracji tabel wykonanej przez Rails:

Ventana de terminal
docker compose logs -f redmine

Oczekiwany wynik: Szukaj na końcu strumienia rekordu aktywnych gniazd: Listening on 0.0.0.0:3000 (który jest mapowany zewnętrznie do bezpiecznego portu korporacyjnego 5588).


5. Rozwiązywanie typowych konfliktów (rozwiązywanie problemów)

Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»

5.1. Kontener wchodzi w pętle ponownego uruchamiania

Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»
  • Częste przyczyny:
    • Brak uprawnień właściciela w udostępnionych katalogach hosta (pominięcie polecenia chown).
    • Błędy wcięć składniowych w pliku YAML docker-compose.yml.
  • Rozwiązanie: Zatrzymaj silnik (docker compose down), sprawdź szczegółowe logi błędów gniazda za pomocą docker compose logs i ponownie uruchom poprawienie uprawnień za pomocą chown -R 999:999.
  • Częsta przyczyna:
    • Nazwa przypisana do zmiennej REDMINE_DB_MYSQL nie zgadza się dokładnie z deklaracją nazwy usługi w pliku Compose.
  • Rozwiązanie: Otwórz plik orkiestracji i sprawdź, czy oba bloki udostępniają ujednolicony identyfikator DNS: redmine_db.

  • ✓ Prawidłowa własność plików: Wszystkie skonfigurowane katalogi montowane z UID/GID 999 w celu uniknięcia wyjątków zapisu.
  • ✓ Niezawodne sekrety sesji: Zmienna SECRET_KEY_BASE wygenerowana za pomocą OpenSSL i odizolowana od środowisk publicznych.
  • ✓ Aktywne gniazda sieciowe: Bezpieczne mapowanie na porcie 5588 odpowiednio z przekierowaniem logów Rails.
  • ✓ Orkiestracja sprzężona: Główna usługa aplikacji zablokowana przed natychmiastowym uruchomieniem za pomocą dyrektywy depends_on do momentu pomyślnego zainicjowania MySQL.