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.
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:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo 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 777do 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.
2. Niezmienna generacja sekretów (sesje Rails)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»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:
openssl rand -hex 64Skopiuj wynikowy blok alfanumeryczny i zaktualizuj natychmiast zmienną SECRET_KEY_BASE w swoim pliku docker-compose.yml przed restartem stacka.
3. Uruchamianie stosu
Sección titulada «3. Puesta en Marcha del Stack»Aby skompilować, ustrukturyzować i uruchomić zależności sieci izolowanych i kontenery trwałości w trybie demona (w tle):
cd ~/redminedocker compose up -dDocker 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:
4.1. Weryfikacja aktywnych kontenerów
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose psKryterium 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:
docker compose logs -f redmineOczekiwany 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.
- Brak uprawnień właściciela w udostępnionych katalogach hosta (pominięcie polecenia
- Rozwiązanie: Zatrzymaj silnik (
docker compose down), sprawdź szczegółowe logi błędów gniazda za pomocądocker compose logsi ponownie uruchom poprawienie uprawnień za pomocąchown -R 999:999.
5.2. Błąd połączenia z bazą danych
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- Częsta przyczyna:
- Nazwa przypisana do zmiennej
REDMINE_DB_MYSQLnie zgadza się dokładnie z deklaracją nazwy usługi w pliku Compose.
- Nazwa przypisana do zmiennej
- Rozwiązanie: Otwórz plik orkiestracji i sprawdź, czy oba bloki udostępniają ujednolicony identyfikator DNS:
redmine_db.
📊 Lista kontrolna sukcesu wdrożenia
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ Prawidłowa własność plików: Wszystkie skonfigurowane katalogi montowane z UID/GID
999w celu uniknięcia wyjątków zapisu. - ✓ Niezawodne sekrety sesji: Zmienna
SECRET_KEY_BASEwygenerowana za pomocą OpenSSL i odizolowana od środowisk publicznych. - ✓ Aktywne gniazda sieciowe: Bezpieczne mapowanie na porcie
5588odpowiednio z przekierowaniem logów Rails. - ✓ Orkiestracja sprzężona: Główna usługa aplikacji zablokowana przed natychmiastowym uruchomieniem za pomocą dyrektywy
depends_ondo momentu pomyślnego zainicjowania MySQL.

