Argo CD 인스턴스

Red Hat OpenShift GitOps 1.8

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 인스턴스를 설치할 프로젝트를 생성하거나 선택합니다.
설치된 Operator 목록에서 OpenShift GitOps Operator 를 선택하고 Argo CD 탭을 클릭합니다.
ArgoCD 생성 을 클릭하여 매개변수를 구성합니다.
1. 인스턴스 의 이름을 입력합니다. 기본적으로 이름은 example 으로 설정됩니다.
2. Argo CD 서버에 액세스할 외부 OS 경로를 생성합니다. 서버 → 경로를 클릭하고 활성화 되었는지 확인합니다.
Argo CD 웹 UI를 열려면 Argo CD 인스턴스가 설치된 프로젝트에서 네트워킹 → 경로 → <instance name>-server 로 이동하여 경로를 클릭합니다.

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`	`ApplicationSet` 컨트롤러 구성 옵션	`<Object>`	&lt ; image> - `ApplicationSet` 컨트롤러의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_APPLICATIONSET_IMAGE` 환경 변수가 재정의됩니다. &lt ; version> - `ApplicationSet` 컨테이너 이미지와 함께 사용할 태그입니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. &lt ;loglevel> - Argo CD 애플리케이션 컨트롤러 구성 요소에서 사용하는 로그 수준입니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. < LogFormat > - Argo CD 애플리케이션 컨트롤러 구성 요소에서 사용하는 로그 형식입니다. 유효한 옵션은 `text` 또는 `json` 입니다. <PrallelismLimit > - 컨트롤러에 설정할 kubectl 병렬 처리 제한 `(--kubectl-parallelism-limit 플래그)` 입니다.
`ConfigManagementPlugins`	구성 관리 플러그인을 추가합니다.	`<empty>`
`컨트롤러`	Argo CD 애플리케이션 컨트롤러 옵션.	`<Object>`	<processors.Operation > - 작업 프로세서 수입니다. <processors.Status > - 상태 프로세서 수입니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. &lt ;loglevel> - Argo CD 애플리케이션 컨트롤러 구성 요소에서 사용하는 로그 수준입니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. <AppSync > - AppSync는 Argo CD 애플리케이션의 동기화 빈도를 제어하는 데 사용됩니다. <sharding.enabled > - Argo CD 애플리케이션 컨트롤러 구성 요소에서 샤딩을 활성화합니다. 이 속성은 컨트롤러 구성 요소의 메모리 부족을 완화하기 위해 많은 수의 클러스터를 관리하는 데 사용됩니다. <sharding.replicas > - Argo CD 애플리케이션 컨트롤러의 분할을 지원하는 데 사용할 복제본 수입니다. < env> - 애플리케이션 컨트롤러 워크로드에 설정할 환경입니다.
`DisableAdmin`	기본 제공 admin 사용자를 비활성화합니다.	`false`
`GATrackingID`	Google Analytics 추적 ID를 사용합니다.	`<empty>`
`GAAnonymizeusers`	Google 분석으로 전송된 해시된 사용자 이름을 활성화합니다.	`false`
`HA`	높은 가용성 옵션.	`<Object>`	<enabled > - Argo CD에 대해 전역적으로 고가용성 지원을 제공합니다. <RedisProxyImage > - Redis HAProxy 컨테이너 이미지. 이렇게 하면 `ARGOCD_REDIS_HA_PROXY_IMAGE` 환경 변수가 재정의됩니다. <RedisProxyVersion > - Redis HAProxy 컨테이너 이미지에 사용할 태그입니다.
`HelpChatURL`	채팅 도움말을 가져오기 위한 URL(일반적으로 지원을 위한 Slack 채널임).	`https://mycorp.slack.com/argo-cd`
`HelpChatText`	채팅 도움말을 가져오기 위해 텍스트 상자에 표시되는 텍스트입니다.	`지금 채팅!`
`Image`	모든 Argo CD 구성 요소의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_IMAGE` 환경 변수가 재정의됩니다.	`argoproj/argocd`
`Ingress`	인그레스 구성 옵션.	`<Object>`
`InitialRepositories`	클러스터 생성 시 사용할 Argo CD를 구성하는 초기 Git 리포지토리입니다.	`<empty>`
`알림`	알림 컨트롤러 구성 옵션.	`<Object>`	< enabled > - notifications-controller를 시작하기 위한 토글입니다. <image> - 모든 Argo CD 구성 요소의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_IMAGE` 환경 변수가 재정의됩니다. < version > - 알림 컨테이너 이미지와 함께 사용할 태그입니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. &lt ;loglevel> - Argo CD 애플리케이션 컨트롤러 구성 요소에서 사용하는 로그 수준입니다. 유효한 옵션은 `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>`	<enabled > - Argo CD에 대해 전역적으로 Prometheus를 지원합니다. < host > - Ingress 또는 Route 리소스에 사용할 호스트 이름입니다. & lt;Ingress > - Prometheus에 대한 집계 Ingress입니다. & lt;route > - 경로 구성 옵션입니다. < size > - Prometheus `StatefulSet` 의 복제본 수입니다.
`RBAC`	RBAC 구성 옵션.	`<Object>`	< DefaultPolicy > - `argocd-rbac-cm` 구성 맵의 `policy.default` 속성입니다. API 요청을 승인할 때 Argo CD가 다시 대체되는 기본 역할의 이름입니다. &lt ; policy> - `argocd-rbac-cm` 구성 맵의 `policy.csv` 속성입니다. 사용자 정의 RBAC 정책 및 역할 정의가 포함된 CSV 데이터입니다. < scopes > - `argocd-rbac-cm` 구성 맵의 scopes 속성입니다. RBAC 적용 중에 검사할 OIDC 범위(하위 범위에 추가)를 제어합니다.
`Redis`	Redis 구성 옵션.	`<Object>`	<AutoTLS > - 공급자를 사용하여 Redis 서버의 TLS 인증서( openshift 중 하나)를 생성합니다. 현재 OpenShift Container Platform에서만 사용할 수 있습니다. <DisableTLSVerification > - 엄격한 TLS 검증을 사용하여 Redis 서버에 액세스해야 하는지 여부를 정의합니다. &lt ;image > - Redis의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_REDIS_IMAGE` 환경 변수가 재정의됩니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. < version > - Redis 컨테이너 이미지와 함께 사용할 태그입니다.
`ResourceCustomizations`	리소스 동작을 사용자 정의합니다.	`<empty>`
`ResourceExclusions`	리소스 그룹의 전체 클래스를 완전히 무시합니다.	`<empty>`
`resourceInclusions`	적용되는 리소스 그룹/종류를 구성할 구성입니다.	`<empty>`
`서버`	Argo CD 서버 구성 옵션.	`<Object>`	& lt;autoscale& gt; - 서버 자동 스케일링 구성 옵션. <ExtraCommandArgs > - Operator가 설정한 기존 인수에 추가된 인수 목록입니다. <GRPC > - GRPC 구성 옵션 < host > - Ingress 또는 Route 리소스에 사용되는 호스트 이름입니다. <Ingress > - Argo CD 서버 구성 요소에 대한 Ingress 구성입니다. <insecure > - Argo CD 서버의 비보안 플래그를 집계합니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. &lt ; replicas> - Argo CD 서버의 복제본 수입니다. `0` 보다 크거나 같아야 합니다. `Autoscale` 이 활성화되면 `Replicas` 가 무시됩니다. & lt;route > - 경로 구성 옵션입니다. <service .Type > - 서비스 리소스에 사용되는 `ServiceType` 입니다. &lt ;loglevel> - Argo CD Server 구성 요소에서 사용할 로그 수준입니다. 유효한 옵션은 `debug`,`info`,`error`, `warn` 입니다. < LogFormat > - Argo CD 애플리케이션 컨트롤러 구성 요소에서 사용하는 로그 형식입니다. 유효한 옵션은 `text` 또는 `json` 입니다. < env> - 서버 워크로드에 설정할 환경입니다.
`SSO`	Single Sign-On 옵션	`<Object>`	&lt ; image> - Keycloak의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_KEYCLOAK_IMAGE` 환경 변수가 재정의됩니다. <Keycloak > - Keycloak SSO 공급자에 대한 구성 옵션입니다. <DEX& gt; - Dex SSO 공급자에 대한 구성 옵션입니다. <provider> - Single Sign-on을 구성하는 데 사용되는 공급자의 이름입니다. 현재 지원되는 옵션은 Dex 및 Keycloak입니다. < resources > - 컨테이너 컴퓨팅 리소스입니다. <VerifyTLS > - Keycloak 서비스와 통신할 때 엄격한 TLS 검사를 적용할지 여부입니다. &lt ; version> - Keycloak 컨테이너 이미지와 함께 사용할 태그입니다.
`StatusBadgeEnabled`	애플리케이션 상태 배지를 활성화합니다.	`true`
`TLS`	TLS 구성 옵션.	`<Object>`	<CA.ConfigMapName > - CA 인증서가 포함된 `ConfigMap` 의 이름입니다. < CA.SecretName > - CA 인증서 및 키가 포함된 시크릿의 이름입니다. <InitialCerts > - HTTPS를 통해 Git 리포지토리를 연결하기 위한 `argocd-tls-certs-cm` 구성 맵의 초기 인증서 세트입니다.
`UserAnonyousEnabled`	익명 사용자 액세스를 활성화합니다.	`true`
`버전`	모든 Argo CD 구성 요소에 대해 컨테이너 이미지와 함께 사용할 태그입니다.	최신 Argo CD 버전
`배너`	UI 배너 메시지를 추가합니다.	`<Object>`	<banner .Content > - 배너 메시지 콘텐츠( banner가 표시되는 경우 필수)입니다. <banner.URL.SecretName > - 배너 메시지 링크 URL(선택 사항)입니다.

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

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

Expand

이름	Default	설명
`Resources`	`<empty>`	컨테이너 컴퓨팅 리소스입니다.
`mountSAToken`	`false`	`ServiceAccount` 토큰을 repo-server 포드에 마운트해야 하는지 여부입니다.
`ServiceAccount`	`""`	repo-server Pod와 함께 사용할 `ServiceAccount` 의 이름입니다.
`VerifyTLS`	`false`	리포지토리 서버와 통신할 때 모든 구성 요소에서 엄격한 TLS 검사를 적용할지 여부입니다.
`AutoTLS`	`""`	리포지토리 서버의 gRPC TLS 인증서( openshift 중 하나)를 TLS로 설정하는 데 사용할 공급자입니다. 현재 OpenShift에서만 사용할 수 있습니다.
`Image`	`argoproj/argocd`	Argo CD Repo 서버의 컨테이너 이미지입니다. 이렇게 하면 `ARGOCD_REPOSERVER_IMAGE` 환경 변수가 재정의됩니다.
`버전`	`.spec.Version`과 동일합니다.	Argo CD Repo 서버와 함께 사용할 태그입니다.
`LogLevel`	`info`	Argo CD Repo 서버에서 사용하는 로그 수준입니다. 유효한 옵션은 debug, info, error, warn입니다.
`LogFormat`	`text`	Argo CD Repo 서버에서 사용할 로그 형식입니다. 유효한 옵션은 text 또는 json입니다.
`ExecTimeout`	`180`	툴을 렌더링하기 위한 실행 제한 시간(예: Helm, Kustomize)입니다.
`env`	`<empty>`	리포지토리 서버 워크로드에 대해 설정할 환경입니다.
`replicas`	`<empty>`	Argo CD Repo 서버의 복제본 수입니다. `0` 보다 크거나 같아야 합니다.

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

Argo CD 알림 컨트롤러를 활성화하거나 비활성화하려면 Argo CD 사용자 정의 리소스에서 매개변수를 설정합니다. 기본적으로 알림은 비활성화되어 있습니다. 알림을 활성화하려면 .yaml 파일에서 enabled 매개변수를 true 로 설정합니다.

프로세스

enabled 매개변수를 true 로 설정합니다.

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: example-argocd
spec:
  notifications:
    enabled: true

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: example-argocd
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 인스턴스