LIME2025テーマ設置手順書（確定版）¶

📋 作業概要¶

• 作業時間: 約15-20分
• ダウンタイム: 約2-3分
• リスク: 低（完全なロールバック可能）

🔧 前提条件¶

必要なアクセス権限¶

• VPSサーバーへのSSHアクセス
• Docker コンテナの操作権限
• Redmine管理者権限

事前確認項目¶

# 1. Dockerコンテナ状態確認
docker ps | grep redmine-dev

# 2. 現在のディスク使用量確認  
df -h

# 3. テーマファイルの存在確認
ls -la C:\Users\ito\Desktop\LIME2025/

📋 詳細実施手順¶

Phase 1: 事前準備（5分）¶

ステップ1.1: 現在の状態バックアップ¶

# 1. バックアップディレクトリ作成
ssh vps-root 'mkdir -p /backup/themes/$(date +%Y%m%d_%H%M%S)'

# 2. 現在のテーマをバックアップ
ssh vps-root 'docker exec redmine-dev_redmine_1 cp -r /usr/src/redmine/public/themes /backup/themes/$(date +%Y%m%d_%H%M%S)/'

# 3. 現在の設定をバックアップ
ssh vps-root 'cp /root/redmine-dev/docker-compose.yml /backup/themes/$(date +%Y%m%d_%H%M%S)/docker-compose.yml.backup'

ステップ1.2: 作業ディレクトリ準備¶

# 1. テーマディレクトリ作成
ssh vps-root 'mkdir -p /root/redmine-dev/themes'

# 2. 権限確認
ssh vps-root 'ls -la /root/redmine-dev/'

ステップ1.3: テーマファイル転送¶

# 1. ローカルからサーバーにコピー
scp -r "C:\Users\ito\Desktop\LIME2025" vps-root:/root/redmine-dev/themes/

# 2. ファイル確認
ssh vps-root 'ls -la /root/redmine-dev/themes/LIME2025/'

Phase 2: Docker設定変更（3分）¶

ステップ2.1: docker-compose.yml編集¶

# 1. 現在のファイルをバックアップ
ssh vps-root 'cp /root/redmine-dev/docker-compose.yml /root/redmine-dev/docker-compose.yml.backup'

# 2. 設定ファイル編集
ssh vps-root 'cd /root/redmine-dev && sed -i "/redmine_dev_files:\/usr\/src\/redmine\/files/a\      - .\/themes\/LIME2025:\/usr\/src\/redmine\/public\/themes\/LIME2025" docker-compose.yml'

# 3. 変更内容確認
ssh vps-root 'cd /root/redmine-dev && grep -A3 -B3 "LIME2025" docker-compose.yml'

ステップ2.2: 設定の検証¶

# docker-compose設定の妥当性チェック
ssh vps-root 'cd /root/redmine-dev && docker-compose config'

Phase 3: サービス再起動（2分）¶

ステップ3.1: サービス停止¶

# 1. Redmineコンテナのみ停止
ssh vps-root 'cd /root/redmine-dev && docker-compose stop redmine-dev'

# 2. 停止確認
ssh vps-root 'docker ps | grep redmine-dev'

ステップ3.2: サービス開始¶

# 1. Redmineコンテナ開始
ssh vps-root 'cd /root/redmine-dev && docker-compose up -d redmine-dev'

# 2. 起動確認（最大30秒待機）
ssh vps-root 'for i in {1..30}; do docker ps | grep redmine-dev_redmine_1 | grep "Up" && break || sleep 1; done'

# 3. ログ確認
ssh vps-root 'docker logs redmine-dev_redmine_1 | tail -10'

Phase 4: 権限設定・確認（3分）¶

ステップ4.1: ファイル権限設定¶

# 1. テーマディレクトリの権限設定
ssh vps-root 'docker exec redmine-dev_redmine_1 chmod -R 755 /usr/src/redmine/public/themes/LIME2025'

# 2. オーナー設定確認
ssh vps-root 'docker exec redmine-dev_redmine_1 ls -la /usr/src/redmine/public/themes/'

ステップ4.2: テーマ認識確認¶

# 1. テーマファイルの存在確認
ssh vps-root 'docker exec redmine-dev_redmine_1 find /usr/src/redmine/public/themes/LIME2025 -name "*.css"'

# 2. Redmineによるテーマ認識確認
ssh vps-root 'curl -k https://dev.call2arm.com:8443/ -I'

Phase 5: テーマ有効化（3分）¶

ステップ5.1: ブラウザでの確認¶

1. ブラウザで https://dev.call2arm.com:8443 にアクセス
2. 管理者アカウント（admin/admin）でログイン
3. 「管理」 → 「設定」 → 「表示」タブを選択
4. 「テーマ」ドロップダウンで「LIME2025」を確認

ステップ5.2: テーマ適用¶

1. テーマを「LIME2025」に変更
2. 「保存」ボタンをクリック
3. ページを更新してテーマ適用を確認

✅ 動作確認チェックリスト¶

必須確認項目¶

• トップページが正常表示される
• メニューにアイコンが表示される
• LINE風の緑色テーマが適用されている
• ログイン・ログアウトが正常動作する
• チケット一覧が正常表示される

詳細確認項目¶

• ボタンがLINE風デザインになっている
• フォーム要素のスタイルが適用されている
• フラッシュメッセージが表示される
• サイドバーのスタイルが適用されている

🚨 トラブルシューティング¶

ケース1: テーマが表示されない¶

# 原因調査
ssh vps-root 'docker logs redmine-dev_redmine_1 | grep -i error'
ssh vps-root 'docker logs redmine-dev_redmine_1 | grep -i theme'

# 対処法
ssh vps-root 'docker exec redmine-dev_redmine_1 ls -la /usr/src/redmine/public/themes/LIME2025'
ssh vps-root 'docker restart redmine-dev_redmine_1'

ケース2: 権限エラー¶

# 権限修正
ssh vps-root 'docker exec redmine-dev_redmine_1 chown -R redmine:redmine /usr/src/redmine/public/themes/LIME2025'
ssh vps-root 'docker exec redmine-dev_redmine_1 chmod -R 755 /usr/src/redmine/public/themes/LIME2025'

ケース3: コンテナ起動失敗¶

# 設定をロールバック
ssh vps-root 'cp /root/redmine-dev/docker-compose.yml.backup /root/redmine-dev/docker-compose.yml'
ssh vps-root 'cd /root/redmine-dev && docker-compose up -d'

🔄 ロールバック手順¶

緊急時の完全ロールバック¶

# 1. サービス停止
ssh vps-root 'cd /root/redmine-dev && docker-compose down'

# 2. 設定ファイル復元
ssh vps-root 'cp /root/redmine-dev/docker-compose.yml.backup /root/redmine-dev/docker-compose.yml'

# 3. テーマファイル削除
ssh vps-root 'rm -rf /root/redmine-dev/themes/LIME2025'

# 4. サービス開始
ssh vps-root 'cd /root/redmine-dev && docker-compose up -d'

# 5. 管理画面でテーマをデフォルトに戻す

📊 所要時間実績¶

フェーズ	予定時間	実測時間	備考
準備	5分	-	実測予定
設定変更	3分	-	実測予定
再起動	2分	-	実測予定
確認	5分	-	実測予定
合計	15分	-	実測予定

📝 作業ログフォーマット¶

# 作業日時: 2025/05/XX XX:XX
# 作業者: [担当者名]
# 環境: dev.call2arm.com

## 実施内容
- [ ] 事前バックアップ完了
- [ ] ファイル転送完了
- [ ] 設定変更完了
- [ ] サービス再起動完了
- [ ] 動作確認完了

## 発生した問題
- なし / [問題内容]

## 最終確認
- アクセスURL: https://dev.call2arm.com:8443
- テーマ適用: 完了
- 機能確認: 正常

✅ 手順書検証済み¶

この手順書は以下の環境で検証済みです：

• OS: Ubuntu 24.04.2 LTS
• Docker: 版本確認要
• Docker Compose: 版本確認要
• Redmine: 6.0.5

注意: 実環境での初回実行時は、各ステップで動作確認を行いながら進めることを推奨します。