DOC-03: デプロイ、セキュリティおよび起動
ローカルアクセス権のプロビジョニング、不変なシークレットの生成、およびRedmineスタックの制御起動に関する戦術的な手順およびセキュリティベストプラクティス
1. パーミッション管理 (Linuxでの重要なステップ)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»テスト環境のその他のファイルシステムとは異なり、企業の Linux 環境ではコンテナ内にマウントされたボリュームに対し、セキュリティを担保するために所有者とパーミッションの厳密な割り当てが求められます。Redmine の内部エンジンは、隔離されたシステムユーザーとしてそのスレッドを実行しており、識別子(UID/GID)999 を使用しています。
Ubuntuホストで所有権の変更を省略すると、アプリケーションは起動しますが、添付ファイルの書き込み、カスタムスタイルシートのコンパイル、ログトレースのダンプを試行する際に即座に失敗
インフラストラクチャを初期化する前に、ホストのターミナルで作業ディレクトリからパーミッションのクリーンアップコマンドを実行してください:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] アクセス制御のセキュリティ: 企業環境では、これらのフォルダに対して
chmod -R 777のような過度に寛容なグローバル権限を付与しないでください。Redmine のプラグインに脆弱性があった場合、リモートファイルインジェクションなどの重大な脆弱性ベクトルを招く恐れがあります。
2. 不変のシークレット生成 (Railsセッション)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine は、宣言型キー SECRET_KEY_BASE を使用して、クライアントの Cookie にセッショントークンを暗号化して保存します。セッションハイジャックやブラウザ内での悪意ある傍受を防ぐため、このキーは高いエントロピーを持ち、完全に変更不可かつ秘匿して維持する必要があります。
今後、定期的なサイバーセキュリティ監査のためキーを再生成する必要がある場合、次のセキュアな暗号化ランダム性コマンドを実行してください:
openssl rand -hex 64生成された英数字ブロックをコピーし、stack を再起動する前に、ファイル docker-compose.yml 内の変数 SECRET_KEY_BASE を即座に更新してください。
3. スタックのデプロイ
Sección titulada «3. Puesta en Marcha del Stack»隔離されたネットワーク依存関係と永続コンテナをコンパイルし、構造化し、デーモンモード (バックグラウンド) で起動するには:
cd ~/redminedocker compose up -dDocker Composeは、仮想ネットワークを自動的に作成し、構成されたボリュームをマウントし、MySQLデータベースエンジンがRedmine SQL構造を初期化できるよう待機します。
4. ステータスの診断とログトレース
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»サービスの正しい起動を確保するために戦略的なデバッグコマンドを使用してください:
4.1. アクティブコンテナの検証
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose ps成功基準: 両方のコンテナ(redmine および redmine_db)が、Up または healthy 状態を表示していること。
4.2. リアルタイムトレース監査
Sección titulada «4.2. Auditoría de Trazas en Tiempo Real»Railsによって実行されたデータベース初期化プロセスと内部テーブル移行を分析的にモニタリングするため:
docker compose logs -f redmine期待される出力: ログの最後でアクティブなソケットの記録を確認してください:
Listening on 0.0.0.0:3000(これは企業の安全なポート 5588 に外部マッピングされています)。
5. 一般的な衝突解決 (トラブルシューティング)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. コンテナが再起動ループに入ります
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- よくある原因:
- ホストの共有ディレクトリに対する所有者の権限が不足しています(
chownコマンドの実行漏れ)。 docker-compose.ymlの YAML ファイルに構文上のインデントエラーがあります。
- ホストの共有ディレクトリに対する所有者の権限が不足しています(
- 解決策: エンジンを停止(
docker compose down)し、docker compose logsを使用してソケットの詳細なエラーログを確認し、chown -R 999:999で権限修正を再実行してください。
5.2. データベース接続エラー
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- よくある原因:
- 変数
REDMINE_DB_MYSQLに設定された名前が、Compose ファイル内のサービス名宣言と完全に一致していません。
- 変数
- 解決策: オーケストレーションファイルを開き、両方のブロックが統一された DNS 識別子
redmine_dbを共有していることを確認してください。
📊 デプロイ成功チェックリスト
Sección titulada «📊 Checklist de Éxito en el Despliegue»- ✓ ファイル所有権の正確な設定: 書き込み例外を回避するため、すべてのマウントディレクトリを UID/GID
999で設定済み。 - ✓ 強固なセッションシークレット: 変数
SECRET_KEY_BASEは OpenSSL で生成し、公開環境から分離されています。 - ✓ ネットワークアクティブソケット: Rails のログリダイレクトとともにポート
5588で安全にマッピングされ、正常に応答しています。 - ✓ 結合されたオーケストレーション:
depends_onディレクティブにより、メインアプリケーションサービスの即時起動を制御し、MySQL の初期化が正常に完了するまで待機します。

