Argo CD Overview
애플리케이션 정의, 구성 및 환경은 선언적이고 버전이 제어되어야 합니다. 애플리케이션 배포 및 수명 주기 관리는 자동화되고 감사 가능하며 이해하기 쉬워야 합니다.Argo CD 는 원하는 애플리케이션 상태를 정의하기 위한 정보 소스로 Git 리포지토리를 사용 하는 GitOps 패턴을 따릅니다. Kubernetes 매니페스트는 여러 가지 방법으로 지정할 수 있습니다.
Plain directory of YAML/json manifests
구성 관리 플러그인으로 구성된 모든 맞춤형 구성 관리 도구
Argo CD는 지정된 대상 환경에서 원하는 애플리케이션 상태의 배포를 자동화합니다. 애플리케이션 배포는 분기, 태그에 대한 업데이트를 추적하거나 Git 커밋에서 매니페스트의 특정 버전에 고정할 수 있습니다.
Argo CD는 아래와 같은 아키텍쳐로 구성됩니다.
Argo CD는 실행 중인 애플리케이션을 지속적으로 모니터링하고 현재 원하는 대상 상태(Git 저장소에 지정된 대로)와 비교하는 kubernetes 컨트롤러와 같은 형태로 구현됩니다. Argo CD는 라이브 상태를 원하는 대상 상태로 다시 자동 또는 수동으로 동기화하는 기능을 제공하면서 , 현재 상태와 원하는 상태의 차이점을 리포팅하고 시각화합니다. Git 리포지토리에서 원하는 대상 상태에 대한 모든 수정 사항은 지정된 대상 환경에 자동으로 적용되고 반영될 수 있습니다.
Argo CD는 3가지 컴포넌트 로 구성되어 있습니다.
현재 라이브 상태를 원하는 대상 상태(Git 저장소에 지정된 대로)와 주기적으로 비교
라이브 상태가 대상 상태와 다른 배포된 애플리케이션은 OutOfSync 로 처리
라이브 상태를 원하는 대상 상태로 자동 또는 수동으로 다시 동기화 하는 기능을 제공
API Server
API 서버는 Web UI, CLI 및 외부에서 사용할 수 있도록 gRPC와 REST API를 제공
Repository Server
Application manifest 파일을 가지고 있는 Git 저장소의 로컬 캐시를 유지 관리
Git 저장소에 저장된 manifest 파일을 생성하는 역할
Application Controller
애플리케이션 컨트롤러는 실행중인 응용 프로그램을 지속적으로 모니터링
live state와 target state를 비교해서 UI로 리포팅 (OutOfSync)
Argo CD 설치
1.Argo CD 설치
Argo 프로젝트에서 제공하는 매니페스트를 사용하여 설치를 합니다.
Copy #namespace - argocd
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v2.4.7/manifests/install.yaml
2.Argo CD CLI 설치
Argo CD CLI를 설치합니다. API 서버와 Interactive하게 운영하려면 CLI를 배포해야 합니다.
Copy sudo curl --silent --location -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/download/v2.4.7/argocd-linux-amd64
sudo chmod 755 /usr/local/bin/argocd
ArgoCD 구성
Argo CD가 배포되었으므로 이제 argocd-server를 구성한 다음 로그인해야 합니다.
3.Argo CD Expose
기본적으로 argocd-server는 외부에 노출되지 않습니다. 여기에서는 편의상 로드 밸런서를 사용하여 외부에 노출 시킵니다. LoadBalancer가 생성될 때까지 2~3분 정도 소요됩니다.
Copy kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "LoadBalancer"}}'
아래 명령을 통해서 Argo CD 서버의 주소를 변수에 저장해 둡니다.
Copy export ARGOCD_SERVER=`kubectl get svc argocd-server -n argocd -o json | jq --raw-output '.status.loadBalancer.ingress[0].hostname'`
echo $ARGOCD_SERVER
4.Argo CD 로그인
초기 로그인 암호는 ArgoCD API 서버의 포드 이름으로 자동 생성됩니다.
Copy export ARGO_PWD=`kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d`
echo $ARGO_PWD
Admin이 로그인 id 이고, 자동 생성된 암호를 이용해서 로그인 합니다.
Copy argocd login $ARGOCD_SERVER --username admin --password $ARGO_PWD --insecure
아래와 같이 정상적으로 콘솔에서 로그인 된 것을 확인합니다.
Copy $ argocd login $ARGOCD_SERVER --username admin --password $ARGO_PWD --insecure
'admin:login' logged in successfully
Context 'a81830f78562145b3bca329b3a7699cb-1011047444.ap-northeast-2.elb.amazonaws.com' updated
Application 배포
이제 ArgoCD가 완전히 배포되었으므로 , 간단한 애플리케이션(ecsdemo-nodejs)을 배포할 것입니다.
4.Application Fork
아래 Repo에서 사용자의 Github으로 Application Fork를 수행합니다.
Copy https://github.com/brentley/ecsdemo-nodejs.git 사용자의 Github에 Fork된 Repo로 이동하고, Repo를 복사해 둡니다.
복사한 URL은 아래와 같은 형식입니다.
Copy https://github.com/{github-userid}/ecsdemo-nodejs.git 이 URL은 Application을 ArgoCD로 구성할 때 필요합니다.
5.Application 생성
클러스터 컨텍스트를 사용하여 ArgoCD CLI와 연결합니다.
Copy CONTEXT_NAME=`kubectl config view -o jsonpath='{.current-context}'`
argocd cluster add $CONTEXT_NAME
아래와 같이 출력됩니다.
Copy $ argocd cluster add $CONTEXT_NAME
WARNING: This will create a service account `argocd-manager` on the cluster referenced by context `i-0fd091734070b9f6f@eksworkshop.ap-northeast-2.eksctl.io` with full cluster level privileges. Do you want to continue [y/N]? y
INFO[0003] ServiceAccount "argocd-manager" created in namespace "kube-system"
INFO[0003] ClusterRole "argocd-manager-role" created
INFO[0003] ClusterRoleBinding "argocd-manager-role-binding" created
Cluster 'https://095783B7DF46A1EA53103B1201579207.gr7.ap-northeast-2.eks.amazonaws.com' added 애플리케이션을 구성하고 사용자의 Fork에 연결합니다.
Copy kubectl create namespace ecsdemo-nodejs
argocd app create ecsdemo-nodejs --repo https://github.com/{GITHUB_USERNAME}/ecsdemo-nodejs.git --path kubernetes --dest-server https://kubernetes.default.svc --dest-namespace ecsdemo-nodejs
이제 애플리케이션이 설정되었으므로 배포된 애플리케이션 상태를 argo cd cli로 확인합니다.
Copy argocd app get ecsdemo-nodejs
아래와 같이 출력됩니다.
Copy $ argocd app get ecsdemo-nodejs
Name: ecsdemo-nodejs
Project: default
Server: https://kubernetes.default.svc
Namespace: ecsdemo-nodejs
URL: https://a81830f78562145b3bca329b3a7699cb-1011047444.ap-northeast-2.elb.amazonaws.com/applications/ecsdemo-nodejs
Repo: https://github.com/whchoi98/ecsdemo-nodejs.git
Target:
Path: kubernetes
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: OutOfSync from (c63f795)
Health Status: Missing
GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
Service ecsdemo-nodejs ecsdemo-nodejs OutOfSync Missing
apps Deployment default ecsdemo-nodejs OutOfSync Missing
UI에서도 동일한 값을 확인 할 수 있습니다.
애플리케이션이 아직 배포되지 않았기 때문에 애플리케이션이 OutOfSync 상태에 있음을 알 수 있습니다. 이제 애플리케이션을 동기화합니다.
Copy argocd app sync ecsdemo-nodejs
2~3분 이후 Synced 된 상태와 Heathy 상태로 전환된 것을 확인 할 수 있습니다.
operation 과 Health Status 를 확인해 봅니다.
Copy $ argocd app sync ecsdemo-nodejs
TIMESTAMP GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
2024-04-10T17:14:46+00:00 Service ecsdemo-nodejs ecsdemo-nodejs Synced Healthy
2024-04-10T17:14:46+00:00 apps Deployment default ecsdemo-nodejs Synced Healthy
2024-04-10T17:14:46+00:00 Service ecsdemo-nodejs ecsdemo-nodejs Synced Healthy service/ecsdemo-nodejs unchanged
2024-04-10T17:14:46+00:00 apps Deployment default ecsdemo-nodejs Synced Healthy deployment.apps/ecsdemo-nodejs unchanged
Name: ecsdemo-nodejs
Project: default
Server: https://kubernetes.default.svc
Namespace: ecsdemo-nodejs
URL: https://a789961eb82e34825a3b66ee39dee3d5-1295411879.ap-northeast-2.elb.amazonaws.com/applications/ecsdemo-nodejs
Repo: https://github.com/whchoi98/ecsdemo-nodejs.git
Target:
Path: kubernetes
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: Synced to (95cad14)
Health Status: Healthy
Operation: Sync
Sync Revision: 95cad1467942af867234f3b7f8d4bc0140fbf67a
Phase: Succeeded
Start: 2024-04-10 17:14:46 +0000 UTC
Finished: 2024-04-10 17:14:46 +0000 UTC
Duration: 0s
Message: successfully synced (all tasks run)
GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
Service ecsdemo-nodejs ecsdemo-nodejs Synced Healthy service/ecsdemo-nodejs unchanged
apps Deployment default ecsdemo-nodejs Synced Healthy deployment.apps/ecsdemo-nodejs unchanged ArgoCD 콘솔에서도 동일하게 확인할 수 있습니다.
Application Update
Application이 ArgoCD에 배포되었습니다. 이제 애플리케이션과 동기화된 github 저장소를 업데이트 해 봅니다.
5.Application Update
사용자의 Github 포크 저장소로 이동해서 , Replica를 변경해 봅니다.
Copy https://github.com/{github-userid}/ecsdemo-nodejs/blob/master/kubernetes/deployment.yaml 변경후 Commit Chaged
이제 다시 Argo CD에서 상태를 확인해 봅니다.
ArgoCD 화면에서 Sync를 선택하고, 아래와 같이 추가로 Sync 시킵니다.
Argo CD의 UI에서 주요 메뉴들을 선택해서 실제 어떻게 Report 되는지를 살펴봅니다.
