Ir al contenido

DOC-03: デプロイ、セキュリティおよび起動

ローカルアクセス権のプロビジョニング、不変なシークレットの生成、およびRedmineスタックの制御起動に関する戦術的な手順およびセキュリティベストプラクティス

0閲覧数

1. パーミッション管理 (Linuxでの重要なステップ)

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

テスト環境のその他のファイルシステムとは異なり、企業の Linux 環境ではコンテナ内にマウントされたボリュームに対し、セキュリティを担保するために所有者とパーミッションの厳密な割り当てが求められます。Redmine の内部エンジンは、隔離されたシステムユーザーとしてそのスレッドを実行しており、識別子(UID/GID)999 を使用しています。

Ubuntuホストで所有権の変更を省略すると、アプリケーションは起動しますが、添付ファイルの書き込み、カスタムスタイルシートのコンパイル、ログトレースのダンプを試行する際に即座に失敗

インフラストラクチャを初期化する前に、ホストのターミナルで作業ディレクトリからパーミッションのクリーンアップコマンドを実行してください:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo 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 にセッショントークンを暗号化して保存します。セッションハイジャックやブラウザ内での悪意ある傍受を防ぐため、このキーは高いエントロピーを持ち、完全に変更不可かつ秘匿して維持する必要があります。

今後、定期的なサイバーセキュリティ監査のためキーを再生成する必要がある場合、次のセキュアな暗号化ランダム性コマンドを実行してください:

Ventana de terminal
openssl rand -hex 64

生成された英数字ブロックをコピーし、stack を再起動する前に、ファイル docker-compose.yml 内の変数 SECRET_KEY_BASE を即座に更新してください。


隔離されたネットワーク依存関係と永続コンテナをコンパイルし、構造化し、デーモンモード (バックグラウンド) で起動するには:

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

Docker Composeは、仮想ネットワークを自動的に作成し、構成されたボリュームをマウントし、MySQLデータベースエンジンがRedmine SQL構造を初期化できるよう待機します。


4. ステータスの診断とログトレース

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

サービスの正しい起動を確保するために戦略的なデバッグコマンドを使用してください:

Ventana de terminal
docker compose ps

成功基準: 両方のコンテナ(redmine および redmine_db)が、Up または healthy 状態を表示していること。

Railsによって実行されたデータベース初期化プロセスと内部テーブル移行を分析的にモニタリングするため:

Ventana de terminal
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 で権限修正を再実行してください。
  • よくある原因:
    • 変数 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 の初期化が正常に完了するまで待機します。