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

ステップ 1: プライベート Git リポジトリが GitOps にアクセスできるように名前解決を構成する

次の例では、Git リポジトリのドメイン名 git.abc.cn の構成を実行する方法を示します。

ステップ 2: コンソールまたは CLI を使用して Git リポジトリに接続する

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

現象

kubectl -n argocd 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 の一時記憶領域を増やします。デフォルトでは、これらのコンポーネントは ECI 上で実行され、30 GiB の一時記憶領域があります。次のステップでは、この領域を増やす方法について説明します。課金の詳細については、「一時記憶領域の課金」をご参照ください。

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

2. 対応するデプロイメントの Pod テンプレートで、Pod に k8s.aliyun.com/eci-extra-ephemeral-storage: "20Gi" アノテーションを追加します。一時記憶領域のサイズはカスタマイズできます。

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

     kubectl edit deployment -n argocd argocd-server

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

     kubectl edit deployment -n argocd 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 リソースを追跡します。リソースにこのラベルがあり、その値がアプリケーション名と同じ場合、そのリソースはアプリケーションによって追跡されます。これにより、アプリケーションが OutOfSync 状態のままになったり、アプリケーション以外のリソースが継続的に削除されたりする可能性があります。この予期しない動作を回避するには、次のいずれかのソリューションを使用できます。

解決策

• 解決策 1: フリートの argocd/argocd-cm ファイルに 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 ファイルに、カスタムタグ application.instanceLabelKey: argocd.argoproj.io/instance を追加します。タグを追加すると、Argo CD によって配信されるアプリケーションのリソースには、ラベル argocd.argoproj.io/instance が含まれます。したがって、ラベル 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:
    ···