본문으로 건너뛰기

Argo CD CRD

Repository​

repository Secret에 모든 정보를 선언하는 방식과 repository Secret에 type, url만 선언하고 repo-creds Secret에 인증 정보만 선언하는 방식이 있습니다.

apiVersion: v1
kind: Secret
metadata:
  name: github-<user>-<repository>-repo
  namespace: argo-cd
  labels:
    argocd.argoproj.io/secret-type: repository
type: Opaque
stringData:
  type: git
  url: <ssh>:<user>/<repository>.git
  # url: <url>/<user>/<repsitory>

  # username: <username>
  # password: <password>

  # sshPrivateKey: <sshPrivateKey>
apiVersion: v1
kind: Secret
metadata:
  name: github-<user>-creds
  namespace: argo-cd
  labels:
    argocd.argoproj.io/secret-type: repo-creds
type: Opaque
stringData:
  type: git
  # <repsitory>는 선언하지 않습니다.
  url: <ssh>:<user>
  # url: <url>/<user>

  # username: <username>
  # password: <password>

  # sshPrivateKey: <sshPrivateKey>

SSH​

아래 명령어를 통해 SSH 키를 생성한 후, Public 키를 GitHub SSH 키에 추가합니다.

ssh-keygen -t ed25519 -N "" -C "[email protected]" -f argocd
apiVersion: v1
kind: Secret
metadata:
  name: github-<user>-creds
  namespace: argo-cd
  labels:
    argocd.argoproj.io/secret-type: repo-creds
type: Opaque
stringData:
  type: git
  url: [email protected]:<user>
  sshPrivateKey: |
    -----BEGIN OPENSSH PRIVATE KEY-----
    ...
    -----END OPENSSH PRIVATE KEY-----

Cluster​

External​

원격으로 제어하고 싶은 클러스터에 아래와 같이 ServiceAccount를 생성해주세요. 예시는 Admin 권한이 부여된 상태이기 때문에 보안을 위해 권한을 제한해서 부여해주세요.

apiVersion: v1
kind: ServiceAccount
metadata:
  name: argocd-manager
  namespace: kube-system
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: argocd-manager-role
rules:
  - apiGroups:
      - "*"
    resources:
      - "*"
    verbs:
      - "*"
  - nonResourceURLs:
      - "*"
    verbs:
      - "*"
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: argocd-manager-role-binding
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: argocd-manager-role
subjects:
  - kind: ServiceAccount
    name: argocd-manager
    namespace: kube-system

서버 URL, 토큰, 인증서를 가져옵니다.

kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'
kubectl -n kube-system get secret $(kubectl -n kube-system get sa/argocd-manager -o jsonpath="{.secrets[0].name}") -o go-template="{{.data.token | base64decode}}"
kubectl -n kube-system get secret $(kubectl -n kube-system get sa/argocd-manager -o jsonpath="{.secrets[0].name}") -o jsonpath="{.data['ca\.crt']}"

Argo CD가 설치된 클러스터에 아래와 같이 제어하고싶은 클러스터 정보를 추가해주세요.

apiVersion: v1
kind: Secret
metadata:
  name: <clusterName>-cluster
  namespace: argo-cd
  labels:
    argocd.argoproj.io/secret-type: cluster
type: Opaque
stringData:
  name: <clusterName>
  server: <url>
  config: |
    {
      "bearerToken": "<token>",
      "tlsClientConfig": {
        "insecure": false,
        "caData": "<base64 encoded certificate>"
      }
    }

AppProject​

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: <project>
  namespace: argo-cd
  finalizers:
    # 하위에 속한 Application이 있으면 삭제 요청을 거부합니다.
    - resources-finalizer.argocd.argoproj.io
spec:
  description: ""
  sourceRepos:
    - [email protected]:<user>/<repository>.git
  destinations:
    - name: <clusterName>
      namespace: <namespace>
  # 클러스터 스코프에서 허용되는 리소스 리스트입니다.
  clusterResourceWhitelist:
    - group: <group>
      kind: <kind>
  • sourceRepos
    • 해당 AppProject에서 허용하는 리포지토리 목록입니다.
    • *을 사용하면 모든 리포지토리를 허용합니다.
  • destinations
    • 해당 AppProject에서 허용하는 클러스터 목록입니다.
    • name
      • 허용할 클러스터의 이름입니다.
      • *을 사용하면 모든 클러스터를 허용합니다.
    • namespace
      • 허용할 네임스페이스입니다.
      • *을 사용하면 모든 네임스페이스를 허용합니다.
    • server
      • 허용할 클러스터의 kube-apiserver의 URL입니다.
      • *을 사용하면 모든 클러스터를 허용합니다.
  • clusterResourceWhitelist
    • 해당 AppProject에서 허용하는 클러스터 스코프의 리소스 리스트입니다.
    • group
      • 허용할 리소스의 그룹입니다.
      • *을 사용하면 모든 그룹을 허용합니다.
    • kind
      • 허용할 리소스의 종류입니다.
      • *을 사용하면 모든 종류를 허용합니다.
  • namespaceResourceBlacklist
  • namespaceResourceWhitelist
  • roles

Application​

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: <application>-<env>
  namespace: argo-cd
  labels:
    "<example.com/project-env>": <env> # 웹 UI에서 필터링을 위해 사용할 수 있습니다.
  finalizers:
    # 삭제 요청 시 하위에 속한 리소스들을 삭제합니다.
    - resources-finalizer.argocd.argoproj.io
spec:
  project: <project>
  sources: []
  destination:
    name: <clusterName>
    namespace: <namespace>
  revisionHistoryLimit: <limit>
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

Helm​

argo-cd는 차트의 apiVersion이 v2더라도 v3를 사용합니다. v2를 사용하려면 .spec.sources.helm.version을 v2라고 명시해야 합니다.

spec:
  sources:
    - repoURL: [email protected]:<user>/<repository>.git
      path: <path> # Chart.yaml이 있는 디렉토리 경로
      targetRevision: <branch|tag>
      helm:
        valueFiles:
          - <relativePath>/<values>.yaml

차트와 values가 다른 리포지토리에 있을 경우 .spec.sources에 values 소스를 추가하면 됩니다.

spec:
  sources:
    - repoURL: [email protected]:<user>/<repository>.git
      targetRevision: <branch|tag>
      ref: values
    - repoURL: <chartURL>
      chart: <chartName>
      targetRevision: <chartVersion>
      helm:
        valueFiles:
          - $values/<relativePath>/<values>.yaml

ApplicationSet​

Reference​