GitHub Actions+Release Notes活用デプロイフロー

feat: ユーザープロフィールに自己紹介欄を追加
fix: スライド保存時のエラーハンドリングを修正
docs: デプロイメント手順を更新

# main ブランチへの push で以下が自動実行される
- name: Create CHANGELOG
  uses: requarks/changelog-action
  with:
    fromTag: 最後のリリースタグ
    toTag: 現在のバージョンタグ
    excludeTypes: ""  # すべてのコミットタイプを含める
    includeInvalidCommits: false  # マージコミットは自動除外

name: main-ci

on:
  push:
    branches: [main]
  workflow_dispatch:  # 手動実行も可能

jobs:
  main:
    # 1. Changelog 自動生成
    # 2. Draft Release 作成
    # 3. Kroki ダイアグラムサービスをデプロイ
    # 4. Preview 環境へのフルデプロイ

- name: Build and push image to DockerHub
  uses: docker/build-push-action
  with:
    tags: |
      slidict/slidict.io:preview-{{COMMIT_SHA}}
    build-args: |
      RAILS_ENV=preview
      SECRET_KEY_BASE_DUMMY=dummy-secret-key
      GITHUB_SHA={{COMMIT_SHA}}

# 1. 証明書管理（cert-manager）
- name: Apply cert-manager manifests
  run: |
    kubectl apply -f cert/secret.yml
    kubectl apply -f cert/clusterissuer.yml
    kubectl apply -f cert/certificate.yml

# 2. Redis デプロイ
- name: Deploy redis

# 3. Chrome ブラウザサービス（スクリーンショット用）
- name: Deploy chrome

# 4. Sidekiq Worker（バックグラウンドジョブ）
- name: Deploy worker

# 5. データベースマイグレーション
- name: Wait for migration to complete
  run: |
    kubectl wait --for=condition=complete \
      --timeout=120s job/$POD_PREFIX-migrate

# 6. Release Tasks 実行
# 初回デプロイ時のみ実行される一度限りのタスク

# 7. メインアプリケーションデプロイ
- name: Deploy pod and update ingress
  with:
    manifests: |
      ingress.yml
      app.yml

# 8. Auto Scaling 設定
- name: Deploy horizontal-pod-autoscaler

# lib/release_tasks/backfill_feature_flag.rb
module ReleaseTasks
  class BackfillFeatureFlag < ReleaseTasks::Base
    def run
      FeatureFlag.find_each do |flag|
        flag.update!(enabled: true)
      end
    end
  end
end

name: production-ci

on:
  release:
    types: [released]  # Draft Release が published されたら実行

permissions: write-all

jobs:
  deploy_production:
    uses: ./.github/workflows/call-deploy-ci.yml
    with:
      ENVIRONMENT: "production"
      ENVIRONMENT_URL: "https://slidict.io"
      POD_PREFIX: "slidict-io"

name: staging-ci

on:
  pull_request_target:
    branches: [main]
    types: [labeled, synchronize, reopened]

jobs:
  deploy_staging:
    if: contains(github.event.pull_request.labels.*.name, 'staging')
    # → staging ラベルがついている場合のみ実行

1️⃣  コード開発
    └─ Conventional Commits でコミット

2️⃣  main ブランチへ merge
    └─ main-ci が自動実行
    └─ Changelog automatically generated
    └─ Draft Release created
    └─ Preview 環境へデプロイ ✨

3️⃣  Staging 検証（オプション）
    └─ PR に staging ラベル追加
    └─ staging-ci が実行
    └─ staging.slidict.io で最終検証

4️⃣ GitHub Release の Published
    └─ production-ci が自動実行
    └─ production 環境へデプロイ 🚀

5️⃣  ユーザーが新機能を利用可能 🎉

# manifests/expansion.rb（自動実行）
ruby manifests/expansion.rb \
  manifests/azure-kubernetes/production/cert/secret.yml

# 展開対象
- Azure Service Principal 認証情報
- DNS 設定
- 各環境別リソース

# manifests/azure-kubernetes/production/app.yml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: slidict-io-production
spec:
  replicas: <%= ENV['PRODUCTION_REPLICAS'] %>  # 環境変数で制御

# manifests/azure-kubernetes/nagios/nagios.yaml
monitoring:
  - healthz: /healthz  # アプリ起動確認
  - sns_login: /healthz/sns_login  # SNS 認証確認
  - https: https://slidict.io（12時間間隔）

configuration:
  debug_level: 2048
  debug_verbosity: 2
  configmap: docker/nagios/nagios.cfg

manifests/azure-kubernetes/
├── grafana/
│   ├── datasources.yml （Prometheus接続）
│   ├── dashboards/
│   │   ├── app-metrics.json （アプリメトリクス）
│   │   ├── k8s-cluster.json （クラスタ状態）
│   │   └── sidekiq-jobs.json （バックグラウンドジョブ）
│   └── grafana-deployment.yaml

manifests/azure-kubernetes/kroki/
├── mermaid-deployment.yaml      # フローチャート
├── bpmn-deployment.yaml         # ビジネスプロセス
├── excalidraw-deployment.yaml   # 手書き図
├── kroki-deployment.yaml        # メインサービス
└── kroki-ingress.yaml

# 開発環境立ち上げ
docker compose up -d

# Rails サーバー起動
docker compose exec app bin/dev

# テスト実行（codex環境）
RAILS_ENV=codex bundle exec rspec

# キャッシュリセット（Propshaft の問題回避）
rm -rf public/assets/
docker compose restart app

# config/sidekiq.yml
:schedule:
  check_sns_login_health:
    cron: '0 * * * *'  # 毎時間
    class: SnSLoginHealthCheckJob

  regenerate_slide_thumbnails:
    cron: '0 3 * * *'  # 毎日 3時
    class: RegenerateSlideThumbailsJob

# Redis CLI でデータベース確認
redis-cli -n 15 KEYS "*"  # Sidekiq のキー一覧

docs/
├── feature-specs.md      # 機能仕様一覧
├── groups.md             # グループ共有機能
├── help-center-and-support.md
├── slide_deck_structure.md
├── release-tasks.md      # リリースタスク機構
├── infrastructure-manifests.md
├── slide-moderation.md
├── editor/               # エディタ仕様
└── mcp/                  # MCP サーバー仕様

# 1. コード確認・テスト
make rspec
make rubocop

# 2. コミット & push to main
git add .
git commit -m "feat: 新機能を実装"
git push origin main

# 3. GitHub Actions 自動実行
# → Draft Release が作成される

# 4. Release 確認（稼働状況・クリティカルバグなし）

# 5. GitHub Release を Published に変更
# → production-ci が自動実行

# 6. 本番環境にデプロイ完了 🎉

# 1. GitHub Actions ログを確認
# → Workflow ページで詳細ログを確認

# 2. AKS ポッド状態を確認
kubectl get pods -n default

# 3. ポッドログを確認
kubectl logs <pod-name> -n default

# 4. デバッグモードで再実行
# → Workflow の "Run" ボタンで再実行
# OR
# → デバッグログを有効にして実行

# 1. 前のイメージタグを確認
kubectl get deployment slidict-io-production \
  -o jsonpath='{.spec.template.spec.containers[0].image}'

# 2. 前のバージョンにロールアウト
kubectl rollout history deployment/slidict-io-production
kubectl rollout undo deployment/slidict-io-production

# 3. 状態確認
kubectl get pods
kubectl logs <新しいpod>

GitHub Repository Secrets:
- APP_ID: GitHub App ID
- APP_PRIVATE_KEY: GitHub App の秘密鍵
- AKS_SLIDICT_KUBECONFIG: AKS kubeconfig
- AZURE_SUBSCRIPTION_ID: Azure サブスクリプション ID
- DNS_SP: DNS 用サービスプリンシパル（JSON）
- DOCKERHUB_USERNAME: Docker Hub ユーザー名
- DOCKERHUB_TOKEN: Docker Hub トークン

# manifests/azure-kubernetes/production/horizontal-pod-autoscaler.yml
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: slidict-io-production-hpa
spec:
  scaleTargetRef:
    name: slidict-io-production
  minReplicas: 5
  maxReplicas: 30
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70
  - type: Resource
    resource:
      name: memory
      target:
        type: Utilization
        averageUtilization: 80