ArgoCD란 Kubernetes 환경에 GitOps 배포 시 사용하는 SW 입니다. 사용자는 프로젝트 생성 시 또는 Kubernetes 배포 메뉴를 통해 ArgoCD를 통한 배포를 설정할 수 있습니다.

ArgoCD 시작하기

ArgoCD 애플리케이션의 상세내역을 조회하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 목록에서 시작하려는 ArgoCD 애플리케이션 카드을 클릭하세요. 배포상세 페이지로 이동합니다.

   항목	설명
   이름	ArgoCD 프로젝트명/ArgoCD URL을 표시합니다.
   Git 정보	배포에 사용한 Git 정보를 표시합니다.
   클러스터/네임스페이스	배포된 클러스터/네임스페이스를 표시합니다.
   App 상태	App의 현재 상태를 표시합니다.
   배포 결과	현재 Sync 상태를 표시합니다.
   배포 시간	배포 실행 시간을 표시합니다.
   새로 고침	새로 고침 아이콘을 클릭하면 현재 항목을 새로 고침 합니다. 변경되는 항목은 App 상태, 배포 결과“입니다.
   삭제	현재 항목을 삭제합니다.

   표. ArgoCD 애플리케이션 상세 항목

   항목	설명
   ArgoCD 앱 시크릿 수정	애플리케이션 이름 오른쪽의 인증정보 수정 아이콘을 클릭하면 배포에 사용되는 이미지 시크릿을 관리하는 팝업창이 열립니다.
   ArgoCD 앱으로 이동	실제 ArgoCD 툴의 애플리케이션 상세 화면이 새 창에서 열립니다.

   표. ArgoCD 배포 상세 항목

ArgoCD 애플리케이션 추가하기

신규 ArgoCD 애플리케이션 생성하고 추가하기 - 헬름 차트로 생성

헬름차트를 이용한 신규 ArgoCD 애플리케이션을 생성하며 추가하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 오른쪽 위쪽의 신규 ArgoCD App 생성 버튼을 클릭하세요. 신규 ArgoCD App 생성 페이지로 이동합니다.
4. ArgoCD 정보를 입력 후 확인 버튼을 클릭하세요. 인증정보 입력 항목이 나타납니다.
5. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
6. 애플리케이션 기본정보, 배포 대상 K8S 클러스터 입력 항목이 나타납니다.
7. 애플리케이션 이름을 입력하고 중복 확인 버튼을 클릭합니다.
8. 프로젝트 이름을 입력하세요.
9. 저장소 타입을 헬름차트로 신규 저장소 생성으로 선택하세요.
10. K8S 클러스터와 네임스페이스를 선택하세요.
11. 헬름차트를 선택하세요. 헬름차트 정보와 헬름차트 Git 저장소의 정보가 나타납니다.
12. 헬름차트의 K8S 클러스터 Values에 위치한 차트에 포함된 기본 Values.yaml의 내용을 수정한 후 Validation Check 버튼을 클릭하세요.
13. 헬름차트 Git 저장소 정보 입력 후 Connection Test 버튼을 클릭하세요.
14. Manifest Keys 정보를 입력하세요.
15. 생성 버튼을 클릭하여 생성을 완료하세요.

신규 ArgoCD 애플리케이션 생성하고 추가하기 - 기존 Git 저장소로 생성

기존 Git 저장소를 이용한 신규 ArgoCD 애플리케이션을 생성하며 추가하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 오른쪽 위쪽의 신규 ArgoCD App 생성 버튼을 클릭하세요. 신규 ArgoCD App 생성 페이지로 이동합니다.
4. ArgoCD 정보를 입력 후 확인 버튼을 클릭하세요. 인증정보 입력 항목이 나타납니다.
5. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
6. 애플리케이션 기본정보, 배포 대상 K8S 클러스터 입력 항목이 나타납니다.
7. 애플리케이션 이름을 입력하고 중복 확인 버튼을 클릭합니다.
8. 프로젝트 이름을 입력하세요.
9. 저장소 타입을 기존 Git 저장소 사용으로 선택하세요.
10. K8S 클러스터와 네임스페이스를 선택하세요.
11. 헬름차트를 선택하세요. 헬름차트와 헬름차트 Git 저장소의 정보가 나타납니다.
12. 헬름차트의 K8S 클러스터 Values에 위치한 차트에 포함된 기본 Values.yaml의 내용을 수정한 후 Validation Check 버튼을 클릭하세요.
13. 헬름차트 Git 저장소 정보 입력 후 Connection Test 버튼을 클릭하세요.
14. Manifest Keys에 Manifest Root 경로, Manifest 타입, (Manifest 타입이 Helm일 경우) values.yaml 경로 그리고 배포에 사용될 Manifest 파일 및 Key 정보 (Image repository, Image tag, Image Secret, Deploy Strategy)를 입력하세요.
15. 생성 버튼을 클릭하여 생성을 완료하세요.
    참고

    Manifest 파일 및 Key 정보 중, Deploy Strategy는 필수 입력 값이 아닙니다.

    항목	설명
    URL 입력 방식	URL 입력 방식을 선택 목록에서 선택: 툴로 등록된 ArgoCD 툴이 나타납니다. 직접 입력
    ArgoCD URL	ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
    인증정보	인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
    애플리케이션 이름	ArgoCD 애플리케이션 이름을 입력하고 중복 확인 버튼을 클릭하세요.
    프로젝트 이름	ArgoCD 애플리케이션의 프로젝트 이름을 입력하세요.
    저장소 타입	저장소 타입을 선택 헬름차트로 신규 저장소 생성: 헬름차트를 사용하여 GitOps에 사용될 Git 저장소를 생성합니다. 기존 Git 저장소 사용
    K8S 클러스터	배포할 대상 클러스터를 선택 DevOps Console K8S 클러스터의 클러스터 중 사용자가 접근권한을 가진 클러스터만 선택할 수 있습니다.
    네임스페이스	배포할 대상 네임스페이스를 선택 K8S 클러스터에서 선택된 클러스터 중 사용자가 접근 권한을 가진 네임스페이스만 선택할 수 있습니다.
    Git 저장소	GitOps에 사용될 ArgoCD 애플리케이션을 생성할 Manifest 정보가 저장되어 있는 Git 저장소 정보를 입력하세요.
    Manifest Keys 정보	지속적 배포를 하기 위한 정보(Manifest Root 경로, Manifest 타입(Helm, Customize, Directory), Manifest 파일/Key 정보를 입력하세요.

    표. 신규 ArgoCD 애플리케이션 생성 - 기존 Git 저장소로 생성 설정 항목

기존 ArgoCD 애플리케이션 추가하기

기존 ArgoCD 애플리케이션을 추가하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 오른쪽 위쪽의 ArgoCD App 추가 버튼을 클릭하세요. ArgoCD App 추가 페이지로 이동합니다.
4. ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
5. 기존 애플리케이션 이름과 인증정보의 입력 화면이 나타납니다.
6. 기존 애플리케이션 이름과 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
   참고

   ArgoCD 애플리케이션에 연동된 Git 저장소가 DevOps Console에 등록되어 있지 않다면 URL Check 팝업창이 열립니다. 다음 7~8 단계를 따르세요.
7. ArgoCD 애플리케이션에 연동된 Git 저장소를 구분하기위한 URL Check 팝업이 열립니다.
8. Base URL 수정 후 확인 버튼을 클릭하세요.
9. 애플리케이션에 연동된 Git 저장소 정보가 나타납니다.
10. Git 저장소 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
11. Manifest Keys 항목 중 변경할 yaml 파일과 키값을 입력하세요.
12. 정보 입력 후 저장 버튼을 클릭하여 ArgoCD 애플리케이션 추가를 완료하세요.

    항목	설명
    URL 입력 방식	URL 입력 방식을 선택 목록에서 선택: 툴로 등록된 ArgoCD 툴이 나타납니다. 직접 입력
    ArgoCD URL	ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
    애플리케이션 이름 / 인증정보	기존 애플리케이션 이름과 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
    Git 저장소 인증정보	선택한 기존 애플리케이션이 사용중인 Git 저장소의 인증정보를 입력하세요.
    Image Repo Key	이미지 저장소 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요. 만약 repository와 tag의 키값이 같다면 같은 값을 입력하세요.
    Image Tag Key	이미지 태그 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요. 만약 repository와 tag의 키값이 같다면 같은 값을 입력하세요.
    Image Secret Key	이미지 시크릿 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요.
    Deploy Strategy Key	배포 전략 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요. (필수값은 아닙니다.)

    표. 기존 ArgoCD 애플리케이션 추가하기 설정 항목

ArgoCD 애플리케이션 관리하기

ArgoCD 애플리케이션의 상세내역을 조회하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 목록에서 시작하려는 ArgoCD 애플리케이션 카드을 클릭하세요. 배포상세 페이지로 이동합니다.

Manifest 정보 수정하기

Manifest 정보를 수정하려면 다음 절차를 따르세요.

1. Git 관련 정보 탭을 클릭하세요.
2. Manifest 정보 옆의 편집 아이콘을 클릭하세요. Manifest key 정보 수정 팝업창이 열립니다.
3. Manifest key 값을 수정하고 저장 버튼을 클릭하세요.

ArgoCD 인증정보 수정하기

ArgoCD 인증정보를 수정하려면 다음 절차를 따르세요.

1. ArgoCD 사용자 ID 옆의 편집 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
2. 인증정보 값을 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.

연동 Git 저장소 인증정보 수정하기

연동 Git 저장소의 인증정보를 수정하려면 다음 절차를 따르세요.

1. 연동 Git ID 옆의 편집 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
2. 인증정보를 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.

Sync 설정하기

Sync 설정을 변경하려면 다음 절차를 따르세요.

1. Current Sync 옆의 동기화 아이콘을 클릭하세요. ArgoCD App Sync 팝업창이 열립니다.
2. 수정할 내용을 입력하고 동기화 버튼을 클릭하여 Sync 설정을 완료하세요.

   항목	설명
   Revision	동기화 대상 브랜치를 선택합니다.
   Sync Options	동기화 관련 옵션을 선택합니다.
   Synchronize Resources	동기화 대상을 선택합니다.

   표. Sync 설정 항목
   참고

   ArgoCD 동기화와 관련된 자세한 내용은 공식사이트를 참고하세요.

Auto-Sync 설정하기

ArgoCD 애플리케이션의 Auto-Sync 설정을 변경하려면 다음 절차를 따르세요.

1. Auto-Sync 옆의 편집 아이콘을 클릭하세요. Auto-Sync 옵션 팝업창이 열립니다.
2. 수정하고 저장 버튼을 클릭하여 설정을 완료하세요.

   항목	설명
   Prune Resources	Git 설정이 삭제되는 경우 동기화 대상도 함께 삭제할지 여부를 선택합니다.
   Self Heal	클러스터에서 동기화 대상의 값이 변경된 경우 Git에 정의된 값으로 자동으로 변경할지 여부를 선택합니다.

   표. Auto-Sync 설정 항목

애플리케이션 시크릿 관리하기

헬름차트로 생성한 ArgoCD 애플리케이션인 경우, 애플리케이션의 시크릿을 추가/수정/삭제할 수 있습니다.

애플리케이션 시크릿 관리를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 이름 오른쪽의 애플리케이션 시크릿을 클릭하세요.
2. 애플리케이션 시크릿 설정 팝업창이 열립니다.

애플리케이션 시크릿 추가하기

애플리케이션 시크릿을 추가하려면 다음 절차를 따르세요.

1. 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
2. Chart Image를 pull 할 때 사용할 시크릿의 추가가 필요한 경우 Chart Install Secret 영역의 추가 버튼을 클릭하세요.
3. 빌드/배포 시 사용하는 App Image를 pull 할 때 사용할 시크릿의 추가가 필요한 경우 ImagePull Secret 영역의 추가 버튼을 클릭하세요.
4. 내용을 입력하고 저장 버튼을 클릭하여 추가를 완료하세요.

   항목	설명
   Registry URL	이미지 저장소에 등록된 이미지 목록에서 ImagePull Secret이 사용할 이미지를 선택하세요.
   시크릿	ImagePull Secret 정보 입력 방식을 선택 자동생성: Docker URL에서 선택한 이미지 저장소의 인증정보를 사용해서 자동으로 ImagePull Secret을 생성합니다. 기존 시크릿 사용: 이미 생성되어 있는 시크릿 중 하나를 선택하여 ImagePull Secret으로 사용합니다.

   표. 애플리케이션 시크릿 추가 설정 항목

애플리케이션 시크릿 수정하기

애플리케이션 시크릿을 수정하려면 다음 절차를 따르세요.

1. 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
2. 애플리케이션 시크릿 목록에서 수정을 원하는 시크릿 이름을 클릭하세요.
3. 내용을 입력하고 저장 버튼을 클릭하여 수정을 완료하세요.

애플리케이션 시크릿 삭제하기

애플리케이션 시크릿을 삭제하려면 다음 절차를 따르세요.

1. 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
2. 애플리케이션 시크릿 목록에서 삭제를 원하는 시크릿 이름을 클릭하세요.
3. 삭제 버튼을 클릭하여 삭제를 완료하세요.

Values.yaml 파일 비교하기

헬름차트를 이용한 ArgoCD 애플리케이션인 경우 values.yaml 파일을 비교할 수 있습니다.

각 릴리스에 사용한 values.yaml 파일을 비교하려면 다음 절차를 따르세요.

1. 내역 탭을 클릭하세요.
2. 비교를 원하는 2개 리비전을 클릭하세요.
3. App Diff 버튼을 클릭하세요. App Diff 팝업창이 열립니다.

애플리케이션 롤백하기

애플리케이션을 이전 리비전으로 롤백하려면 다음 절차를 따르세요.

1. 내역 탭을 클릭하세요.
2. 롤백을 원하는 리비전의 롤백 커럼의 롤백 버튼을 클릭하세요. 롤백 팝업창이 열립니다.
3. 확인 버튼을 클릭하여 롤백을 완료하세요.

애플리케이션 삭제하기

애플리케이션을 삭제하려면 다음 절차를 따르세요.

1. 오른쪽 아래의 삭제 버튼을 클릭하세요. 애플리케이션 삭제 팝업이 열립니다.
2. 확인 버튼을 클릭하여 삭제를 완료하세요.