선언적 클러스터 구성

프로세스

1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 서브스크립션 으로 이동합니다.
2. 작업 목록을 클릭한 다음 서브스크립션 편집을 클릭합니다.

3. openshift-gitops-operator Subscription 세부 정보 페이지의 YAML 탭에서 Argo CD 인스턴스의 네임스페이스를 spec 섹션의 ARGOCD_CLUSTER_CONFIG_NAMESPACES 환경 변수에 추가하여 서브스크립션 YAML 파일을 편집합니다.

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-gitops-operator
   # ...
   spec:
     config:
       env:
       - name: ARGOCD_CLUSTER_CONFIG_NAMESPACES
         value: openshift-gitops, <list of namespaces of cluster-scoped Argo CD instances>
   # ...

   Copy to Clipboard Toggle word wrap
4. 저장 및 다시 로드 를 클릭합니다.

5. 클러스터 범위 리소스를 관리하기 위해 Argo CD 인스턴스가 클러스터 역할로 구성되었는지 확인하려면 다음 단계를 수행합니다.

   1. 사용자 관리 → 역할로 이동하여 필터 목록에서 클러스터 전체 역할을 선택합니다.

   2. 이름으로 검색 필드를 사용하여 argocd-application-controller 를 검색합니다.

      역할 페이지에는 생성된 클러스터 역할이 표시됩니다.

      작은 정보

      또는 OpenShift CLI에서 다음 명령을 실행합니다.

      oc auth can-i create oauth -n openshift-gitops --as system:serviceaccount:openshift-gitops:openshift-gitops-argocd-application-controller

      Copy to Clipboard Toggle word wrap

      출력 yes 는 클러스터 범위 리소스를 관리하기 위해 Argo 인스턴스가 클러스터 역할로 구성되어 있는지 확인합니다. 필요에 따라 구성을 확인하고 필요한 단계를 수행합니다.

프로세스

1. 기존 노드에 레이블을 지정합니다.

   $ oc label node <node-name> node-role.kubernetes.io/infra=""

   Copy to Clipboard Toggle word wrap

2. 선택 사항: 필요한 경우 테인트를 적용하고 인프라 노드에 워크로드를 분리하고 다른 워크로드가 이러한 노드에서 예약되지 않도록 할 수도 있습니다.

   $ oc adm taint nodes -l node-role.kubernetes.io/infra \
   infra=reserved:NoSchedule infra=reserved:NoExecute

   Copy to Clipboard Toggle word wrap

3. GitOpsService 사용자 정의 리소스에 runOnInfra 토글을 추가합니다.

   apiVersion: pipelines.openshift.io/v1alpha1
   kind: GitopsService
   metadata:
     name: cluster
   spec:
     runOnInfra: true

   Copy to Clipboard Toggle word wrap

4. 선택 사항: 테인트가 노드에 추가된 경우 GitOpsService 사용자 정의 리소스에 허용 오차 를 추가합니다.

   예

   apiVersion: pipelines.openshift.io/v1alpha1
   kind: GitopsService
   metadata:
     name: cluster
     spec:
       runOnInfra: true
       tolerations:
       - effect: NoSchedule
         key: infra
         value: reserved
       - effect: NoExecute
         key: infra
         value: reserved

   Copy to Clipboard Toggle word wrap

5. 콘솔 UI에서 Pod → Pod 세부 정보를 확인하여 openshift-gitops 네임스페이스의 워크로드가 인프라 노드에 예약되었는지 확인합니다.

프로세스

1. Argo CD 대시보드에서 새 APP를 클릭하여 새 Argo CD 애플리케이션을 추가합니다.

2. 이 워크플로의 경우 다음 구성을 사용하여 cluster-configs 애플리케이션을 생성합니다.

   애플리케이션 이름

   cluster-configs

   프로젝트

   default

   동기화 정책

   Manual

   리포지터리 URL

   https://github.com/redhat-developer/openshift-gitops-getting-started

   버전

   HEAD

   경로

   cluster

   대상

   https://kubernetes.default.svc

   네임스페이스

   spring-petclinic

   디렉토리 반복

   checked

3. 만들기 를 클릭하여 애플리케이션을 생성합니다.
4. 웹 콘솔의 관리자 화면을 열고 관리 → 네임스페이스를 확장합니다.
5. 네임스페이스를 검색하고 선택한 다음 레이블 필드에 argocd.argoproj.io/managed-by=openshift-gitops 를 입력하여 openshift-gitops 네임스페이스의 Argo CD 인스턴스가 네임스페이스를 관리할 수 있도록 합니다.

프로세스

1. 샘플 애플리케이션을 다운로드합니다.

   $ git clone git@github.com:redhat-developer/openshift-gitops-getting-started.git

   Copy to Clipboard Toggle word wrap

2. 애플리케이션을 생성합니다.

   $ oc create -f openshift-gitops-getting-started/argo/app.yaml

   Copy to Clipboard Toggle word wrap

3. oc get 명령을 실행하여 생성된 애플리케이션을 검토합니다.

   $ oc get application -n openshift-gitops

   Copy to Clipboard Toggle word wrap

4. openshift-gitops 네임스페이스의 Argo CD 인스턴스에서 관리할 수 있도록 애플리케이션이 배포되는 네임스페이스에 레이블을 추가합니다.

   $ oc label namespace spring-petclinic argocd.argoproj.io/managed-by=openshift-gitops

   Copy to Clipboard Toggle word wrap

프로세스

1. Argo CD 서버의 관리자 계정 암호를 가져옵니다.

   $ ADMIN_PASSWD=$(oc get secret openshift-gitops-cluster -n openshift-gitops -o jsonpath='{.data.admin\.password}' | base64 -d)

   Copy to Clipboard Toggle word wrap

2. Argo CD 서버 URL을 가져옵니다.

   $ SERVER_URL=$(oc get routes openshift-gitops-server -n openshift-gitops -o jsonpath='{.status.ingress[0].host}')

   Copy to Clipboard Toggle word wrap

3. admin 계정 암호를 사용하여 Argo CD 서버에 로그인하고 작은따옴표로 전달합니다.

   중요

   암호를 작은따옴표로 포함하면 쉘에 의해 $ 와 같은 특수 문자가 잘못 해석되지 않습니다. 항상 작은 따옴표를 사용하여 암호의 리터럴 값을 묶습니다.

   $ argocd login --username admin --password ${ADMIN_PASSWD} ${SERVER_URL}

   Copy to Clipboard Toggle word wrap

   예

   $ argocd login --username admin --password '<password>' openshift-gitops.openshift-gitops.apps-crc.testing

   Copy to Clipboard Toggle word wrap

4. 모든 애플리케이션을 나열하여 기본 모드에서 argocd 명령을 실행할 수 있는지 확인합니다.

   $ argocd app list

   Copy to Clipboard Toggle word wrap

   구성이 올바르면 다음 헤더를 사용하여 기존 애플리케이션이 나열됩니다.

   샘플 출력

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

   Copy to Clipboard Toggle word wrap

5. 기본 모드에서 애플리케이션을 생성합니다.

   $ argocd app create app-cluster-configs \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path cluster \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy none \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

   Copy to Clipboard Toggle word wrap

6. openshif-gitops Argo CD 인스턴스에서 관리할 spring-petclinic 대상 네임스페이스에 레이블을 지정합니다.

   $ oc label ns spring-petclinic "argocd.argoproj.io/managed-by=openshift-gitops"

   Copy to Clipboard Toggle word wrap

7. 사용 가능한 애플리케이션을 나열하여 애플리케이션이 성공적으로 생성되었는지 확인합니다.

   $ argocd app list

   Copy to Clipboard Toggle word wrap

   cluster-configs Argo CD 애플리케이션의 상태가 Healthy 이지만 none 동기화 정책으로 인해 자동으로 동기화되지 않아 OutOfSync 상태가 유지됩니다.

프로세스

1. oc CLI 툴을 사용하여 OpenShift Container Platform 클러스터에 로그인합니다.

   $ oc login -u <username> -p <password> <server_url>

   Copy to Clipboard Toggle word wrap

   예

   $ oc login -u kubeadmin -p '<password>' https://api.crc.testing:6443

   Copy to Clipboard Toggle word wrap

2. kubeconfig 파일에서 컨텍스트가 올바르게 설정되었는지 확인합니다.

   $ oc config current-context

   Copy to Clipboard Toggle word wrap

3. 현재 컨텍스트의 기본 네임스페이스를 openshift-gitops:로 설정합니다.

   $ oc config set-context --current --namespace openshift-gitops

   Copy to Clipboard Toggle word wrap

4. Argo CD 구성 요소 이름을 덮어쓰려면 다음 환경 변수를 설정합니다.

   $ export ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server

   Copy to Clipboard Toggle word wrap

5. 모든 애플리케이션을 나열하여 코어 모드에서 argocd 명령을 실행할 수 있는지 확인합니다.

   $ argocd app list --core

   Copy to Clipboard Toggle word wrap

   구성이 올바르면 다음 헤더를 사용하여 기존 애플리케이션이 나열됩니다.

   샘플 출력

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

   Copy to Clipboard Toggle word wrap

6. 코어 모드로 애플리케이션을 생성합니다.

   $ argocd app create app-cluster-configs --core \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path cluster \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy none \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

   Copy to Clipboard Toggle word wrap

7. openshif-gitops Argo CD 인스턴스에서 관리할 spring-petclinic 대상 네임스페이스에 레이블을 지정합니다.

   $ oc label ns spring-petclinic "argocd.argoproj.io/managed-by=openshift-gitops"

   Copy to Clipboard Toggle word wrap

8. 사용 가능한 애플리케이션을 나열하여 애플리케이션이 성공적으로 생성되었는지 확인합니다.

   $ argocd app list --core

   Copy to Clipboard Toggle word wrap

   cluster-configs Argo CD 애플리케이션의 상태가 Healthy 이지만 none 동기화 정책으로 인해 자동으로 동기화되지 않아 OutOfSync 상태가 유지됩니다.

프로세스

1. Argo CD 대시보드에서 cluster-configs Argo CD 애플리케이션은 Missing 및 OutOfSync 상태입니다. 애플리케이션이 수동 동기화 정책으로 구성되었으므로 Argo CD는 자동으로 동기화되지 않습니다.
2. cluster-configs 타일에서 SYNC 를 클릭하고 변경 사항을 검토한 다음 SYNCHRONIZE 를 클릭합니다. Argo CD는 Git 리포지토리의 모든 변경 사항을 자동으로 감지합니다. 구성이 변경되면 Argo CD는 cluster-configs의 상태를 OutOfSync로 변경합니다. Argo CD의 동기화 정책을 수정하여 Git 리포지토리에서 클러스터에 변경 사항을 자동으로 적용할 수 있습니다.
3. cluster-configs Argo CD 애플리케이션이 이제 Healthy 및 Synced 상태가 됩니다. cluster-configs 타일을 클릭하여 동기화된 리소스의 세부 정보와 클러스터의 상태를 확인합니다.
4. OpenShift Container Platform 웹 콘솔로 이동하여 를 클릭하여 Red Hat 개발자 블로그(Kubernetes )에 대한 링크가 있는지 확인합니다.

5. 프로젝트 페이지로 이동하여 spring-petclinic 네임스페이스를 검색하여 클러스터에 추가되었는지 확인합니다.

   클러스터 구성이 클러스터에 성공적으로 동기화됩니다.

프로세스

1. Argo CD 서버의 관리자 계정 암호를 가져옵니다.

   $ ADMIN_PASSWD=$(oc get secret openshift-gitops-cluster -n openshift-gitops -o jsonpath='{.data.admin\.password}' | base64 -d)

   Copy to Clipboard Toggle word wrap

2. Argo CD 서버 URL을 가져옵니다.

   $ SERVER_URL=$(oc get routes openshift-gitops-server -n openshift-gitops -o jsonpath='{.status.ingress[0].host}')

   Copy to Clipboard Toggle word wrap

3. admin 계정 암호를 사용하여 Argo CD 서버에 로그인하고 작은따옴표로 전달합니다.

   중요

   암호를 작은따옴표로 포함하면 쉘에 의해 $ 와 같은 특수 문자가 잘못 해석되지 않습니다. 항상 작은 따옴표를 사용하여 암호의 리터럴 값을 묶습니다.

   $ argocd login --username admin --password ${ADMIN_PASSWD} ${SERVER_URL}

   Copy to Clipboard Toggle word wrap

   예

   $ argocd login --username admin --password '<password>' openshift-gitops.openshift-gitops.apps-crc.testing

   Copy to Clipboard Toggle word wrap

4. 애플리케이션이 none 동기화 정책으로 구성되므로 동기화 작업을 수동으로 트리거해야 합니다.

   $ argocd app sync openshift-gitops/app-cluster-configs

   Copy to Clipboard Toggle word wrap

5. 애플리케이션을 나열하여 애플리케이션에 Healthy 및 Synced 상태가 있는지 확인합니다.

   $ argocd app list

   Copy to Clipboard Toggle word wrap

프로세스

1. oc CLI 툴을 사용하여 OpenShift Container Platform 클러스터에 로그인합니다.

   $ oc login -u <username> -p <password> <server_url>

   Copy to Clipboard Toggle word wrap

   예

   $ oc login -u kubeadmin -p '<password>' https://api.crc.testing:6443

   Copy to Clipboard Toggle word wrap

2. kubeconfig 파일에서 컨텍스트가 올바르게 설정되었는지 확인합니다.

   $ oc config current-context

   Copy to Clipboard Toggle word wrap

3. 현재 컨텍스트의 기본 네임스페이스를 openshift-gitops:로 설정합니다.

   $ oc config set-context --current --namespace openshift-gitops

   Copy to Clipboard Toggle word wrap

4. Argo CD 구성 요소 이름을 덮어쓰려면 다음 환경 변수를 설정합니다.

   $ export ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server

   Copy to Clipboard Toggle word wrap

5. 애플리케이션이 none 동기화 정책으로 구성되므로 동기화 작업을 수동으로 트리거해야 합니다.

   $ argocd app sync --core openshift-gitops/app-cluster-configs

   Copy to Clipboard Toggle word wrap

6. 애플리케이션을 나열하여 애플리케이션에 Healthy 및 Synced 상태가 있는지 확인합니다.

   $ argocd app list --core

   Copy to Clipboard Toggle word wrap

프로세스

1. 웹 콘솔에서 사용자 관리 → 역할 → 역할 생성 을 선택합니다. 다음 ClusterRole YAML 템플릿을 사용하여 추가 권한을 지정하는 규칙을 추가합니다.

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: secrets-cluster-role
   rules:
   - apiGroups: [""]
     resources: ["secrets"]
     verbs: ["*"]

   Copy to Clipboard Toggle word wrap
2. 생성 을 클릭하여 클러스터 역할을 추가합니다.
3. 클러스터 역할 바인딩을 생성하려면 사용자 관리 → 역할 바인딩 → 바인딩 생성 을 선택합니다.
4. 프로젝트 목록에서 모든 프로젝트를 선택합니다.
5. 바인딩 생성을 클릭합니다.
6. 바인딩 유형을 Cluster-wide 역할 바인딩(ClusterRoleBinding) 으로 선택합니다.
7. RoleBinding 이름의 고유 값을 입력합니다.
8. 드롭다운 목록에서 새로 생성된 클러스터 역할 또는 기존 클러스터 역할을 선택합니다.

9. 주체 를 ServiceAccount 로 선택하고 주체 네임스페이스 및 이름을 제공합니다.

   1. subject namespace:openshift-gitops

   2. 제목 이름:openshift-gitops-argocd-application-controller

      참고

      주체 이름 값은 클러스터 역할 및 클러스터 역할 바인딩을 생성하는 GitOps 컨트롤 플레인 구성 요소에 따라 다릅니다.

10. 생성을 클릭합니다. ClusterRoleBinding 오브젝트의 YAML 파일은 다음과 같습니다.

    kind: ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
      name: cluster-role-binding
    subjects:
      - kind: ServiceAccount
        name: openshift-gitops-argocd-application-controller
        namespace: openshift-gitops
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: secrets-cluster-role

    Copy to Clipboard Toggle word wrap

프로세스

1. Argo CD CR에서 .spec.defaultClusterScopedRoleDisabled 필드의 값을 true 로 설정합니다.

   Argo CD CR의 예

   apiVersion: argoproj.io/v1beta1
   kind: ArgoCD
   metadata:
     name: example 

   1

   
     namespace: spring-petclinic 

   2

   
   # ...
   spec:
     defaultClusterScopedRoleDisabled: true 

   3

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   클러스터 범위 인스턴스의 이름입니다.

   2

   클러스터 범위 인스턴스를 실행할 네임스페이스입니다.

   3

   클러스터 범위 인스턴스의 기본 클러스터 역할 생성을 비활성화하는 플래그 값입니다. Operator에서 클러스터 범위 인스턴스의 기본 클러스터 역할 및 클러스터 역할 바인딩을 다시 생성하려면 필드 값을 false 로 설정합니다.

   샘플 출력

   argocd.argoproj.io/example configured

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 Red Hat OpenShift GitOps Operator가 GitOps 컨트롤 플레인 구성 요소의 기본 클러스터 역할 및 클러스터 역할 바인딩을 삭제했는지 확인합니다.

   $ oc get ClusterRoles/<argocd_name>-<argocd_namespace>-<control_plane_component>

   Copy to Clipboard Toggle word wrap

   $ oc get ClusterRoleBindings/<argocd_name>-<argocd_namespace>-<control_plane_component>

   Copy to Clipboard Toggle word wrap

   샘플 출력

   No resources found

   Copy to Clipboard Toggle word wrap

   클러스터 범위 인스턴스의 기본 클러스터 역할 및 클러스터 역할 바인딩이 생성되지 않습니다. 클러스터 관리자는 GitOps 컨트롤 플레인 구성 요소에 대한 새 클러스터 역할 및 클러스터 역할 바인딩을 생성하여 클러스터 범위 인스턴스에 대한 권한을 생성하고 사용자 지정할 수 있습니다.

프로세스

1. 웹 콘솔의 관리자 화면을 열고 사용자 관리 → 역할 → 역할 생성 으로 이동합니다.

2. 다음 ClusterRole YAML 템플릿을 사용하여 추가 권한을 지정하는 규칙을 추가합니다.

   클러스터 역할 YAML 템플릿의 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: example-spring-petclinic-argocd-application-controller 

   1

   
   rules:
     - verbs:
         - get
         - list
         - watch
       apiGroups:
         - '*'
       resources:
         - '*'
     - verbs:
         - '*'
       apiGroups:
         - ''
       resources: 

   2

   
         - namespaces
         - persistentvolumes

   Copy to Clipboard Toggle word wrap

   1

   <argocd_name>-<argocd_namespace>-<control_plane_component> 이름 지정 규칙에 따른 클러스터 역할의 이름입니다.

   2

   클러스터 수준에서 권한을 부여할 리소스입니다.

3. 생성 을 클릭하여 클러스터 역할을 추가합니다.

4. 다음 단계를 수행하여 권한을 사용자 지정하는 컨트롤 플레인 구성 요소에서 사용하는 서비스 계정을 찾습니다.

   1. 워크로드 → Pod 로 이동합니다.
   2. 프로젝트 목록에서 사용자 정의 클러스터 범위 인스턴스가 설치된 프로젝트를 선택합니다.
   3. 컨트롤 플레인 구성 요소의 Pod를 클릭하고 YAML 탭으로 이동합니다.
   4. spec.ServiceAccount 필드를 찾아 서비스 계정을 기록해 둡니다.
5. 사용자 관리 → RoleBindings → 바인딩 생성 으로 이동합니다.
6. 바인딩 생성을 클릭합니다.
7. 바인딩 유형을 Cluster-wide 역할 바인딩(ClusterRoleBinding) 으로 선택합니다.
8. <argocd_ name>-<argocd_namespace>-<control_plane_component> 이름 지정 규칙에 따라 RoleBinding 이름의 고유 값을 입력합니다.
9. 역할 이름의 드롭다운 목록에서 새로 생성된 클러스터 역할을 선택합니다.

10. 주체 를 ServiceAccount 로 선택하고 주체 네임스페이스 및 이름을 제공합니다.

    1. subject namespace:spring-petclinic

    2. 제목 이름:example-argocd-application-controller

       참고

       주체 이름 의 경우 구성한 값이 권한을 사용자 지정하는 컨트롤 플레인 구성 요소의 spec.ServiceAccount 필드 값과 같은지 확인합니다.

11. 생성을 클릭합니다.

    컨트롤 플레인 구성 요소의 서비스 계정 및 네임스페이스에 필요한 권한이 생성되어 있습니다. ClusterRoleBinding 오브젝트의 YAML 파일은 다음 예와 유사합니다.

    클러스터 역할 바인딩의 YAML 파일의 예

    kind: ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
      name: example-spring-petclinic-argocd-application-controller
    subjects:
      - kind: ServiceAccount
        name: example-argocd-application-controller
        namespace: spring-petclinic
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: example-spring-petclinic-argocd-application-controller

    Copy to Clipboard Toggle word wrap

1. 집계된 클러스터 역할 생성 활성화
2. 사용자 정의 클러스터 역할 생성 및 애플리케이션 컨트롤러에 대한 사용자 정의 권한 구성

프로세스

1. Argo CD CR에서 .spec.aggregatedClusterRoles 필드의 값을 true 로 설정합니다.

   Argo CD CR의 예

   apiVersion: argoproj.io/v1beta1
   kind: ArgoCD
   metadata:
     name: example 

   1

   
     namespace: spring-petclinic 

   2

   
   # ...
   spec:
     aggregatedClusterRoles: true 

   3

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   클러스터 범위 인스턴스의 이름입니다.

   2

   클러스터 범위 인스턴스를 실행할 네임스페이스입니다.

   3

   value를 true 로 설정하면 집계된 클러스터 역할을 생성할 수 있습니다. 집계된 클러스터 역할 생성을 활성화하지 않으려면 이 행을 포함하지 않거나 값을 false 로 설정합니다.

   출력 예

   argocd.argoproj.io/example configured

   Copy to Clipboard Toggle word wrap

2. 클러스터 범위의 Argo CD 인스턴스의 Status 필드가 Phase: Available 로 표시되는지 확인합니다. 다음 명령을 실행하여 사용할 수 있습니다.

   $ oc describe argocd.argoproj.io/example -n spring-petclinic

   Copy to Clipboard Toggle word wrap

   출력 예

   Name:         example
   Namespace:    spring-petclinic
   Labels:       <none>
   Annotations:  <none>
   API Version:  argoproj.io/v1beta1
   Kind:         ArgoCD
   Metadata:
     Creation Timestamp:  2024-08-14T08:20:53Z
     Finalizers:
       argoproj.io/finalizer
     Generation:        3
     Resource Version:  60437
     UID:               57940e54-d60b-4c1a-bc4a-85c81c63ab69
   Spec:
     Aggregated Cluster Roles:  true
   ...
   Status:
     Application Controller:      Running
     Application Set Controller:  Unknown
     Phase:                       Available 

   1

   
     Redis:                       Running
     Repo:                        Running
     Server:                      Running
     Sso:                         Unknown
   Events:                        <none>

   Copy to Clipboard Toggle word wrap

   1

   Available 상태는 클러스터 범위의 Argo CD 인스턴스가 정상이고 사용 가능함을 나타냅니다.

   참고

   Red Hat OpenShift GitOps Operator는 다음과 같은 기본 클러스터 역할을 생성하고 관리합니다.

   • <argocd_name>-<argocd_namespace>-argocd-application-controller 집계 클러스터 역할
   • <argocd_name>-<argocd_namespace>-argocd-application-controller-view
   • <argocd_name>-<argocd_namespace>-argocd-application-controller-admin

3. 다음 명령을 실행하여 Operator에서 Argo CD 애플리케이션 컨트롤러 및 Argo CD 서버 구성 요소에 대한 기본 클러스터 역할 및 클러스터 역할 바인딩을 생성했는지 확인합니다.

   $ oc get ClusterRoles -l app.kubernetes.io/part-of=argocd

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                                           CREATED AT
   example-spring-petclinic-argocd-application-controller         2024-08-14T08:20:58Z
   example-spring-petclinic-argocd-application-controller-admin   2024-08-14T09:08:38Z
   example-spring-petclinic-argocd-application-controller-view    2024-08-14T09:08:38Z
   example-spring-petclinic-argocd-server                         2024-08-14T08:20:59Z

   Copy to Clipboard Toggle word wrap

   $ oc get ClusterRoleBindings -l app.kubernetes.io/part-of=argocd

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                                     ROLE                                                                 AGE
   example-spring-petclinic-argocd-application-controller   ClusterRole/example-spring-petclinic-argocd-application-controller   54m
   example-spring-petclinic-argocd-server                   ClusterRole/example-spring-petclinic-argocd-server                   54m

   Copy to Clipboard Toggle word wrap

   view 및 admin 클러스터 역할에 대한 클러스터 역할 바인딩은 생성되지 않습니다. view 및 admin 클러스터 역할은 집계된 클러스터 역할에만 권한을 추가하고 Argo CD 애플리케이션 컨트롤러에 대한 권한을 직접 구성하지 않기 때문입니다.

   작은 정보

   또는 OpenShift Container Platform 웹 콘솔을 사용하여 관리자 화면에서 확인할 수 있습니다. 사용자 관리 → 역할 및 사용자 관리 → RoleBindings 로 각각 이동할 수 있습니다. app.kubernetes.io/part-of:argocd 레이블이 있는 클러스터 역할 및 클러스터 역할 바인딩을 검색할 수 있습니다.

4. 다음 명령을 실행하여 생성된 역할의 출력 권한을 확인하여 집계된 클러스터 역할이 생성되었는지 확인합니다.

   $ oc get ClusterRole/<cluster_role_name> -o yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   & lt;cluster_role_name >을 생성된 역할의 이름으로 바꿉니다.

   집계된 클러스터 역할의 출력 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     annotations:
       argocds.argoproj.io/name: example
       argocds.argoproj.io/namespace: spring-petclinic
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"argoproj.io/v1beta1","kind":"ArgoCD","metadata":{"annotations":{},"name":"example","namespace":"spring-petclinic"},"spec":{"aggregatedClusterRoles":true}}
       rbac.authorization.kubernetes.io/autoupdate: "true"
     creationTimestamp: "2024-08-14T08:20:58Z"
     labels:
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
     name: example-spring-petclinic-argocd-application-controller 

   1

   
     resourceVersion: "78640"
     uid: aeeb2ef5-b531-4fe3-a61a-b5ad8dd8ca6e
   aggregationRule: 

   2

   
     clusterRoleSelectors:
     - matchLabels:
         app.kubernetes.io/managed-by: spring-petclinic
         argocd/aggregate-to-controller: "true"
   rules: [] 

   3

   Copy to Clipboard Toggle word wrap

   1

   집계된 클러스터 역할의 이름입니다.

   2

   사전 정의된 라벨 목록은 집계된 클러스터 역할이 다른 사용자 정의 클러스터 역할의 권한을 상속할 수 있음을 나타냅니다.

   3

   사전 정의된 권한이 설정되어 있지 않습니다. 그러나 Operator가 < argocd_name>-<argocd_namespace>-argocd-application-controller-view 클러스터 역할을 즉시 생성하면 해당 사전 정의된 보기 권한이 집계된 클러스터 역할에 추가됩니다.

   view 클러스터 역할의 출력 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     annotations:
       argocds.argoproj.io/name: example
       argocds.argoproj.io/namespace: spring-petclinic
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"argoproj.io/v1beta1","kind":"ArgoCD","metadata":{"annotations":{},"name":"example","namespace":"spring-petclinic"},"spec":{"aggregatedClusterRoles":true}}
     creationTimestamp: "2024-08-14T09:59:14Z"
     labels: 

   1

   
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
       argocd/aggregate-to-controller: "true"
     name: example-spring-petclinic-argocd-application-controller-view 

   2

   
     resourceVersion: "78639"
     uid: 068b8867-7a0c-4af3-a17a-0560a00eba41
   rules: 

   3

   
   - apiGroups:
     - '*'
     resources:
     - '*'
     verbs:
     - get
     - list
     - watch
   - nonResourceURLs:
     - '*'
     verbs:
     - get
     - list

   Copy to Clipboard Toggle word wrap

   1

   레이블은 사전 정의된 기존 집계 클러스터 역할의 목록과 일치합니다.

   2

   뷰 클러스터 역할의 이름입니다.

   3

   사전 정의된 보기 권한입니다. 이러한 권한은 기존 집계된 클러스터 역할에 추가됩니다.

   admin 클러스터 역할의 출력 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     annotations:
       argocds.argoproj.io/name: example
       argocds.argoproj.io/namespace: spring-petclinic
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"argoproj.io/v1beta1","kind":"ArgoCD","metadata":{"annotations":{},"name":"example","namespace":"spring-petclinic"},"spec":{"aggregatedClusterRoles":true}}
       rbac.authorization.kubernetes.io/autoupdate: "true"
     creationTimestamp: "2024-08-14T09:59:15Z"
     labels: 

   1

   
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
       argocd/aggregate-to-controller: "true"
     name: example-spring-petclinic-argocd-application-controller-admin 

   2

   
     resourceVersion: "78642"
     uid: e2d35b6f-0832-4993-8b24-915a725454f9
   aggregationRule: 

   3

   
     clusterRoleSelectors:
     - matchLabels:
         app.kubernetes.io/managed-by: spring-petclinic
         argocd/aggregate-to-admin: "true"
   rules: null 

   4

   Copy to Clipboard Toggle word wrap

   1

   레이블은 사전 정의된 기존 집계 클러스터 역할의 목록과 일치합니다.

   2

   admin 클러스터 역할의 이름입니다.

   3

   사전 정의된 라벨 목록은 기존 < argocd_name>-<argocd_namespace>-argocd-application-controller-admin 클러스터 역할이 다른 사용자 정의 클러스터 역할의 권한을 상속할 수 있음을 나타냅니다.

   4

   하나 이상의 사용자 정의 클러스터 역할에 아직 권한이 정의되어 있지 않도록 지정합니다.

   작은 정보

   또는 OpenShift Container Platform 웹 콘솔을 사용하여 관리자 화면에서 확인할 수 있습니다. 사용자 관리 → 역할로 이동하여 필터 옵션을 사용하여 클러스터 전체 역할을 선택하고 집계된 클러스터 역할을 검색하고, 사용자 관리 및 관리자 클러스터 역할을 볼 수 있습니다. 세부 정보 및 구성을 확인하려면 클러스터 역할을 열어야 합니다.

   클러스터 관리자는 이제 하나 이상의 사용자 정의 클러스터 역할을 생성하고 Argo CD 애플리케이션 컨트롤러에 대한 사용자 정의 권한을 구성할 수 있습니다.

프로세스

1. 다음 명령을 사용하여 필수 레이블 및 권한으로 새 클러스터 역할을 생성합니다.

   $ oc apply -n <namespace> -f <cluster_role_name>.yaml

   Copy to Clipboard Toggle word wrap

   다음과 같습니다.

   <namespace>

   정의된 네임스페이스의 이름을 지정합니다.

   <cluster_role_name>

   정의된 클러스터 역할 YAML 파일의 이름을 지정합니다.

   사용자 정의 클러스터 역할 YAML의 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: user-application-controller 

   1

   
     labels: 

   2

   
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
       argocd/aggregate-to-admin: 'true'
   rules: 

   3

   
     - verbs:
         - '*'
       apiGroups:
         - ''
       resources:
         - namespaces
         - persistentvolumeclaims
         - persistentvolumes
         - configmaps
     - verbs:
         - '*'
       apiGroups:
         - compliance.openshift.io
       resources:
         - scansettingbindings

   Copy to Clipboard Toggle word wrap

   1

   사용자 정의 클러스터 역할의 이름입니다.

   2

   레이블은 기존 < argocd_name>-<argocd_namespace>-argocd-application-controller-admin 클러스터 역할의 사전 정의된 목록과 일치합니다.

   3

   < argocd_name>-<argocd_namespace>-argocd-application-controller-admin 클러스터 역할을 통해 집계된 클러스터 역할에 추가할 사용자 정의 권한입니다.

   작은 정보

   또는 웹 콘솔을 사용하여 관리자 화면에서 사용자 정의 클러스터 역할을 생성할 수 있습니다. 사용자 관리 → 역할 → 역할 생성 으로 이동하여 이전 YAML 템플릿을 사용하여 권한을 추가하고 생성 을 클릭합니다.

   출력 예

   clusterrole.rbac.authorization.k8s.io/user-application-controller created

   Copy to Clipboard Toggle word wrap

   사용자 정의 클러스터 역할이 생성됩니다.

2. 다음 명령을 실행하여 < argocd_name>-<argocd_namespace>-argocd-application-controller-admin 클러스터 역할이 사용자 정의 클러스터 역할의 권한을 상속하는지 확인합니다.

   $ oc get ClusterRole/<argocd_name>-<argocd_namespace>-argocd-application-controller-admin -o yaml

   Copy to Clipboard Toggle word wrap

   다음과 같습니다.

   <argocd_name>

   사용자 정의 클러스터 범위 Argo CD 인스턴스의 이름을 지정합니다.

   <argocd_namespace>

   Argo CD가 설치된 네임스페이스를 지정합니다.

   출력 예

   aggregationRule:
     clusterRoleSelectors:
     - matchLabels:
         app.kubernetes.io/managed-by: spring-petclinic
         argocd/aggregate-to-admin: "true"
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     annotations:
       argocds.argoproj.io/name: example
       argocds.argoproj.io/namespace: spring-petclinic
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"argoproj.io/v1beta1","kind":"ArgoCD","metadata":{"annotations":{},"name":"example","namespace":"spring-petclinic"},"spec":{"aggregatedClusterRoles":true}}
     creationTimestamp: "2024-08-14T09:59:15Z"
     labels:
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
       argocd/aggregate-to-controller: "true"
     name: example-spring-petclinic-argocd-application-controller-admin
     resourceVersion: "79202"
     uid: e2d35b6f-0832-4993-8b24-915a725454f9
   rules:
   - apiGroups:
     - ""
     resources:
     - namespaces
     - persistentvolumeclaims
     - persistentvolumes
     - configmaps
     verbs:
     - '*'
   - apiGroups:
     - compliance.openshift.io
     resources:
     - scansettingbindings
     verbs:
     - '*'

   Copy to Clipboard Toggle word wrap

   작은 정보

   또는 OpenShift Container Platform 웹 콘솔을 사용하여 관리자 화면에서 확인할 수 있습니다. 사용자 관리 → 역할로 이동하여 필터 옵션을 사용하여 클러스터 전체 역할을 선택하고 < argocd_name>-<argocd_namespace>-argocd-application-controller-admin 클러스터 역할을 검색할 수 있습니다. 세부 정보 및 구성을 확인하려면 클러스터 역할을 열어야 합니다.

3. 다음 명령을 실행하여 < argocd_name>-<argocd_namespace>-argocd_application-controller 집계 클러스터 역할에서 < argocd_name>-<argocd_namespace>-argocd_namespace>-argocd-application-controller-admin 및 < argocd_name>-<argocd_namespace>-argocd_controller-view 의 권한을 상속하는지 확인합니다.

   $ oc get ClusterRole/<argocd_name>-<argocd_namespace>-argocd-application-controller -o yaml

   Copy to Clipboard Toggle word wrap

   다음과 같습니다.

   <argocd_name>

   사용자 정의 클러스터 범위 Argo CD 인스턴스의 이름을 지정합니다.

   <argocd_namespace>

   Argo CD가 설치된 네임스페이스를 지정합니다.

   집계된 클러스터 역할의 출력 예

   aggregationRule:
     clusterRoleSelectors:
     - matchLabels:
         app.kubernetes.io/managed-by: spring-petclinic
         argocd/aggregate-to-controller: "true"
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     annotations:
       argocds.argoproj.io/name: example
       argocds.argoproj.io/namespace: spring-petclinic
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"argoproj.io/v1beta1","kind":"ArgoCD","metadata":{"annotations":{},"name":"example","namespace":"spring-petclinic"},"spec":{"aggregatedClusterRoles":true}}
       rbac.authorization.kubernetes.io/autoupdate: "true"
     creationTimestamp: "2024-08-14T08:20:58Z"
     labels:
       app.kubernetes.io/managed-by: spring-petclinic
       app.kubernetes.io/name: example
       app.kubernetes.io/part-of: argocd
     name: example-spring-petclinic-argocd-application-controller
     resourceVersion: "79203"
     uid: aeeb2ef5-b531-4fe3-a61a-b5ad8dd8ca6e
   rules:
   - apiGroups:
     - ""
     resources:
     - namespaces
     - persistentvolumeclaims
     - persistentvolumes
     - configmaps
     verbs:
     - '*'
   - apiGroups:
     - compliance.openshift.io
     resources:
     - scansettingbindings
     verbs:
     - '*'
   - apiGroups:
     - '*'
     resources:
     - '*'
     verbs:
     - get
     - list
     - watch
   - nonResourceURLs:
     - '*'
     verbs:
     - get
     - list

   Copy to Clipboard Toggle word wrap

   작은 정보

   또는 OpenShift Container Platform 웹 콘솔을 사용하여 관리자 화면에서 확인할 수 있습니다. 사용자 관리 → 역할로 이동하여 필터 옵션을 사용하여 클러스터 전체 역할을 선택한 다음 집계된 클러스터 역할을 검색할 수 있습니다. 세부 정보 및 구성을 확인하려면 클러스터 역할을 열어야 합니다.