Gitops ワークフロービルダー

このスキルは GitOps ワークフロービルダータスクの自動支援を提供します。

前提条件

このスキルを使用する前に、以下を確認してください:

• Kubernetes クラスタがアクセス可能で kubectl が設定されている
• GitOps ソース用の Git リポジトリが利用可能である
• ArgoCD または Flux がクラスタにインストール済み(またはインストール準備完了)である
• GitOps オペレータに適切な RBAC パーミッションがある
• クラスタと Git リポジトリ間のネットワーク接続がある

手順

1. GitOps ツールの選択: 要件に基づいて ArgoCD または Flux を使用するかを決定します
2. アプリケーション構造の定義: 環境分離(dev/staging/prod)を含むリポジトリレイアウトを確立します
3. マニフェストの生成: Git ソースを指すアプリケーション/Kustomization ファイルを作成します
4. 同期ポリシーの設定: 自己修復およびプルーン オプション付きの自動または手動同期を設定します
5. RBAC の実装: GitOps オペレータ用のサービスアカウントおよびロールバインディングを定義します
6. 監視のセットアップ: デプロイメント用の通知とヘルスチェックを設定します
7. 設定の検証: 同期動作をテストし、リコンシリエーションループを検証します

出力

以下を含む GitOps ワークフロー設定を生成します:

ArgoCD アプリケーションマニフェスト:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: app-name
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/org/repo
    path: manifests/prod
    targetRevision: main
  destination:
    server: https://kubernetes.default.svc
    namespace: production
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

Flux Kustomization:

apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: app-name
  namespace: flux-system
spec:
  interval: 5m
  path: ./manifests/prod
  prune: true
  sourceRef:
    kind: GitRepository
    name: app-repo

エラーハンドリング

一般的な問題と解決方法:

同期の失敗

• エラー: "ComparisonError: Failed to load target state"
• 解決方法: Git リポジトリの URL、認証情報、対象パスが存在することを確認します

RBAC パーミッション

• エラー: "User cannot create resource in API group"
• 解決方法: GitOps サービスアカウントに適切なクラスタロールを付与します

同期外れ状態

• 警告: "Application is OutOfSync"
• 解決方法: 自動同期を有効にするか、UI/CLI 経由で手動同期を実行します

Git 認証

• エラー: "Authentication failed for repository"
• 解決方法: {baseDir}/.git/config で SSH キーまたはアクセストークンを設定します

リソースの競合

• エラー: "Resource already exists and is not managed by GitOps"
• 解決方法: 既存リソースをインポートするか、競合する手動デプロイメントを削除します

リソース

• ArgoCD ドキュメント: https://argo-cd.readthedocs.io/
• Flux ドキュメント: https://fluxcd.io/docs/
• GitOps の原則とパターンガイド
• Kubernetes マニフェストのベストプラクティス
• {baseDir}/gitops-examples/ 内のリポジトリ構造テンプレート

概要

このスキルは前述の機能に対する自動支援を提供します。

例

使用例のパターンはコンテキスト内で説明されます。