GitOps 설치

프로세스

1. 웹 콘솔의 관리자 화면을 열고 Operator → OperatorHub 로 이동합니다.
2. OpenShift GitOps 를 검색하고 Red Hat OpenShift GitOps 타일을 클릭한 다음 설치를 클릭합니다.

3. Operator 설치 페이지에서 다음을 수행합니다.

   1. 업데이트 채널을 선택합니다.
   2. 설치할 GitOps 버전을 선택합니다.

   3. 설치된 네임스페이스를 선택합니다. 기본 설치 네임스페이스는 openshift-gitops-operator 입니다.

      참고

      GitOps 버전 1.10 이상의 경우 기본 네임스페이스가 openshift-operators 에서 openshift-gitops Operator 로 변경되었습니다.

   4. 이 네임스페이스에서 Operator 권장 클러스터 모니터링 활성화 확인란을 선택하여 클러스터 모니터링을 활성화합니다.

      참고

      openshift.io/cluster-monitoring=true 라벨을 적용하여 모든 네임스페이스에서 클러스터 모니터링을 활성화할 수 있습니다.

      $ oc label namespace <namespace> openshift.io/cluster-monitoring=true

      Copy to Clipboard Toggle word wrap

      출력 예

      namespace/<namespace> labeled

      Copy to Clipboard Toggle word wrap

4. OpenShift Container Platform 클러스터에서 GitOps Operator를 사용할 수 있도록 설치를 클릭합니다.

   Red Hat OpenShift GitOps는 클러스터의 모든 네임스페이스에 설치됩니다.

5. Red Hat OpenShift GitOps Operator가 Operator → 설치된 Operator 에 나열되어 있는지 확인합니다. 상태가 성공으로 확인되어야 합니다.

프로세스

1. openshift-gitops-operator 네임스페이스를 생성합니다.

   $ oc create ns openshift-gitops-operator

   Copy to Clipboard Toggle word wrap

   출력 예

   namespace/openshift-gitops-operator created

   Copy to Clipboard Toggle word wrap

   참고

   openshift.io/cluster-monitoring=true 라벨을 적용하여 openshift-gitops-operator 또는 네임스페이스에서 클러스터 모니터링을 활성화할 수 있습니다.

   $ oc label namespace <namespace> openshift.io/cluster-monitoring=true

   Copy to Clipboard Toggle word wrap

   출력 예

   namespace/<namespace> labeled

   Copy to Clipboard Toggle word wrap

2. OperatorGroup 오브젝트 YAML 파일을 생성합니다(예: gitops-operator-group.yaml ):

   OperatorGroup의 예

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-gitops-operator
   spec:
     upgradeStrategy: Default

   Copy to Clipboard Toggle word wrap

3. 클러스터에 OperatorGroup 을 적용합니다.

   $ oc apply -f gitops-operator-group.yaml

   Copy to Clipboard Toggle word wrap

   출력 예

   operatorgroup.operators.coreos.com/openshift-gitops-operator created

   Copy to Clipboard Toggle word wrap

4. 서브스크립션 오브젝트 YAML 파일을 생성하여 Red Hat OpenShift GitOps Operator에 네임스페이스를 서브스크립션합니다(예: openshift-gitops-sub.yaml ).

   서브스크립션의 예

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-gitops-operator
   spec:
     channel: latest 

   1

   
     installPlanApproval: Automatic
     name: openshift-gitops-operator 

   2

   
     source: redhat-operators 

   3

   
     sourceNamespace: openshift-marketplace 

   4

   Copy to Clipboard Toggle word wrap

   1

   Operator를 서브스크립션할 채널 이름을 지정합니다.

   2

   등록할 Operator의 이름을 지정합니다.

   3

   Operator를 제공하는 CatalogSource의 이름을 지정합니다.

   4

   CatalogSource의 네임스페이스입니다. 기본 OperatorHub CatalogSources에는 openshift-marketplace를 사용합니다.

5. 클러스터에 서브스크립션 을 적용합니다.

   $ oc apply -f openshift-gitops-sub.yaml

   Copy to Clipboard Toggle word wrap

   출력 예

   subscription.operators.coreos.com/openshift-gitops-operator created

   Copy to Clipboard Toggle word wrap

6. 설치가 완료되면 openshift-gitops 네임스페이스의 모든 Pod가 실행 중인지 확인합니다.

   $ oc get pods -n openshift-gitops

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                                      	  READY   STATUS    RESTARTS   AGE
   cluster-785cfc5f75-669wq                                      1/1     Running   0          76s
   gitops-plugin-6664c749dd-dx64s                                1/1     Running   0          76s
   openshift-gitops-application-controller-0                     1/1     Running   0          74s
   openshift-gitops-applicationset-controller-549d7f6686-wzckt   1/1     Running   0          74s
   openshift-gitops-dex-server-5d4ffdb9b9-lb7b7                  1/1     Running   0          74s
   openshift-gitops-redis-6d65c94d4b-k9l8k                       1/1     Running   0          75s
   openshift-gitops-repo-server-79db854c58-279jr                 1/1     Running   0          75s
   openshift-gitops-server-f488b848-xntbc                        1/1     Running   0          75s

   Copy to Clipboard Toggle word wrap

7. openshift-gitops-operator 네임스페이스의 Pod가 실행 중인지 확인합니다.

   $ oc get pods -n openshift-gitops-operator

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                                            READY   STATUS    RESTARTS   AGE
   openshift-gitops-operator-controller-manager-6fdc5cd9dc-jr9mn   2/2     Running   0          41s

   Copy to Clipboard Toggle word wrap

프로세스

1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator로 이동하여 Red Hat OpenShift GitOps Operator가 설치되어 있는지 확인합니다.
2. 메뉴 → OpenShift GitOps → 클러스터 Argo CD 로 이동합니다. Argo CD UI의 로그인 페이지가 새 창에 표시됩니다.

3. 선택 사항: OpenShift Container Platform 인증 정보로 로그인하려면 cluster-admins 그룹의 사용자인지 확인한 다음 Argo CD 사용자 인터페이스에서 LOG IN VIA OPENSHIFT 옵션을 선택해야 합니다.

   참고

   cluster-admins 그룹의 사용자가 되려면 oc adm groups new cluster-admins <user > 명령을 사용합니다. 여기서 < user >는 클러스터 전체 또는 로컬로 사용자 및 그룹에 바인딩할 수 있는 기본 클러스터 역할입니다.

4. Argo CD 인스턴스의 암호를 가져옵니다.

   1. 탐색 패널을 사용하여 워크로드 → 시크릿 페이지로 이동합니다.
   2. 프로젝트 드롭다운 목록을 사용하고 Argo CD 인스턴스가 생성된 네임스페이스를 선택합니다.
   3. 암호를 표시할 <argo_CD_instance_name>-cluster 인스턴스를 선택합니다.
   4. 세부 정보 탭에서 데이터 → admin.password 아래에 암호를 복사합니다.
5. admin 을 Username 으로 사용하고 복사한 암호를 Password 로 사용하여 새 창에서 Argo CD UI에 로그인합니다.

프로세스

1. 운영 체제 및 아키텍처의 콘텐츠 게이트웨이 에서 최신 버전의 CLI 툴을 다운로드합니다.

   Expand

   운영 체제	아키텍처	Tarball
   Linux	x86_64, amd64	argocd-linux-amd64.tar.gz
   Linux on IBM zSystems and IBM® LinuxONE	s390x	argocd-linux-s390x.tar.gz
   Linux on IBM Power	ppc64le	argocd-linux-ppc64le.tar.gz
   Linux on ARM	aarch64, arm64	argocd-linux-arm64.tar.gz

   Show more
   참고

   최신 버전의 CLI 툴은 이전 버전의 Red Hat OpenShift GitOps 서버와 호환되지만 그 반대는 아닙니다.

2. 다음 명령을 실행하여 아카이브의 압축을 풉니다.

   $ tar xvzf <file>

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

   $ sudo mv argocd /usr/local/bin/argocd

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 파일을 실행 가능하게 만듭니다.

   $ sudo chmod +x /usr/local/bin/argocd

   Copy to Clipboard Toggle word wrap

5. GitOps argocd CLI를 설치한 후 다음 명령을 실행하여 사용할 수 있는지 확인합니다.

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   출력 예

   argocd: v2.9.5+f943664
     BuildDate: 2024-02-15T05:19:27Z
     GitCommit: f9436641a616d277ab1f98694e5ce4c986d4ea05
     GitTreeState: clean
     GoVersion: go1.20.10
     Compiler: gc
     Platform: linux/amd64
     ExtraBuildInfo: openshift-gitops-version: 1.12.0, release: 0015022024 

   1

   Copy to Clipboard Toggle word wrap

   1

   Red Hat에서 빌드한 Red Hat OpenShift GitOps의 빌드 정보입니다.

프로세스

1. 다음 명령을 실행하여 Red Hat Subscription Manager에 등록합니다.

   # subscription-manager register

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 최신 서브스크립션 데이터를 가져옵니다.

   # subscription-manager refresh

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 사용 가능한 서브스크립션을 나열합니다.

   # subscription-manager list --available --matches '*gitops*'

   Copy to Clipboard Toggle word wrap

4. 이전 명령의 출력에서 OpenShift Container Platform 서브스크립션의 풀 ID를 찾고 다음 명령을 실행하여 서브스크립션을 등록된 시스템에 연결합니다.

   # subscription-manager attach --pool=<pool_id>

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 RHEL 버전 8 이상용 Red Hat OpenShift GitOps에 필요한 리포지토리를 활성화합니다.

   • Linux (x86_64, amd64)

     # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-x86_64-rpms"

     Copy to Clipboard Toggle word wrap

     명령 예

     # subscription-manager repos --enable="gitops-1.17-for-rhel-8-x86_64-rpms"

     Copy to Clipboard Toggle word wrap

   • Linux on IBM zSystems and IBM® LinuxONE (s390x)

     # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-s390x-rpms"

     Copy to Clipboard Toggle word wrap

     명령 예

     # subscription-manager repos --enable="gitops-1.17-for-rhel-8-s390x-rpms"

     Copy to Clipboard Toggle word wrap

   • Linux on IBM Power (ppc64le)

     # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-ppc64le-rpms"

     Copy to Clipboard Toggle word wrap

     명령 예

     # subscription-manager repos --enable="gitops-1.17-for-rhel-8-ppc64le-rpms"

     Copy to Clipboard Toggle word wrap

   • Linux on ARM (aarch64, arm64)

     # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-aarch64-rpms"

     Copy to Clipboard Toggle word wrap

     명령 예

     # subscription-manager repos --enable="gitops-1.17-for-rhel-8-aarch64-rpms"

     Copy to Clipboard Toggle word wrap

6. 다음 명령을 실행하여 openshift-gitops-argocd-cli 패키지를 설치합니다.

   # yum install openshift-gitops-argocd-cli

   Copy to Clipboard Toggle word wrap

7. GitOps argocd CLI를 설치한 후 다음 명령을 실행하여 사용할 수 있는지 확인합니다.

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   출력 예

   argocd: v2.9.5+f943664
     BuildDate: 2024-02-15T05:19:27Z
     GitCommit: f9436641a616d277ab1f98694e5ce4c986d4ea05
     GitTreeState: clean
     GoVersion: go1.20.10
     Compiler: gc
     Platform: linux/amd64
     ExtraBuildInfo: openshift-gitops-version: 1.12.0, release: 0015022024 

   1

   Copy to Clipboard Toggle word wrap

   1

   Red Hat에서 빌드한 Red Hat OpenShift GitOps의 빌드 정보입니다.

프로세스

1. 운영 체제 및 아키텍처의 콘텐츠 게이트웨이 에서 최신 버전의 CLI 툴을 다운로드합니다.

   Expand

   운영 체제	아키텍처	Tarball
   Windows	x86_64	argocd-windows-amd64.zip

   Show more
   참고

   최신 버전의 CLI 툴은 이전 버전의 Red Hat OpenShift GitOps 서버와 호환되지만 그 반대는 아닙니다.

2. ZIP 프로그램으로 아카이브의 압축을 풉니다.

3. 다음 명령을 실행하여 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

   C:\> move argocd.exe <directory>

   Copy to Clipboard Toggle word wrap

4. GitOps argocd CLI를 설치한 후 다음 명령을 실행하여 사용할 수 있는지 확인합니다.

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   출력 예

   argocd: v2.9.5+f943664
     BuildDate: 2024-02-15T05:19:27Z
     GitCommit: f9436641a616d277ab1f98694e5ce4c986d4ea05
     GitTreeState: clean
     GoVersion: go1.20.10
     Compiler: gc
     Platform: linux/amd64
     ExtraBuildInfo: openshift-gitops-version: 1.12.0, release: 0015022024 

   1

   Copy to Clipboard Toggle word wrap

   1

   Red Hat에서 빌드한 Red Hat OpenShift GitOps의 빌드 정보입니다.

프로세스

1. 운영 체제 및 아키텍처의 콘텐츠 게이트웨이 에서 최신 버전의 CLI 툴을 다운로드합니다.

   Expand

   운영 체제	아키텍처	Tarball
   Intel의 macOS	x86_64	argocd-macos-amd64.tar.gz
   macOS on ARM	arm64	argocd-macos-arm64.tar.gz

   Show more
   참고

   최신 버전의 CLI 툴은 이전 버전의 Red Hat OpenShift GitOps 서버와 호환되지만 그 반대는 아닙니다.

2. 다음 명령을 실행하여 아카이브의 압축을 풉니다.

   $ tar xvzf <file>

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 바이너리를 PATH 환경 변수의 디렉터리로 이동합니다.

   $ sudo mv argocd /usr/local/bin/argocd

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 파일을 실행 가능하게 만듭니다.

   $ sudo chmod +x /usr/local/bin/argocd

   Copy to Clipboard Toggle word wrap

5. GitOps argocd CLI를 설치한 후 다음 명령을 실행하여 사용할 수 있는지 확인합니다.

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   출력 예

   argocd: v2.9.5+f943664
     BuildDate: 2024-02-15T05:19:27Z
     GitCommit: f9436641a616d277ab1f98694e5ce4c986d4ea05
     GitTreeState: clean
     GoVersion: go1.20.10
     Compiler: gc
     Platform: linux/amd64
     ExtraBuildInfo: openshift-gitops-version: 1.12.0, release: 0015022024 

   1

   Copy to Clipboard Toggle word wrap

   1

   Red Hat에서 빌드한 Red Hat OpenShift GitOps의 빌드 정보입니다.