Argo CD 인스턴스

Red Hat OpenShift GitOps 1.9

Argo CD 인스턴스 설치 및 배포

Red Hat OpenShift Documentation Team

초록

이 문서에서는 클러스터 구성을 관리하거나 애플리케이션을 배포하기 위해 Argo CD 인스턴스를 설치 및 배포하는 방법을 설명합니다.

1장. Argo CD 인스턴스 설정
링크 복사

기본적으로 Red Hat OpenShift GitOps는 특정 클러스터 범위 리소스를 관리하기 위한 추가 권한으로 openshift-gitops 네임스페이스에 Argo CD 인스턴스를 설치합니다. 클러스터 구성을 관리하거나 애플리케이션을 배포하려면 새 Argo CD 인스턴스를 설치하고 배포할 수 있습니다. 기본적으로 모든 새 인스턴스에는 배포된 네임스페이스에서만 리소스를 관리할 수 있는 권한이 있습니다.

1.1. Argo CD 인스턴스 설치
링크 복사

클러스터 구성을 관리하거나 애플리케이션을 배포하려면 새 Argo CD 인스턴스를 설치하고 배포할 수 있습니다.

프로세스

OpenShift Container Platform 웹 콘솔에 로그인합니다.
Operators → 설치된 Operators를 클릭합니다.
프로젝트 드롭다운 메뉴에서 Argo CD 인스턴스를 설치할 프로젝트를 생성하거나 선택합니다.
1. 인스턴스 의 이름을 입력합니다.
2. Argo CD 서버에 액세스할 외부 OS 경로를 생성합니다. 서버 → 경로를 클릭하고 활성화 되었는지 확인합니다.

1.2. Argo CD 서버 및 리포지토리 서버의 복제본 활성화
링크 복사

Argo CD-server 및 Argo CD-repo-server 워크로드는 상태 비저장입니다. Pod 간에 워크로드를 더 잘 배포하기 위해 Argo CD-server 및 Argo CD-repo-server 복제본의 수를 늘릴 수 있습니다. 그러나 Argo CD-server에서 수평 자동 스케일러가 활성화된 경우 설정한 복제본 수를 덮어씁니다.

프로세스

리포지토리 및 서버 사양의 replicas 매개변수를 실행할 복제본 수로 설정합니다.

Argo CD 사용자 정의 리소스의 예

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: repo
spec:
  repo:
    replicas: <number_of_replicas>
  server:
    replicas: <number_of_replicas>
    route:
      enabled: true
      path: /
      tls:
        insecureEdgeTerminationPolicy: Redirect
        termination: passthrough
      wildcardPolicy: None

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: repo
spec:
  repo:
    replicas: <number_of_replicas>
  server:
    replicas: <number_of_replicas>
    route:
      enabled: true
      path: /
      tls:
        insecureEdgeTerminationPolicy: Redirect
        termination: passthrough
      wildcardPolicy: None

Copy to Clipboard

Toggle word wrap

1.3. 다른 네임스페이스에 리소스 배포
링크 복사

Argo CD가 설치된 위치와 다른 네임스페이스의 리소스를 관리할 수 있도록 하려면 argocd.argoproj.io/managed-by 라벨을 사용하여 대상 네임스페이스를 구성합니다.

프로세스

네임스페이스를 구성합니다.

oc label namespace <namespace> \
argocd.argoproj.io/managed-by=<namespace>

$ oc label namespace <namespace> \
argocd.argoproj.io/managed-by=<namespace>

Copy to Clipboard

Toggle word wrap

1: Argo CD가 설치된 네임스페이스입니다.

1.4. Argo CD 콘솔 링크 사용자 정의
링크 복사

멀티 테넌트 클러스터에서는 사용자가 Argo CD의 여러 인스턴스를 처리해야 할 수 있습니다. 예를 들어 네임스페이스에 Argo CD 인스턴스를 설치한 후 콘솔 애플리케이션 시작기에서 자체 Argo CD 인스턴스 대신 Argo CD 콘솔 링크에 연결된 다른 Argo CD 인스턴스를 찾을 수 있습니다.

DISABLE_DEFAULT_ARGOCD_CONSOLELINK 환경 변수를 설정하여 Argo CD 콘솔 링크를 사용자 지정할 수 있습니다.

DISABLE_DEFAULT_ARGOCD_CONSOLELINK 를 true 로 설정하면 Argo CD 콘솔 링크가 영구적으로 삭제됩니다.
DISABLE_DEFAULT_ARGOCD_CONSOLELINK 를 false 로 설정하거나 기본값을 사용하면 Argo CD 콘솔 링크가 일시적으로 삭제되고 Argo CD 경로가 조정되면 다시 표시됩니다.

사전 요구 사항

관리자로 OpenShift Container Platform 클러스터에 로그인했습니다.
Red Hat OpenShift GitOps Operator가 설치되었습니다.

프로세스

관리자 관점에서 Administration → CustomResourceDefinitions 로 이동합니다.
Subscription CRD를 찾아 클릭하여 엽니다.
Instances 탭을 선택하고 openshift-gitops-operator 서브스크립션을 클릭합니다.

YAML 탭을 선택하고 사용자 지정을 만듭니다.

Argo CD 콘솔 링크를 활성화하거나 비활성화하려면 필요에 따라 DISABLE_DEFAULT_ARGOCD_CONSOLELINK 값을 편집합니다.

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: openshift-gitops-operator
spec:
  config:
    env:
    - name: DISABLE_DEFAULT_ARGOCD_CONSOLELINK
      value: 'true'

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: openshift-gitops-operator
spec:
  config:
    env:
    - name: DISABLE_DEFAULT_ARGOCD_CONSOLELINK
      value: 'true'

Copy to Clipboard

Toggle word wrap

2장. Argo CD 사용자 정의 리소스 및 구성 요소 속성
링크 복사

ArgoCD 사용자 정의 리소스는 Argo CD 클러스터를 구성하는 구성 요소를 구성할 수 있는 지정된 Argo CD 클러스터에 대해 원하는 상태를 설명하는 CRD(Kubernetes Custom Resource)입니다.

2.1. Argo CD CLI 툴
링크 복사

Argo CD CLI 툴은 명령줄을 통해 Argo CD를 구성하는 데 사용되는 툴입니다. Red Hat OpenShift GitOps는 이 바이너리를 지원하지 않습니다. OpenShift 콘솔을 사용하여 Argo CD를 구성합니다.

2.2. Argo CD 사용자 정의 리소스 속성
링크 복사

Argo CD 사용자 정의 리소스는 다음 속성으로 구성됩니다.

Expand

이름	설명	Default	속성
`applicationInstanceLabelKey`	Argo CD가 앱 이름을 추적 레이블로 삽입하는 `metadata.label` 키 이름입니다.	`app.kubernetes.io/instance`
`applicationSet`		`<object>`	이렇게 하면 `ARGOCD_APPLICATIONSET_IMAGE` 환경 변수가 재정의됩니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. 유효한 옵션은 `text` 또는 `json` 입니다.
`configManagementPlugins`	구성 관리 플러그인을 추가합니다.	`<empty>`
	Argo CD 애플리케이션 컨트롤러 옵션.	`<object>`	유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. 이 속성은 컨트롤러 구성 요소의 메모리 부족을 완화하기 위해 많은 수의 클러스터를 관리하는 데 사용됩니다.
`disableAdmin`	기본 제공 admin 사용자를 비활성화합니다.	`false`
`gaTrackingID`	Google Analytics 추적 ID를 사용합니다.	`<empty>`
`gaAnonymizeUsers`	Google 분석으로 전송된 해시된 사용자 이름을 활성화합니다.	`false`
`ha`	높은 가용성 옵션.	`<object>`	이렇게 하면 `ARGOCD_REDIS_HA_PROXY_IMAGE` 환경 변수가 재정의됩니다.
`helpChatURL`		`https://mycorp.slack.com/argo-cd`
`helpChatText`	채팅 도움말을 가져오기 위해 텍스트 상자에 표시되는 텍스트입니다.	`지금 채팅!`
`image`	모든 Argo CD 구성 요소의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_IMAGE` 환경 변수가 재정의됩니다.	`argoproj/argocd`
	인그레스 구성 옵션.	`<object>`
`initialRepositories`	클러스터 생성 시 사용할 Argo CD를 구성하는 초기 Git 리포지토리입니다.	`<empty>`
	알림 컨트롤러 구성 옵션.	`<object>`	이렇게 하면 `ARGOCD_IMAGE` 환경 변수가 재정의됩니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다.
`repositoryCredentials`	클러스터 생성 시 사용할 Argo CD를 구성하기 위한 Git 리포지토리 인증 정보 템플릿입니다.	`<empty>`
`initialSSHKnownHosts`	Argo CD의 초기 SSH 알려진 호스트는 클러스터 생성 시 사용할 수 있습니다.	`<default_Argo_CD_Known_Hosts>`
`kustomizeBuildOptions`	`kustomize 빌드와 함께 사용할 빌드` 옵션 및 매개변수입니다.	`<empty>`
`oidcConfig`	OIDC 구성의 대안으로 Dex입니다.	`<empty>`
`nodePlacement`	`nodeSelector` 및 `허용 오차` 를 추가합니다.	`<empty>`
`prometheus`	Prometheus 구성 옵션.	`<object>`
`rbac`	RBAC 구성 옵션.	`<object>`	사용자 정의 RBAC 정책 및 역할 정의가 포함된 CSV 데이터입니다.
	Redis 구성 옵션.	`<object>`	이렇게 하면 `ARGOCD_REDIS_IMAGE` 환경 변수가 재정의됩니다.
`resourceCustomizations`	리소스 동작을 사용자 정의합니다.	`<empty>`
`resourceExclusions`	리소스 그룹의 전체 클래스를 완전히 무시합니다.	`<empty>`
`resourceInclusions`	적용되는 리소스 그룹/종류를 구성할 구성입니다.	`<empty>`
`server`	Argo CD 서버 구성 옵션.	`<object>`	`0` 보다 크거나 같아야 합니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. 유효한 옵션은 `text` 또는 `json` 입니다.
`sso`	Single Sign-On 옵션	`<object>`	이렇게 하면 `ARGOCD_KEYCLOAK_IMAGE` 환경 변수가 재정의됩니다. 현재 지원되는 옵션은 Dex 및 Keycloak입니다.
`statusBadgeEnabled`	애플리케이션 상태 배지를 활성화합니다.	`true`
`tls`	TLS 구성 옵션.	`<object>`
`userAnonyousEnabled`	익명 사용자 액세스를 활성화합니다.	`true`
`version`	모든 Argo CD 구성 요소에 대해 컨테이너 이미지와 함께 사용할 태그입니다.	최신 Argo CD 버전
	UI 배너 메시지를 추가합니다.	`<object>`

2.3. 리포지토리 서버 속성
링크 복사

다음 속성은 Repo 서버 구성 요소를 구성하는 데 사용할 수 있습니다.

Expand

이름	Default	설명
`resources`	`<empty>`	컨테이너 컴퓨팅 리소스입니다.
	`false`
	`""`
	`false`
	`""`
`image`	`argoproj/argocd`	Argo CD Repo 서버의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_REPOSERVER_IMAGE` 환경 변수가 재정의됩니다.
`version`	`.spec.Version`과 동일합니다.	Argo CD Repo 서버와 함께 사용할 태그입니다.
`logLevel`	`info`	Argo CD Repo 서버에서 사용하는 로그 수준입니다.
`logFormat`	`text`	Argo CD Repo 서버에서 사용할 로그 형식입니다.
`execTimeout`	`180`
`env`	`<empty>`	리포지토리 서버 워크로드에 대해 설정할 환경입니다.
`replicas`	`<empty>`	Argo CD Repo 서버의 복제본 수입니다. `0` 보다 크거나 같아야 합니다.

2.4. Argo CD 인스턴스로 알림 활성화
링크 복사

사전 요구 사항

프로세스

Operator → 설치된 Operator 페이지로 이동합니다.

예

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: openshift-gitops
spec:
  notifications:
    enabled: true
#....

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: openshift-gitops
spec:
  notifications:
    enabled: true
#....

Copy to Clipboard

Toggle word wrap

저장을 클릭합니다.

작은 정보

예를 들면 다음과 같습니다.

oc patch argocd openshift-gitops -n openshift-gitops --type merge --patch '{"spec": {"notifications": {"enabled": true}}}'

oc patch argocd openshift-gitops -n openshift-gitops --type merge --patch '{"spec": {"notifications": {"enabled": true}}}'

Copy to Clipboard

Toggle word wrap

법적 공지
링크 복사

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Argo CD 인스턴스