ops-devops-platform

DevOps とプラットフォームエンジニアリング

クイックリファレンス

ニーズ	最初の方針
インフラストラクチャのプロビジョニング	Terraform、OpenTofu、Pulumi、またはクラウドネイティブな IaC
クラスターまたはアプリのデプロイ	安定稼働環境にはまず GitOps、ローカルでの反復作業には直接的なツールを使用
CI/CD	保護されたパイプラインにワークロード ID とサプライチェーン制御を組み合わせます — supply-chain-security を参照してください
オブザーバビリティ	OpenTelemetry と、メトリクス、ログ、トレース、SLO ベースのアラート
プラットフォームエンジニアリング	ゴールデンパス、ポリシー・アズ・コード、セルフサービスインターフェース
インシデント対応業務	ランブック、重大度モデル、エスカレーション、ポストモーテム

ワークフロー

1. 主な問題を分類します：
   • プロビジョニング
   • デプロイ
   • CI/CD
   • オブザーバビリティ
   • プラットフォームエンジニアリング
   • セキュリティ強化
   • インシデント対応業務
2. 実行環境とチームのスキルに合った、実用上最小限のツールチェーンを選びます
3. 関連するリファレンスとテンプレートのセットを読み込みます
4. ソースとリリースへのリンクを使って、対象の実行環境でサポートされる API、ツールの互換性、非推奨項目を確認します。来歴を確認するには、supply-chain-security を読み込み、選択した SLSA トラックに照らして実際のビルダーを評価します
5. 検証段階を分けます：静的な lint／plan、対象環境との照合、実行時のヘルスと代表的なサービス経路、ロールバックまたはロールフォワードの準備状況
6. 具体的な運用成果物を揃えて完了します：plan、制御策、担当者、アーティファクトまたはコミットの識別情報、環境、観測期間、未検証の障害モード

判断ルール

状況	ルール
インフラストラクチャの変更	デフォルトでは IaC を使用します。緊急の手動変更は、次の昇格前にコードへ反映します
安定稼働環境の本番環境との照合	プッシュベースのデプロイより GitOps（Argo CD / Flux）を優先します
CI の認証情報	長期間有効なシークレットよりワークロード ID（OIDC）を優先します
アラート	対応可能な SLO 消費率の急上昇や容量枯渇が差し迫っている場合にページングし、診断用のホストメトリクスはダッシュボードに送ります
新しい環境	プラットフォームテンプレート + ポリシーガードを使用します。スノーフレークは作りません
サプライチェーンの完全性	SLSA ビルドトラック + cosign による鍵なし署名
ドリフト	リコンサイラーまたは CI の terraform plan で検出します。偶然発見される状況は避けます

関連するルーティング

• サービスレベルのリトライ、期限、カオスエンジニアリング -> qa-resilience
• テレメトリの実装詳細 -> qa-observability
• バックエンドサービスの設計 -> software-backend
• システムアーキテクチャ -> software-architecture-design
• AppSec 固有の設計 -> software-security-appsec
• Git ブランチと PR のワークフローポリシー -> dev-git-workflow
• 進行中のインシデント、オンコール、ポストモーテムの対応 -> ops-incident-response
• クラウド、SaaS、AI API のコスト -> ops-cost-optimization
• NUKE を使った .NET ビルド -> ops-nuke-cicd

---

ガードレール

領域	推奨事項	避けるべきアンチパターン
プロビジョニング	IaC ですべての重要な変更を管理し、明示的な昇格ゲートを設けます	クリック操作による構成のドリフト、タグ付けされていないインフラストラクチャ
デリバリー	保護されたパイプライン、アーティファクトの来歴、ロールバックとスモークテストを整備します	ID の境界がないパイプライン
プラットフォーム	セルフサービス化の前にゴールデンパスを整備し、ばらつきを抑えるポリシー・アズ・コードを導入します	導入経路や所有者がないままツールを提供すること
オブザーバビリティ	まず SLO を定義し、共通のトレース ID でログ、トレース、メトリクスを結び付けます	生のホストメトリクスのしきい値によるアラート疲れ
インシデント	ポストモーテムの知見をランブックやプラットフォームの変更に反映します	事実の記述だけで終わるポストモーテム
コスト	リソース作成時にタグ付けと予算アラートを設定し、毎月リソースの適正化を行います	管理されていない個別環境、見直されていない予約

---

ナビゲーション

参照先のルーティング

次の場合に読み込みます…	参照先
サプライチェーン、SBOM、署名、SLSA	references/supply-chain-security.md
DORA の 5 つの指標とチームの類型（Elite／High／Medium／Low の各ティアは廃止済み）、AI 導入による不安定性のコスト、DevOps の一般的なベストプラクティス	references/devops-best-practices.md
GitLab CI — 親／子パイプライン、MR 変数の落とし穴、環境変数エクスポートのパターン	references/gitlab-ci-patterns.md
ツールの選定（IaC、GitOps、CI、ポリシー、可観測性）	references/tool-landscape.md
ゴールデンパス、内部開発者ポータル、プラットフォームの成熟度、IDP を構築すべきでない場合、プラットフォームとプロダクトの境界、チームの認知負荷の測定（Weis の 4 クラスターモデル、Teamperature、リーダーシップの負荷）、CI／IaC／GitOps の導入順序	references/platform-engineering-patterns.md
GitOps による複数環境へのプロモーション、Argo CD／Flux のパターン、自動化の遅延、および変更時の適用より継続的な適用が優れている理由	references/gitops-workflows.md
Terraform の状態の分離、環境に terraform workspace が適さない理由、stage／prod／mgmt／global の構成、状態内のシークレットとバックエンドの選定	references/terraform-state-architecture.md
スタックの規模（モノリシック → アプリケーショングループ → サービス → マイクロ）、影響範囲、「自分のスタックはモノリスか？」	references/stack-sizing-patterns.md
IaC テストの段階とそれぞれの見落とし、インフラテストのダイヤモンドとピラミッド、スイスチーズ型の多層防御	references/infrastructure-testing-strategy.md
オンコール、重大度モデル、エスカレーション、ポストモーテム	references/sre-incident-management.md
2 日目以降の運用ランブック、環境の衛生管理	references/operational-patterns.md
AIOps によるアラートの相関分析、自動トリアージ	references/aiops-patterns.md
Kalman カナリア、コストオートスケーラー、CI 容量安定化ツール	references/control-theory-applied.md
キャパシティプランニング、飽和 SLO、パイプラインのボトルネック調査	references/queueing-theory-applied.md
CI/CD スループットの回復、制約の顕在化、支出の再配分	references/theory-of-constraints-applied.md
プラットフォームチームの憲章、アルゲドニック・エスカレーション、PRR 監査	references/cybernetics-vsm-applied.md
MTBF／MTTR、可用性予算、FMEA	references/reliability-theory-applied.md
CAP／PACELC、合意形成、冪等性、クォーラム	references/distributed-systems-applied.md
ソース URL とリリーストラッカー	data/sources.json

ソース一覧を変更した場合は、このスキルディレクトリから python3 scripts/validate_sources.py --skip-network を実行し、スキーマと網羅性のみを確認してください。オフライン CLI 回帰テスト は python3 -m pytest scripts/test_validate_sources.py で実行してください。URL の到達可能性とソースの内容は別途確認が必要です。スキーマの検証に合格しても、根拠の日付は更新されません。

テンプレート

AWS / GCP / Azure

• assets/aws/template-aws-ops.md — AWS の日常運用チェックリスト
• assets/aws/template-aws-terraform.md — AWS Terraform モジュールのスケルトン
• assets/aws/template-cost-optimization.md — AWS の適正サイジングと予約の見直し
• assets/gcp/template-gcp-ops.md — GCP の日常運用チェックリスト
• assets/gcp/template-gcp-terraform.md — GCP Terraform モジュールのスケルトン
• assets/azure/template-azure-ops.md — Azure の日常運用チェックリスト

Kubernetes

• assets/kubernetes/template-kubernetes-ops.md — クラスターの日常運用、プローブとローリングアップデートのルール、HPA チェックリスト
• assets/kubernetes/template-ha-dr.md — HA と災害復旧のトポロジー
• assets/kubernetes/template-platform-api.md — セルフサービス向けプラットフォーム API 契約
• assets/kubernetes/template-k8s-deploy.yaml — 基本の Deployment マニフェスト

Docker / Kafka

• assets/docker/template-docker-ops.md — イメージのビルドとランタイムの強化
• assets/kafka/template-kafka-ops.md — Kafka クラスターの運用

Terraform / IaC

• assets/terraform-iac/template-iac-terraform.md — ルートモジュールの構成
• assets/terraform-iac/template-module.md — 再利用可能な子モジュール
• assets/terraform-iac/template-env-promotion.md — 環境昇格ワークフロー

CI/CD と GitOps

• assets/cicd-pipelines/template-ci-cd.md — 汎用 CI/CD パイプライン設計
• assets/cicd-pipelines/template-github-actions.md — OIDC を使用した GitHub Actions ワークフロー
• assets/cicd-pipelines/template-gitops.md — GitOps 昇格パイプライン
• assets/cicd-pipelines/template-release-safety.md — リリースゲートとロールバック

モニタリング / オブザーバビリティ

• assets/monitoring-observability/template-slo.md — SLO 定義シート
• assets/monitoring-observability/template-alert-rules.md — バーンレートアラートルール
• assets/monitoring-observability/template-observability-slo.md — オブザーバビリティと SLO の包括的なスタック
• assets/monitoring-observability/template-loadtest-perf.md — 負荷テストとパフォーマンスのベースライン

インシデント対応

• assets/incident-response/template-postmortem.md — 非難のないポストモーテム
• assets/incident-response/template-runbook-starter.md — ランブックのひな形
• assets/incident-response/template-incident-comm.md — ステークホルダーへのコミュニケーション
• assets/incident-response/template-incident-response.md — 包括的な IR プレイブック

セキュリティ / コスト

• assets/security/template-security-hardening.md — セキュリティ強化チェックリスト
• assets/cost-governance/template-cost-governance.md — FinOps のタグ付けと予算管理

共通ユーティリティ

• ../software-clean-code-standard/references/config-validation.md
• ../software-clean-code-standard/references/resilience-utilities.md
• ../software-clean-code-standard/references/logging-utilities.md
• ../software-clean-code-standard/references/observability-utilities.md

関連スキル

• ../qa-resilience/SKILL.md
• ../data-sql-optimization/SKILL.md
• ../qa-observability/SKILL.md
• ../qa-debugging/SKILL.md
• ../software-security-appsec/SKILL.md
• ../software-backend/SKILL.md
• ../software-architecture-design/SKILL.md
• ../dev-api-design/SKILL.md
• ../dev-git-workflow/SKILL.md
• ../ai-mlops/SKILL.md

学習ループ

過去の決定や落とし穴が関係する場合は、learnings.consolidated.md があれば参照し、必要な履歴がある場合、または利用可能な代替手段としてのみ learnings.md を使用してください。それ以外の場合は、どちらも参照しないでください。

適用後、記憶しておく価値のあるパターン、防止すべきミス、または意外だったドメイン知識に遭遇した場合は、agents-skills-feedback-loop/scripts/append_learning.py を使って、日付付きの箇条書きを learnings.md に1件追記してください。SKILL.md 自体は変更しないでください。