argocd-advanced について
argocd-advanced は、高度な ArgoCD 操作や自動化タスクを関連資料へ案内するルーティングスキルです。マルチクラスター展開、イメージ更新、クラスターのブートストラップ、アプリのオンボーディングを扱います。
主な機能
- 01タスクに応じた参考資料への案内
- 02ApplicationSet によるマルチクラスター展開
- 03イメージ更新と Git 書き戻しのガイド
- 04クラスター構築とアプリ導入のワークフロー
- 05設定上の注意点とバージョン要件の提示
活用シーン
- 01複数クラスターへのアプリ展開
- 02ArgoCD 管理ワークロードのイメージ更新自動化
- 03Kubernetes クラスターの GitOps 環境への追加
- 04テンプレートを使った新規ワークロードの配備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ julianobarbosa/ claude-code-skills --skill argocd-advancedインストール後、Claude Code で/argocd-advancedを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
References/application-install.mdapplicationset.mdcluster-bootstrapping.mdReferences/applicationset/generators/cluster-generator.yamlgit-generator.yamllist-generator.yamlmatrix-merge-generators.yamlscm-pullrequest-generators.yamlReferences/applicationset/patterns/app-of-apps-pattern.yamlmonorepo-pattern.yamlmulti-cluster-pattern.yamlpr-preview-pattern.yamlReferences/applicationset/templates/basic-templates.yamlgo-templates.yamlmulti-source-templates.yamlReferences/applicationset/troubleshooting/troubleshooting.mdReferences/ArgocdClusterBootstrapping/Workflows/CreateRootApplication.mdDiagnoseSyncFailure.mdOnboardCluster.mdReferences/ArgocdImageUpdater/Workflows/ConfigureImageUpdater.mdCreateImageUpdaterCrds.mdResolveDrift.mdReferences/cluster-bootstrapping/architecture.mdguidance.mdproject-structure.mdsummary.mdReferences/cluster-bootstrapping/templates/applicationset-cluster-generator.yamlapplicationset-matrix-generator.yamlargocd-project.yamlbootstrap-script.sh詳細
ArgoCD の高度な機能
高度な ArgoCD 操作や自動化指向の操作へのルーティング入口です。各サブエリアには、統合前のスキルからそのまま保持された詳細リファレンスがあり、References/ の下にあります。
スコープの振り分け
| 次の作業が必要な場合… | 参照先 |
|---|---|
| ApplicationSet ジェネレーター(list / cluster / git / matrix / merge / SCM / pull-request / plugin)を使って、複数クラスターへのアプリケーションの伝播を実装する | References/applicationset.md および詳細なリファレンスドキュメントの References/applicationset/ |
| ArgoCD 管理下のワークロードのコンテナーイメージ更新を自動化する(更新戦略、ImageUpdater CRD、Git への書き戻し) | References/image-updater.md + References/image-updater/ + References/ArgocdImageUpdater/ + Samples/image-updater/ |
| 複数リポジトリの GitOps 環境に新しい Kubernetes クラスターをブートストラップする | References/cluster-bootstrapping.md + References/cluster-bootstrapping/ + References/ArgocdClusterBootstrapping/ |
| 標準化された ApplicationSet テンプレートを使って新しいワークロードをオンボードする | References/application-install.md + Workflows/application-install/ + Tools/application-install/ |
判断ツリー
Need new cluster registered with ArgoCD? -> cluster-bootstrapping
Need new service deployed to existing clusters? -> application-install
Need to fan one app definition across N clusters? -> applicationset
Need images to roll forward automatically? -> image-updater
注意点
- ApplicationSet ジェネレーターには順序があります。 matrix/merge ジェネレーターでは、親ジェネレーターの結果が子ジェネレーターへの入力になります。順序を間違えると、エラーが出ないままパラメーターセットが空になります。
- Image Updater で Git への書き戻しを行うには、書き込み用の認証情報が必要です。 リポジトリの認証情報が読み取り専用の場合、イメージは元のバージョンのまま更新されません。プッシュ時に
permission deniedが発生していないか、Image Updater の Pod ログを確認してください。 - ブートストラップするクラスターのシークレットには、ApplicationSet ジェネレーターが選択するラベルが必要です。 期待されるラベルのキーと値を付けずにクラスターを登録すると、既存の ApplicationSet から認識されません。エラーは表示されず、アプリが一つも作成されないだけです。
application-installには、組織および ExampleApp 固有のテンプレートが含まれています。 ワークフローは複数リポジトリのレイアウトを前提としています。その環境を使用していない場合は、実行可能な手順ではなく、参考パターンとして扱ってください。- CRD のバージョンが重要です。 ApplicationSet は ArgoCD 2.3 以降に同梱されています。一部のジェネレーター(SCM、pull request)には 2.5 以降が必要です。採用する前に、
References/applicationset.mdの「バージョン互換性」を確認してください。
コメント
Markdown 対応