Contents
GitOpsとArgoCDの基本概念
Kubernetes環境における運用課題に対応するため、GitOpsはコードで定義された状態をクラスターに自動反映させる手法として注目されています。GitOpsは、インフラやアプリケーションの定義をGitリポジトリに保存し、変更が検出されると即座にクラスターへ同期する仕組みです。この原則に基づく実装ツールの一つであるArgoCDは、Kubernetes運用の自動化と透明性向上に貢献します。
GitOpsにおけるデプロイフローの特徴
GitOpsでは、アプリケーションの定義がGitリポジトリに保存され、変更が検出されると自動的にクラスターへ反映されます。このフローは「コードファースト」の原則に基づいており、以下のような利点があります。
- 一貫性: デプロイとインフラ設定を同じ場所で管理可能
- レポジトリが唯一の真実（Single Source of Truth）: 操作履歴やバージョン管理が明確
- 自動修正機能: 定義された状態と現状の不一致を検知し、即座に修復
GitOpsは、手動操作によるミスを防ぎ、リポジトリのコミット履歴からデプロイ履歴が一元管理可能な点で特徴的です。
ArgoCDアーキテクチャの理解
ArgoCDはGitリポジトリとクラスター間の同期を実現する仕組みとして構成されています。Kubernetes運用において手動操作や配置ミスによるリスクを減らすため、以下のようなコアコンポーネントが動作します。
コアコンポーネントの役割
ArgoCDには以下の主要なコンポーネントがあり、それぞれが異なる機能を担っています。
| コンポーネント | 概要 |
|---|---|
| Repo Server | Gitリポジトリからアプリケーション定義（YAML）を取得し、バージョン管理を行う |
| Application Controller | 定義された状態とクラスターの現状を比較し、必要に応じて自動同期を実施 |
| Server（Web UI） | ユーザーがアプリケーションの状態や履歴を視覚的に確認できるインターフェース |
ArgoCDは、Gitリポジトリとクラスター間の差分を検出し、自動同期を行うことで、運用負荷を軽減します。
クラスターとの通信フロー
ArgoCDでは以下のような流れでクラスターと連携します。
- GitリポジトリからYAMLファイルを取得（Repo Server）
- 定義された状態とクラスターの現状を比較（Application Controller）
- 不一致が見つかった場合、自動でクラスターに変更を反映
このフローにより、手動操作が不要な自動化されたデプロイ環境が構築できます。
GitOpsワークフロー設計
GitOpsではリポジトリの変更に基づいて自動的にクラスターが更新されます。この仕組みは、アプリケーションのライフサイクルをコードで制御し、運用の透明性と再現性を確保します。
バージョン管理されたアプリケーション定義
GitリポジトリにアプリケーションのYAML定義を保存することで、以下のようなメリットがあります。
- バージョン履歴: どのタイミングで何を変えたのか明確に追跡可能
- ロールバック対応: ミスが発覚した場合、過去のコミットに簡単に戻せる
- レビュー体制の強化: コミットメッセージやプルリクエストによるコードレビューアプローチが可能
自動同期メカニズムのしくみ
ArgoCDは、以下のような自動同期プロセスを実行します。
- Gitリポジトリに変更があると、Repo Serverが検出
- Application Controllerが現状クラスターとの差分を分析
- sync policy（同期ポリシー）に基づき、不一致があれば自動で修復
同期ポリシーは、自動修復の頻度や条件を設定できるため、運用リスクを最小限に抑えることができます。
YAML定義ファイルの作成ガイド
アプリケーションのデプロイには、YAMLファイルが不可欠です。以下に、ArgoCDで使用するargocd-application.yamlの構造と注意点を解説します。
アプリケーション定義ファイルの構造
ArgoCDでは、argocd-application.yamlという設定ファイルで以下の情報を記述します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
apiVersion: argoproj.io/v1alpha1 kind: Application metadata: name: my-app spec: project: default source: repoURL: https://github.com/username/my-repo.git targetRevision: HEAD path: k8s-manifests destination: server: https://kubernetes.default.svc namespace: default |
- repoURL: GitリポジトリのURL
- path: リソース定義が保存されているフォルダ（例:
k8s-manifests） - server/namespace: 対象のクラスターと名前空間を指定
記述ミスに注意。例: namespaceはnamesapceではなくnamespaceであることを確認してください。
リソーステンプレートのベストプラクティス
YAMLファイルは、以下のように効率的に作成することが推奨されます。
- Kustomize: 独自のパッチや変数置換が可能で、環境ごとの設定分離に適しています
- Helm: チャート形式でリソースを管理し、複雑なデプロイにも対応
インフラ定義の再利用性を高めるため、テンプレート化が不可欠です。
CI/CDツールとの連携設定
GitOpsワークフローを実現するには、CI/CDと連携させることで変更を自動的に反映します。GitHub Actionsを例に、プッシュイベントに基づく自動デプロイを解説します。
GitHub Actionsでのプッシュイベントフロー
以下のようなワークフローを作成することで、プッシュイベントをトリガーにした自動デプロイが可能になります。
- リポジトリに変更（
git push）が発生 - GitHub Actionsで変更を検知し、ArgoCDにリポジトリの更新を通知
- ArgoCDが差分を検出し、クラスターへ自動同期
.github/workflows/deploy.ymlの例:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
name: Deploy to Kubernetes via ArgoCD on: push: branches: - main jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Sync with ArgoCD run: | curl -X POST https://argo-cd.example.com/api/v1/applications/my-app/sync |
注意:
curlコマンドによるAPI呼び出しは非推奨です。Gitリポジトリへのプッシュをトリガーに、ArgoCDが自動同期する仕組みを使用するのがベストプラクティスです。
セキュリティ認証のベストプラクティス
ArgoCDとの通信には、以下のような方法が推奨されます。
- Personal Access Token（PAT）: GitHub Actionsで使用し、セキュリティを確保
- TLS証明書利用: ArgoCDのAPI通信を暗号化
- 最小権限主義: 各CIワークフローに必要なアクセスレベルのみを付与
セキュリティリスクを防ぐため、認証情報を環境変数で管理し、リーク防止が重要です。また、サービスアカウントの使用やロールベースアクセス制御（RBAC）の設定も推奨されます。
ロールアウト戦略のカスタマイズ
ArgoCDでは、デプロイ時のロールアウトポリシーを細かく設定できます。以下に、カナリー配置やリロードポリシーの例を示します。
カナリー配置の設定例
以下のようにargocd-application.yamlに記述することで、カナリー配置（Canary Deployment）を実現します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
spec: source: # ... destination: # ... syncPolicy: automated: prune: true selfHeal: true allowedNamespaces: - default canary: enabled: true initialDelaySeconds: 300 |
- initialDelaySeconds: カナリー配置を開始するまでの待ち時間
- prune: 定義外のリソースを削除するか指定
リロードポリシーの調整
ArgoCDでは、以下のリロードポリシーで動作を制御できます。
| ポリシー | 説明 |
|---|---|
| Sync | 定義とクラスターの差分を即座に適用（最速だがリスクあり） |
| Self-Heal | 不一致が発生した場合、自動で修復する設定 |
無理矢理の同期はクラスターに負荷を与えるため、運用状況を見ながらポリシーを調整することが重要です。
即時実践可能な設定ファイルテンプレートダウンロード
記事読了後には、初学者向けの初期設定ファイルパッケージをダウンロードできます。このパッケージは、Kubernetes環境に即座に適用可能な構成で、クラウドベンダー中立な設計となっています。
- 含むファイル一例:
argocd-application.yaml（基本的なアプリケーション定義）.github/workflows/deploy.yml（GitHub Actionsによる自動デプロイ設定）k8s-manifests/（Kustomizeベースのリソーステンプレート）
ダウンロード後は、自身の環境に合わせてカスタマイズすることで、GitOpsをすぐに導入可能です。