Container Service for Kubernetes:GitOps のよくある質問

ステップ 1：名前解決の設定

以下の手順では、Git リポジトリのドメイン名として git.abc.cn を例に使用します。

ステップ 2：Git リポジトリへの接続

名前解決を設定すると、ACK One GitOps はプライベート Git リポジトリにアクセスできるようになります。その後、GitOps コンソールまたはコマンドラインインターフェイス (CLI) から Git リポジトリに接続して、アプリケーションをデプロイできます。詳細については、「Private Repositories」をご参照ください。

現象

kubectl -nargocd logs xxxx コマンドを実行してログを確認すると、repo-server は次のエラーメッセージを返します。

'git checkout --force xxx' failed exit status 128: error: unable to write file templates/deployment.yaml\nfat al: sha1 file '/tmp/_argocd-repo/xxx/.git/index.lock' write error. Out of diskspace...

ソリューション

この問題は、ディスク領域の不足により .git/index.lock ファイルへの書き込みに失敗するために発生します。これを解決するには、ACK One GitOps の Argo CD コンポーネントの Pod の一時ストレージを増やします。これらのコンポーネントは Elastic Container Instance (ECI) 上で実行され、デフォルトで 30 GiB の一時ストレージがあります。ストレージを増やすには、次の手順に従ってください。請求情報については、「一時記憶領域の課金」をご参照ください。

1. ACK One コンソールからフリートインスタンスの KubeConfig を取得し、kubectl を使用してフリートインスタンスに接続します。詳細については、「クラスターの KubeConfig を取得し、kubectl を使用してクラスターに接続する」をご参照ください。

2. 関連する Deployment の Pod テンプレートで、Pod に k8s.aliyun.com/eci-extra-ephemeral-storage: "20Gi" アノテーションを追加します。一時ストレージの量はカスタマイズできます。

   • GitOps がデフォルトモードの場合、argocd-server の Deployment にアノテーションを追加します。

     kubectl edit deployment -nargocd argocd-server

   • GitOps が高可用性モードの場合、argocd-dex-imageupdate-repo-server の Deployment にアノテーションを追加します。

     kubectl edit deployment -nargocd argocd-dex-imageupdate-repo-server

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     ...
   ...
   spec:
     template:
       metadata:
         annotations:
           # これにより、デフォルトの 30 GiB に 20 GiB が追加され、合計 50 GiB になります。追加の一時ストレージの量はカスタマイズ可能です。
           k8s.aliyun.com/eci-extra-ephemeral-storage: "20Gi"
         ...
       ...
     ...

背景情報

Argo CD は app.kubernetes.io/instance ラベルを使用して Kubernetes リソースを追跡します。リソースにこのラベルがあり、その値がアプリケーション名と一致する場合、Argo CD はそれを追跡します。これにより、アプリケーションのステータスが OutOfSync のままになったり、アプリケーション以外のリソースが意図せず削除されたりする可能性があります。この動作を防ぐには、次のいずれかのソリューションを使用します。

ソリューション

• ソリューション 1：フリートインスタンスの argocd/argocd-cm ConfigMap に resource.exclusions を追加して、追跡対象のアプリケーション以外のリソースを無視します。次の設定では CiliumIdentity リソースが無視されます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-cm
  labels:
    app.kubernetes.io/name: argocd-cm
    app.kubernetes.io/part-of: argocd
data:
  ...
  resource.exclusions: |
    - apiGroups:
      - cilium.io
      kinds:
      - CiliumIdentity
      clusters:
      - "*"

• ソリューション 2：フリートインスタンスの argocd/argocd-cm ConfigMap に、カスタム追跡ラベル application.instanceLabelKey: argocd.argoproj.io/instance を追加します。この変更後、Argo CD によって管理されるリソースは argocd.argoproj.io/instance ラベルを使用するようになります。これにより、Argo CD が app.kubernetes.io/instance ラベルのみを持つ他のリソースを追跡するのを防ぎます。この設定を適用した後、既存のアプリケーションは再同期されるまで OutOfSync ステータスを示す場合があります。

  apiVersion: v1
  kind: ConfigMap
  metadata:
    name: argocd-cm
    labels:
      app.kubernetes.io/name: argocd-cm
      app.kubernetes.io/part-of: argocd
  data:
    ...
    application.instanceLabelKey: argocd.argoproj.io/instance

現象

Argo CD ApplicationSet で Git ジェネレーターを使用している場合、Git リポジトリ内の依存ディレクトリが追加または名前変更された後、新しい Application リソースの作成に失敗することがあります。この問題は、ApplicationSet リソースをすぐに更新して新しいディレクトリパスを指すようにした場合でも発生する可能性があります。

ソリューション

この問題は、ディレクトリパスが変更されたときに Argo CD がキャッシュを自動的にリフレッシュしないために発生します。これを解決するには、Git ジェネレーターを含む ApplicationSet に argocd.argoproj.io/application-set-refresh="true" アノテーションを追加して、強制的にリフレッシュします。次の例をご参照ください。

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  ···
  annotations:
    ···
    argocd.argoproj.io/application-set-refresh: "true"
spec:
  ···
  generators:
    - git:
        ···     
  template:
    ···