1 - 헬름릴리스
헬름릴리스는 Kubernetes 클러스터에서 구동되는 차트의 인스턴스입니다. 사용자는 프로젝트 생성 시 또는 헬름인스톨 메뉴를 통해 헬름릴리스를 생성할 수 있습니다.
헬름릴리스 시작하기
헬름릴리스를 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
| 항목 | 설명 |
|---|
| 이름 | 배포 명을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. |
| 차트 | 배포에 사용한 헬름차트 정보를 표시합니다. |
| 클러스터/네임스페이스 | 배포된 클러스터/네임스페이스를 표시합니다. |
| Pod 상태 | Pod의 현재 상태를 표시합니다. |
| 배포 결과 | 배포 실행 결과를 표시합니다. |
| 배포 시간 | 배포 실행 시간을 표시합니다. |
| 새로 고침 | 현재 항목을 새로 고침 합니다. 변경되는 항목은 Pod 상태, 배포 결과, 배포 시간 입니다. |
| 삭제 | 현재 항목을 삭제합니다. |
표. 헬름릴리스 항목
- Kubernetes 배포 페이지에서 헬름릴리스 목록에서 이름을 클릭하세요. 배포 상세 페이지로 이동합니다.
헬름릴리스 추가하기
헬름인스톨
헬름인스톨 하기를 통해서 헬름릴리스를 추가할 수 있습니다.
관련 헬름릴리스 추가
관련 헬름릴리스를 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 관련 헬름릴리스 추가를 버튼을 클릭하세요. 관련 헬름릴리스 추가 팝업창이 열립니다.
- 관련 헬름릴리스 추가 팝업창에서 각 항목을 입력하세요.
- 저장 버튼을 클릭하여 헬름릴리스 추가를 완료하세요.
| 항목 | 설명 |
|---|
| 이미 프로젝트에 등록된 헬름릴리스 | 이미 프로젝트에 등록된 헬름릴리스를 보여줍니다.- 이미 프로젝트에 등록된 헬름릴리스는 추가할 수 없습니다.
|
표. 관련 헬름릴리스 추가 시 표시 항목
헬름릴리스 시크릿 관리하기
헬름릴리스 시크릿 시작하기
헬름릴리스 시크릿에서는 헬름릴리스에서 빌드 파이프라인을 통해 배포된 이미지에 사용할 ImagePull Secret을 관리할 수 있습니다.
헬름릴리스 시크릿 관리를 시작하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 헬름릴리스 오른쪽의 인증정보 수정 아이콘을 클릭하세요.
- 헬름릴리스 시크릿 팝업창이 열립니다.
헬름릴리스 시크릿 추가하기
헬름릴리스 시크릿을 추가하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 헬름릴리스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 헬름릴리스 시크릿 팝업창이 열립니다.
- 헬름릴리스 시크릿 팝업창에서 private한 Chart Image를 pull 하기 위해 사용할 시크릿의 추가가 필요한 경우 Chart Install Secret 영역의 추가 버튼을 클릭하세요. 시크릿 추가 팝업창이 열립니다.
- 빌드/배포 시 사용하는 App Image를 pull 하기 위해 사용할 시크릿의 추가가 필요한 경우 ImagePull Secret 영역의 추가 버튼을 클릭하세요. 시크릿 추가 팝업창이 열립니다.
- 시크릿 추가 팝업창에서 시크릿 관련 내용을 입력하고 저장 버튼을 클릭하여 추가를 완료하세요.
| 항목 | 설명 |
|---|
| Registry URL | 이미지 저장소에 등록된 이미지 목록에서 ImagePull Secret이 사용할 이미지를 선택하세요. |
| 시크릿 | 시크릿 정보 입력 방식을 선택- 자동생성: Docker URL에서 선택한 이미지 저장소의 인증정보를 사용해서 자동으로 시크릿을 생성합니다.
- 기존 시크릿 사용: 이미 생성되어 있는 시크릿 중 하나를 선택하여 사용합니다.
|
표. 헬름릴리스 시크릿 추가 설정 항목
헬름릴리스 시크릿 수정하기
헬름릴리스 시크릿을 수정하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 헬름릴리스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 헬름릴리스 시크릿 팝업창이 열립니다.
- 헬름릴리스 시크릿 목록에서 수정을 원하는 시크릿 이름을 클릭하세요. 시크릿 수정 팝업창이 열립니다.
- 내용을 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.
헬름릴리스 시크릿 삭제하기
헬름릴리스 시크릿을 삭제하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 헬름릴리스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 헬름릴리스 시크릿 팝업창이 열립니다.
- 헬름릴리스 시크릿 목록에서 삭제를 원하는 시크릿 이름을 클릭하세요.
- 삭제 버튼을 클릭하여 삭제를 완료하세요.
K8S 인증정보 수정하기
K8S 인증정보란 빌드 파이프라인에서 배포를 수행할 때 K8S 클러스터/네임스페이스를 사용할 권한을 확인할 때 사용하는 인증정보입니다.
K8S 인증정보를 수정하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 K8S 클러스터/네임스페이스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
- 인증정보는 로그인 한 사용자의 계정으로 고정됩니다. 수정을 위해 저장 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하세요.
- K8S 인증정보가 로그인한 사용자로 변경됩니다.
헬름릴리스에 사용한 values.yaml 확인하기
values.yaml 내용을 확인하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 내역 탭을 클릭하세요.
- Values 컬럼에서 보기 아이콘을 클릭하세요. 리비전 # - Values.yaml 팝업창이 열립니다.
values.yaml 파일 내용을 확인하세요.
헬름릴리스에 사용한 values.yaml 비교하기
각 릴리스에 사용한 values.yaml 내용을 비교하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 내역 탭을 클릭하세요.
- 목록에서 비교를 원하는 2개 리비전의 체크 박스를 각각 클릭하세요.
- Yaml Diff 버튼을 클릭하세요. Yaml Diff 팝업창이 열립니다.
- Yaml Diff (리비전 #>#) 팝업창에서 비교 내용을 확인하세요.
헬름릴리스 롤백하기
헬름릴리스를 이전 리비전으로 롤백하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 내역 탭을 클릭하세요.
- 롤백을 원하는 리비전의 롤백 버튼을 클릭하세요. 롤백 팝업창이 열립니다.
- 확인 버튼을 클릭하여 롤백을 완료하세요.
헬름릴리스 업그레이드 하기
헬름릴리스를 업그레이드 하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 내역 탭을 클릭하세요.
- Values 컬럼에서 보기 아이콘을 클릭하세요. 리비전 # - Values.yaml 팝업창이 열립니다.
- 현재 Values.yaml의 내용을 수정하고, 업그레이드 버튼을 클릭하세요. 업그레이드 팝업창이 열립니다.
- 업그레이드 되는 정보를 확인하세요.
- 실행 버튼을 클릭하여 업그레이드를 완료하세요.
Pod 로그 보기
헬름릴리스와 관련된 Pod의 로그를 보려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 릴리스 오브젝트 탭을 클릭하세요.
- Pod 항목의 LOG 컬럼의 보기 아이콘을 클릭하세요. 로그 팝업창이 열립니다.
| 항목 | 설명 |
|---|
| 컨테이너 | 로그를 출력하고 싶은 컨테이너를 선택합니다. |
| 실시간 새로고침 | 로그 출력을 실시간으로 새로고침 합니다. |
| 새로고침 중단 | 실시간 새로고침을 중단합니다. |
| 다운로드 | Pod 로그를 파일로 다운로드 합니다. |
표. 로그 팝업창 기능 설명
헬름릴리스 삭제하기
헬름릴리스를 삭제하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 헬름릴리스 오른쪽 하단의 삭제 버튼을 클릭하세요. 헬름릴리스 삭제 팝업창이 열립니다.
- 확인 버튼을 클릭하여 삭제를 완료하세요.
참고
헬름삭제 명령어도 함께 실행
- 선택: 헬름릴리스가 실제로 클러스터에서 삭제됩니다.
- 미선택: Kubernetes 배포 목록에서만 삭제되고 클러스터에는 남습니다.
2 - 워크로드
워크로드는 Kubernetes에서 구동되는 애플리케이션으로 사용자는 워크로드를 DevOps Console에 추가하여 관리할 수 있습니다.
DevOps Console에서 관리 가능한 워크로드 유형은 Deployment, StatefulSet, DaemonSet 입니다.
워크로드 시작하기
워크로드 이용을 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지에서 워크로드의 이름을 클릭하세요.
| 항목 | 설명 |
|---|
| 워크로드 유형 | 워크로드 유형을 표시합니다.DeploymentStatefulSetDaemonSet
|
| 이름 | 워크로드 이름을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. |
| 차트 | 배포에 사용한 Helm 차트 정보를 표시합니다. |
| 클러스터/네임스페이스 | 배포된 클러스터/네임스페이스를 표시합니다. |
| Pod 상태 | Pod의 현재 상태를 표시합니다. |
| 배포 결과 | 배포 실행 결과를 표시합니다. |
| 배포 시간 | 배포 실행 시간을 표시합니다. |
| 새로 고침 | 현재 항목을 새로 고침 합니다. 변경되는 항목은 Pod 상태, 배포 결과, 배포 시간 입니다. |
| 삭제 | 현재 항목을 삭제합니다. |
표. 워크로드 화면 항목
워크로드 추가하기
워크로드를 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지에서 워크로드 추가 메뉴를 클릭하세요. 워크로드 추가 팝업창이 열립니다.
- 워크로드 추가 팝업창에서 정보를 입력하고 저장 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하여 워크로드 추가를 완료합니다.
항목 | 설명 |
|---|
| 조회 대상 | 최초 프로젝트 생성 시 사용한 App.템플릿의 Base 이미지와 동일한 이미지로 배포한 워크로드만 표시됩니다. |
| 이미 프로젝트에 등록된 워크로드 | 이미 프로젝트에 등록된 워크로드를 보여줍니다.- 이미 프로젝트에 등록된 워크로드는 추가할 수 없습니다.
|
표. 워크로드 추가 입력 항목
K8S 인증정보 수정하기
K8S 인증정보란 빌드 파이프라인에서 배포를 수행할 때 K8S 클러스터/네임스페이스를 사용할 권한을 확인할 때 사용하는 인증정보입니다.
K8S 인증정보를 수정하려면 다음 절차를 따르세요.
- 배포 상세 페이지에서 K8S 클러스터/네임스페이스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
- 인증정보는 로그인 한 사용자의 계정으로 고정됩니다. 수정을 위해 저장 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하세요.
- K8S 인증정보가 로그인한 사용자로 변경됩니다.
워크로드 롤백하기
워크로드를 이전 이미지로 롤백하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지에서 롤백 할 워크로드 이름을 클릭하세요. 워크로드 상세 페이지로 이동합니다.
- 워크로드 상세 페이지의 상세정보 탭을 클릭하세요.
- 상세정보 탭 목록에서 롤백을 원하는 이미지가 있는 행의 롤백 버튼을 클릭하세요. 롤백 팝업창이 열립니다.
- 롤백 팝업창에서 원하는 방식의 버튼을 클릭하여 롤백을 완료하세요.
배포결과 수신인 추가하기
배포결과 수신인을 추가하려면 다음 절차를 따르세요.
- 워크로드 상세 페이지의 배포결과 수신인 탭을 클릭하세요.
- 배포결과 수신인 탭의 추가 버튼을 클릭하세요. 배포결과 수신인 추가 팝업창이 열립니다.
- 배포결과 수신인 추가 팝업창에서 대상자를 선택하고 확인 버튼을 클릭하여 배포결과 수신인 추가를 완료하세요.
- 검색 버튼 또는 목록을 클릭하여 수신 대상을 팝업 아래쪽에 추가합니다.
- 추가된 수신 대상은 오른쪽의 X 아이콘을 클릭하여 삭제가 가능합니다.
워크로드 삭제하기
워크로드를 삭제하려면 다음 절차를 따르세요.
- Kubernetes 배포 페이지에서 삭제 할 워크로드의 X 아이콘을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하여 삭제를 완료하세요.
참고
워크로드는 실제 클러스터에서는 삭제되지 않습니다.
실제 클러스터에서 삭제를 원하는 경우 워크로드를 최초 배포했던 방식을 통해 삭제하세요.
3 - 블루/그린 배포
사용자는 Ingress 또는 Service를 이용하여 블루/그린 배포를 수행할 수 있습니다.
블루/그린 배포 추가는 두개의 헬름릴리스를 서로 교체할 수 있도록 새로운 K8S Ingress 또는 K8S Service를 생성하는 것을 의미합니다.
프로젝트, 클러스터, 네임스페이스, 릴리스 타입, 차트명, 차트버전, 개발 구분이 모두 같은 두 개의 헬름릴리스만 묶을 수 있습니다.
블루/그린 배포 시작하기
블루/그린 배포 이용을 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
항목 | 설명 |
|---|
| 이름 | 블루/그린 배포 이름을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. |
| 클러스터/네임스페이스 | 배포된 클러스터/네임스페이스를 표시합니다. |
| (운영) | 현재 운영 중인 헬름릴리스 정보를 표시합니다. |
| (운영대기) | 다음 버전의 운영이 될 헬름릴리스를 표시합니다. 블루/그린 교체를 사용하면 운영대기가 운영으로 전환됩니다. |
| 삭제 | 현재 항목을 삭제합니다. |
표. Kubernetes 배포 화면 블루/그린 배포 카드 항목
- Kubernetes 배포 페이지의 배포 목록에서 시작하려는 블루/그린 배포의 이름을 클릭하세요. 배포상세 페이지로 이동합니다.
블루/그린 배포 추가하기
블루/그린 배포를 추가하려면 다음 절차를 따르세요.
참고
블루/그린 배포 추가를 위해서는 동일한 차트를 사용해서 헬름인스톨 된 2개의 헬름릴리스가 필요합니다.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지의 오른쪽 위쪽의 블루/그린 배포 추가 버튼을 클릭하세요. 블루/그린 배포 추가 팝업창이 열립니다.
- 블루/그린 배포 추가 팝업창에서 정보 입력 후 저장 버튼을 클릭하여 블루/그린 배포 추가를 완료합니다.
항목 | 설명 |
|---|
| 구분 | 개발, 운영을 선택 |
| 블루/그린 배포명 | 배포 명을 입력합니다. |
| 운영 | 릴리스와 Jenkins Job을 선택- 릴리스 이름: 현재 운영 중인 헬름릴리스의 이름을 목록에서 선택합니다.
- Jenkins Job: 선택한 헬름릴리스를 빌드/배포하기 위한 Jenkins Job을 목록에서 선택
|
| 운영대기 | 릴리스와 Jenkins Job을 선택- 릴리스 이름: 다음 버전으로 운영에 반영할 헬름릴리스의 이름을 목록에서 선택합니다.
- Jenkins Job: 선택한 헬름릴리스를 빌드/배포하기 위한 Jenkins Job을 목록에서 선택
|
| K8S 클러스터/네임스페이스 | 헬름릴리스가 인스톨 된 K8S 클러스터/네임스페이스를 표시합니다. |
| 유형 구분 | 블루/그린을 전환하기 위해서 Ingress를 사용할지 Service를 사용할지 선택합니다. |
| 신규 구분 | Ingress나 Service를 신규로 생성할지 이미 생성되어 있는 것을 사용할지 선택합니다. |
| 이름 | 이름을 입력- 신규: Ingress 또는 Service의 이름을 입력 합니다.
- 기존: 이미 생성되어 있는 Ingress 또는 Service를 목록에서 선택
|
| Service (운영) | 현재 운영 중인 헬름릴리스와 관련된 Kubernetes Service를 목록에서 선택합니다. |
| Service (운영대기) | 다음 버전으로 운영에 반영할 헬름릴리스와 관련된 Kubernetes Service를 목록에서 선택합니다. |
| Rules | Ingress에서 사용할 정보를 입력합니다. |
표. 블루/그린 배포 추가 시 Ingress 유형 입력 항목
| 항목 | 설명 |
|---|
| 타입 | Kubernetes Service의 타입을 목록에서 선택ClusterIPNodePortLoadBalancer
|
| Deployment (운영) | 현재 운영 중인 헬름릴리스와 관련된 Kubernetes Deployment를 목록에서 선택합니다. |
| Deployment (운영대기) | 다음 버전의 운영이 될 헬름릴리스와 관련된 Kubernetes Deployment를 목록에서 선택합니다. |
| Ports | Service에서 사용할 정보를 입력합니다. |
표. 블루/그린 배포 추가 시 Service 유형 입력 항목
블루/그린 교체하기
블루/그린 교체를 위해서는 다음 절차를 따르세요.
- 배포상세 페이지에서 블루/그린 교체 버튼을 클릭하세요. 블루/그린 교체 팝업창이 열립니다.
- 블루/그린 교체 팝업창에서 확인 버튼을 클릭하여 블루/그린 교체를 완료하세요.
- 운영, 운영대기의 헬름릴리스가 서로 교체됩니다.
- 교체 내역이 추가됩니다.
블루/그린 배포의 Ingress 또는 Service의 yaml 확인하기
블루/그린에 사용하는 Ingress 또는 Service의 yaml을 확인하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 Ingress YAML 또는 Service YAML의 보기 아이콘을 클릭하세요. Ingress YAML 또는 Service YAML 팝업창이 열립니다.
- Ingress YAML 또는 Service YAML 팝업창에서 내용을 확인하고 확인 버튼을 클릭하여 종료하세요.
블루/그린 배포의 Jenkins Job 관리하기
Jenkins Job 로그 보기
Jenkins Job 로그를 보려면 다음 절차를 따르세요.
- 배포상세 페이지에서 원하는 릴리스의 Jenkins Job 항목에서 로그 버튼을 클릭하세요. 파이프라인 로그 팝업창이 열립니다.
- 파이프라인 로그 팝업창에서 로그 확인 완료 후 확인 버튼을 클릭하세요.
Jenkins Job 실행하기
Jenkins Job을 실행하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 원하는 릴리스의 Jenkins Job 항목에서 실행 버튼을 클릭하세요. 파이프라인 실행 매개변수 입력 팝업창이 열립니다.
- 파이프라인 실행 매개변수 입력 팝업창에서 각 항목을 입력 또는 선택 후 확인 버튼을 클릭하여 Jenkins Job 실행을 완료하세요.
블루/그린 배포 수정하기
블루/그린 배포를 수정하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 수정 버튼을 클릭하세요. 블루/그린 배포 수정 팝업창이 열립니다.
- 블루/그린 배포 수정 팝업창에서 원하는 항목을 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.
블루/그린 배포 삭제하기
블루/그린 배포를 삭제하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 삭제 버튼을 클릭하세요. 블루/그린 배포 삭제 팝업창이 열립니다.
- 블루/그린 배포 삭제 팝업창에서 Ingress/Service 삭제 명령어 실행 여부를 선택하고 확인 버튼을 클릭하여 삭제를 완료하세요.
참고
Ingress/Service 삭제 명령어 실행
- 선택: 블루/그린 배포에 사용 된 Ingress 또는 Service가 실제로 클러스터에서 삭제됩니다.
- 미선택: 블루/그린 배포에 사용 된 Ingress 또는 Service는 삭제되지 않고 클러스터에 남아 있습니다.
4 - 카나리 배포
사용자는 카나리 배포를 추가할 수 있습니다.
카나리 추가는 두개의 헬름릴리스를 묶어 카나리 테스트를 할 수 있도록 설정하는 것을 의미합니다.
프로젝트, 클러스터, 릴리스 타입, 차트명, 차트버전, 개발 구분이 모두 같은 두 개의 헬름릴리스만 묶을 수 있습니다.
카나리 배포 시작하기
카나리 이용을 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
| 항목 | 설명 |
|---|
| 이름 | 카나리 이름을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. |
| 클러스터 | 배포된 클러스터를 표시합니다. |
| (운영) | 현재 운영 중인 헬름릴리스를 표시합니다. |
| (카나리) | 카나리 중인 헬름릴리스를 표시합니다. |
| 종료 | 카나리를 종료합니다. |
표. Kubernetes 배포 화면 카나리 카드 항목
- Kubernetes 배포 페이지의 배포 목록에서 이용하려는 카나리의 이름을 클릭하세요. 배포상세 페이지로 이동합니다.
카나리 추가하기
카나리를 추가하려면 다음 절차를 따르세요.
참고
카나리는 다음 환경에서 지원됩니다. 카나리 추가 전 확인하세요.
Kubernetes v1.17 이상nginx-ingress v0.29.0 이상
안내
카나리 추가를 위해서는 동일한 차트를 사용해서 헬름인스톨 된 2개의 헬름릴리스가 필요합니다.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지의 우측 상단 카나리 추가 버튼을 클릭하세요. 카나리 추가 팝업창이 열립니다.
- 카나리 추가 팝업창에서 정보 입력 후 저장 버튼을 클릭하여 카나리 추가를 완료합니다.
| 항목 | 설명 |
|---|
| 구분 | 개발, 운영을 선택합니다. |
| 카나리 명 | 카나리 이름을 입력합니다. |
| 운영 | - 릴리스 이름: 현재 운영중인 헬름릴리스의 이름을 목록에서 선택합니다.
- Jenkins Job: 현재 운영중인 헬름릴리스를 빌드/배포하기 위한 Jenkins Job을 목록에서 선택
|
| 카나리 | - 릴리스 이름: 다음 버전의 운영이 될 헬름릴리스의 이름을 목록에서 선택합니다.
- Jenkins Job: 다음 버전의 운영이 될 헬름릴리스를 빌드/배포하기 위한 Jenkins Job을 목록에서 선택
|
| K8S 클러스터 | 헬름릴리스가 인스톨 된 K8S 클러스터를 표시합니다. |
| 인그레스 어노테이션 | nginx-ingress 에서 제공하는 카나리 어노테이션 중, 적용을 하려는 어노테이션 항목을 입력합니다. |
표. 카나리 추가 입력 항목
참고
nginx-ingress 에서 제공하는 인그레스 어노테이션의 각 항목에 대한 상세 가이드는
다음 페이지를 참고하세요.
카나리의 Ingress YAML 확인하기
카나리에서 사용하고 있는 운영 Ingress YAML, 카나리 Ingress YAML을 확인하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 운영 Ingress YAML, 카나리 Ingress YAML의 보기 아이콘을 클릭하세요. Ingress YAML 팝업창이 열립니다.
- Ingress YAML 팝업창에서 내용을 확인하고 확인 버튼을 클릭하여 종료하세요.
카나리의 Jenkins Job 관리하기
Jenkins Job 로그 보기
Jenkins Job 로그를 보려면 다음 절차를 따르세요.
- 배포상세 페이지에서 원하는 릴리스의 Jenkins Job 항목에서 로그 버튼을 클릭하세요. 파이프라인 로그 팝업창이 열립니다.
- 파이프라인 로그 팝업창에서 로그 확인 완료 후 확인 버튼을 클릭하세요.
Jenkins Job 실행하기
Jenkins Job을 실행하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 원하는 릴리스의 Jenkins Job 항목에서 실행 버튼을 클릭하세요. 파이프라인 실행 매개변수 입력 팝업창이 열립니다.
- 파이프라인 실행 매개변수 입력 팝업창에서 각 항목을 입력 또는 선택 후 확인 버튼을 클릭하여 Jenkins Job 실행을 완료하세요.
카나리 수정하기
카나리를 수정하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 수정 버튼을 클릭하세요. 카나리 수정 팝업창이 열립니다.
- 카나리 수정 팝업창에서 원하는 항목을 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.
카나리 복구하기
운영 릴리스와 카나리 릴리스의 인그레스 어노테이션 정보가 헬름 릴리스 변경으로 인해 정상적으로 동작하지 않을 때, 다시 동작하도록 복구합니다.
카나리를 복구하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 복구 버튼을 클릭하세요. 복구 팝업창이 열립니다.
- 복구 팝업창에서 확인 버튼을 클릭하여 복구를 완료하세요.
카나리 종료(삭제)하기
카나리를 종료하려면 다음 절차를 따르세요.
- 배포상세 페이지에서 종료 버튼을 클릭하세요. 카나리 종료 팝업창이 열립니다.
- 카나리 종료 팝업창에서 원하는 항목을 선택하고 확인 버튼을 클릭하여 종료를 완료하세요.
항목 | 설명 |
|---|
| 카나리 릴리스 | 카나리 릴리스를 선택- Ingress Host 되돌리기: 카나리에 사용했던 헬름릴리스의 Ingress 호스트를 원래 값으로 되돌립니다.
- 헬름릴리스 삭제: 카나리에 사용했던 헬름릴리스를 삭제합니다.
|
| 운영 릴리스 | 운영 릴리스를 선택- 카나리 이미지로 업그레이드: 운영 헬름릴리스를 카나리에서 사용한 이미지로 업그레이드 합니다.
Values.yaml 파일을 수정할 수 있습니다. - 미수행: 운영 헬름릴리스에 변경이 없이 카나리만 종료합니다.
|
표. 카나리 종료 선택 항목
5 - Istio
참고
Istio에 대한 상세 가이드는
다음 페이지를 참고하세요.
DevOps Console에서 지원하는 Istio Traffic management Object 목록은 다음과 같습니다.
GatewayVirtual ServiceDestination Rule
Istio 시작하기
Istio 이용을 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
| 항목 | 설명 |
|---|
| 이름 | Istio 이름을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. |
| 클러스터/네임스페이스 | 배포된 클러스터/네임스페이스를 표시합니다. |
| 삭제 | 현재 항목을 삭제합니다. |
표. Kubernetes 배포 화면 Istio 카드 항목
- Kubernetes 배포 페이지의 배포 목록에서 이용하려는 Istio의 이름을 클릭하세요. Istio 상세 페이지로 이동합니다.
Istio 추가하기
Istio를 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지의 우측 상단 Istio 추가 버튼을 클릭하세요. Istio 추가 팝업창이 열립니다.
- Istio 추가 팝업창에서 정보 입력 후 저장 버튼을 클릭하여 Istio를 추가하세요.
| 항목 | 설명 |
|---|
| 구분 | 개발, 운영을 선택하세요. |
| K8S 클러스터 | K8S 클러스터를 선택하세요. |
| 네임스페이스 | 네임스페이스를 선택하세요. Istio 사용이 가능한 네임스페이스만 목록에 표시됩니다. |
표. Istio 추가 입력 항목
참고
Istio를 추가 했지만 Istio object를 생성하지 않았기 때문에 아직 Istio 관련 기능을 사용할 수 없습니다.
생성 위자드를 사용해서 Istio object 추가하기 또는 Object 추가를 사용해서 Istio object 추가하기를 수행하여 Istio object를 추가하고 사용하세요.
Istio objects
Istio object 추가하기
생성 위자드를 사용해서 Istio object 추가하기
- Istio 상세 페이지에서 Istio objects 탭을 클릭하세요.
- Istio objects 탭에서 생성위자드 버튼을 클릭하세요. 생성위자드 페이지로 이동합니다.
Helm Release
Istio에서 사용 할 헬름릴리스틀 선택하는 스탭입니다.
- 생성위자드 페이지에서 추가 버튼을 클릭하여 Istio에서 사용 할 헬름릴리스를 모두 선택하세요.
- 시작 버튼을 클릭하세요. Gateway 화면이 나타납니다.
Gateway
Istio Gateway는 외부로부터 트래픽을 받는 최앞단 오브젝트 입니다.
- 생성위자드 페이지의 Gateway 화면에서 Gateway 생성 여부를 선택합니다.
- Gateway 생성을 원하는 경우 각 항목을 입력하세요.
- Gateway 생성을 하지 않으려면 Object를 생성하지 않고 넘기기를 선택하세요.
- 다음 버튼을 클릭하세요. Destination Rule 화면이 나타납니다.
| 항목 | 설명 |
|---|
| 이름 Prefix | 생성할 Istio Gateway Object의 Prefix명을 지정합니다. |
| Host | 외부에서 접속하는 Gateway Object의 도메인을 지정합니다. |
표. 생성위자드 Gateway 입력 항목
Destination Rule
Destination Rule은 Istio의 traffic 정책을 정의합니다.
- 생성위자드 페이지의 Destination Rule 화면에서 Destination Rule 생성 여부를 선택합니다.
- Destination Rule 생성을 원하는 경우 각 항목을 입력하세요.
- Destination Rule 생성을 하지 않으려면 Object를 생성하지 않고 넘기기를 선택하세요.
- 다음 버튼을 클릭하세요. Virtual Service 화면이 나타납니다.
| 항목 | 설명 |
|---|
| 이름 Prefix | 생성할 Istio Destination Rule Object의 Prefix명을 입력하세요. |
| LoadBalancer | 로드밸런서의 방식을 선택하세요.ROUND_ROBIN: 라운드 로빈LEAST_CONN: 마지막 커넥션 계속 사용RANDOM: 랜덤
|
| maxConnections | 최대 접속 허용 커넥션 수를 입력하세요. |
표. 생성위자드 Destination Rule 입력 항목
Virtual Service
Virtual Service는 들어오는 트래픽을 서비스로 라우팅하는 역할을 합니다.
- 생성위자드 페이지의 Virtual Service 화면에서 Virtual Service 생성을 원하는 경우 각 항목을 입력하세요.
- 완료 버튼을 클릭하여 생성 위자드를 사용한 Istio object 추가를 완료하세요.
| 항목 | 설명 |
|---|
| 이름 Prefix | 생성할 Istio Virtual Service의 Prefix명을 입력하세요. |
| Prefix-Uri | prefix uri를 입력하여 해당 uri로 트래픽이 들어올 시 라우팅할 수 있도록 하세요. |
| Helm Release Weight | 헬름릴리스가 두개 이상이면 연결 Weight를 입력하세요. 각 숫자의 합은 100이 되어야 합니다. |
표. 생성위자드 Virtual Service 입력 항목
Object 추가를 사용해서 Istio object 추가하기
- Istio 상세 페이지에서 Istio objects 탭을 클릭하세요.
- Istio objects 탭에서 Object 추가 버튼을 클릭하세요. Object 추가 팝업창이 열립니다.
- Object 추가 팝업창에서 각 항목을 입력하고 저장 버튼을 클릭하여 Istio object 추가를 완료하세요.
| 항목 | 설명 |
|---|
| Object | 생성하려는 Object를 선택GatewayVirtual ServiceDestination Rule
|
| 입력 | 각 Object 별로 입력 항목이 달라집니다. 생성위자드를 참고하여 입력GatewayVirtual ServiceDestination Rule
|
| Generate | Generate 버튼을 클릭하세요. 앞에서 입력한 내용을 바탕으로 기본 Yaml이 Yaml 영역에 생성됩니다. |
| Yaml | 기본 Yaml을 수정하여 생성을 원하는 Object의 최종 Yaml을 완성하세요. |
| 저장 | 저장 버튼을 클릭하여 Object를 생성하세요. |
표. Object 추가를 사용해서 Istio object 추가하기 화면 항목
Istio object 수정하기
Istio object를 수정하려면 다음 절차를 따르세요.
- Istio 상세 페이지에서 Istio objects 탭을 클릭하세요.
- Istio objects 탭의 Istio object 목록에서 수정을 원하는 Object를 클릭하세요. Object 팝업창이 열립니다.
- Object 팝업창에서 Yaml을 수정하고 저장 버튼을 클릭해서 Istio object 수정을 완료하세요.
Istio object 삭제하기
Istio object를 삭제하려면 다음 절차를 따르세요.
- Istio 상세 페이지에서 Istio objects 탭을 클릭하세요.
- Istio objects 탭의 Istio object 목록에서 수정을 원하는 Object를 클릭하세요. Object 팝업창이 열립니다.
- Object 팝업창에서 삭제 버튼을 클릭해서 Istio object 삭제를 완료하세요.
헬름릴리스
헬름릴리스 추가하기
Istio에서 사용하는 헬름릴리스를 추가하려면 다음 절차를 따르세요.
- Istio 상세 페이지에서 헬름릴리스 탭을 클릭하세요.
- 헬름릴리스 탭에서 추가 버튼을 클릭하세요. 헬름릴리스 추가 팝업창이 열립니다.
- 헬름릴리스 추가 팝업창에서 각 항목을 입력하고 저장 버튼을 클릭하여 헬름릴리스 추가를 완료하세요.
헬름릴리스 삭제하기
Istio에서 사용하는 헬름릴리스를 삭제하려면 다음 절차를 따르세요.
- Istio 상세 페이지에서 헬름릴리스 탭을 클릭하세요.
- 헬름릴리스 탭에서 삭제하려는 헬름릴리스의 체크박스를 선택하고 삭제 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하여 헬름릴리스 삭제를 완료하세요.
Istio 삭제하기
Istio를 삭제하려면 다음 절차를 따르세요.
- Istio 상세 페이지에서 오른쪽 하단 삭제 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭하여 삭제를 완료하세요.
6 - ArgoCD
ArgoCD란 Kubernetes 환경에 GitOps 배포 시 사용하는 SW 입니다. 사용자는 프로젝트 생성 시 또는 Kubernetes 배포 메뉴를 통해 ArgoCD를 통한 배포를 설정할 수 있습니다.
ArgoCD 시작하기
ArgoCD 애플리케이션의 상세내역을 조회하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 목록에서 시작하려는 ArgoCD 애플리케이션 카드을 클릭하세요. 배포상세 페이지로 이동합니다.
항목 | 설명 |
|---|
| 이름 | ArgoCD 프로젝트명/ArgoCD URL을 표시합니다. |
| Git 정보 | 배포에 사용한 Git 정보를 표시합니다. |
| 클러스터/네임스페이스 | 배포된 클러스터/네임스페이스를 표시합니다. |
| App 상태 | App의 현재 상태를 표시합니다. |
| 배포 결과 | 현재 Sync 상태를 표시합니다. |
| 배포 시간 | 배포 실행 시간을 표시합니다. |
| 새로 고침 | 새로 고침 아이콘을 클릭하면 현재 항목을 새로 고침 합니다. 변경되는 항목은 App 상태, 배포 결과“입니다. |
| 삭제 | 현재 항목을 삭제합니다. |
표. ArgoCD 애플리케이션 상세 항목
항목 | 설명 | |
|---|
| ArgoCD 앱 시크릿 수정 | 애플리케이션 이름 오른쪽의 인증정보 수정 아이콘을 클릭하면 배포에 사용되는 이미지 시크릿을 관리하는 팝업창이 열립니다. | |
| ArgoCD 앱으로 이동 | 실제 ArgoCD 툴의 애플리케이션 상세 화면이 새 창에서 열립니다. | |
표. ArgoCD 배포 상세 항목
ArgoCD 애플리케이션 추가하기
신규 ArgoCD 애플리케이션 생성하고 추가하기 - 헬름 차트로 생성
헬름차트를 이용한 신규 ArgoCD 애플리케이션을 생성하며 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 오른쪽 위쪽의 신규 ArgoCD App 생성 버튼을 클릭하세요. 신규 ArgoCD App 생성 페이지로 이동합니다.
- ArgoCD 정보를 입력 후 확인 버튼을 클릭하세요. 인증정보 입력 항목이 나타납니다.
- 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
- 애플리케이션 기본정보, 배포 대상 K8S 클러스터 입력 항목이 나타납니다.
- 애플리케이션 이름을 입력하고 중복 확인 버튼을 클릭합니다.
- 프로젝트 이름을 입력하세요.
- 저장소 타입을 헬름차트로 신규 저장소 생성으로 선택하세요.
- K8S 클러스터와 네임스페이스를 선택하세요.
- 헬름차트를 선택하세요. 헬름차트 정보와 헬름차트 Git 저장소의 정보가 나타납니다.
- 헬름차트의 K8S 클러스터 Values에 위치한 차트에 포함된 기본 Values.yaml의 내용을 수정한 후 Validation Check 버튼을 클릭하세요.
- 헬름차트 Git 저장소 정보 입력 후 Connection Test 버튼을 클릭하세요.
- Manifest Keys 정보를 입력하세요.
- 생성 버튼을 클릭하여 생성을 완료하세요.
참고
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에 사용될 Git 저장소의 정보를 입력하세요. |
| Manifest Key 정보 | 지속적 배포에 사용될 Manifest 파일/키 정보를 입력하세요. |
표. 신규 ArgoCD 애플리케이션 생성 - 헬름 차트로 생성 설정 항목
신규 ArgoCD 애플리케이션 생성하고 추가하기 - 기존 Git 저장소로 생성
기존 Git 저장소를 이용한 신규 ArgoCD 애플리케이션을 생성하며 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 오른쪽 위쪽의 신규 ArgoCD App 생성 버튼을 클릭하세요. 신규 ArgoCD App 생성 페이지로 이동합니다.
- ArgoCD 정보를 입력 후 확인 버튼을 클릭하세요. 인증정보 입력 항목이 나타납니다.
- 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
- 애플리케이션 기본정보, 배포 대상 K8S 클러스터 입력 항목이 나타납니다.
- 애플리케이션 이름을 입력하고 중복 확인 버튼을 클릭합니다.
- 프로젝트 이름을 입력하세요.
- 저장소 타입을 기존 Git 저장소 사용으로 선택하세요.
- K8S 클러스터와 네임스페이스를 선택하세요.
- 헬름차트를 선택하세요. 헬름차트와 헬름차트 Git 저장소의 정보가 나타납니다.
- 헬름차트의 K8S 클러스터 Values에 위치한 차트에 포함된 기본 Values.yaml의 내용을 수정한 후 Validation Check 버튼을 클릭하세요.
- 헬름차트 Git 저장소 정보 입력 후 Connection Test 버튼을 클릭하세요.
- Manifest Keys에 Manifest Root 경로, Manifest 타입, (Manifest 타입이 Helm일 경우) values.yaml 경로 그리고 배포에 사용될 Manifest 파일 및 Key 정보 (Image repository, Image tag, Image Secret, Deploy Strategy)를 입력하세요.
- 생성 버튼을 클릭하여 생성을 완료하세요.
참고
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 애플리케이션을 추가하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 오른쪽 위쪽의 ArgoCD App 추가 버튼을 클릭하세요. ArgoCD App 추가 페이지로 이동합니다.
- ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
- 기존 애플리케이션 이름과 인증정보의 입력 화면이 나타납니다.
- 기존 애플리케이션 이름과 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
참고
ArgoCD 애플리케이션에 연동된 Git 저장소가 DevOps Console에 등록되어 있지 않다면 URL Check 팝업창이 열립니다. 다음 7~8 단계를 따르세요.
- ArgoCD 애플리케이션에 연동된 Git 저장소를 구분하기위한 URL Check 팝업이 열립니다.
- Base URL 수정 후 확인 버튼을 클릭하세요.
- 애플리케이션에 연동된 Git 저장소 정보가 나타납니다.
- Git 저장소 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
- Manifest Keys 항목 중 변경할
yaml 파일과 키값을 입력하세요. - 정보 입력 후 저장 버튼을 클릭하여 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 애플리케이션의 상세내역을 조회하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- 목록에서 시작하려는 ArgoCD 애플리케이션 카드을 클릭하세요. 배포상세 페이지로 이동합니다.
Manifest 정보 수정하기
Manifest 정보를 수정하려면 다음 절차를 따르세요.
- Git 관련 정보 탭을 클릭하세요.
- Manifest 정보 옆의 편집 아이콘을 클릭하세요. Manifest key 정보 수정 팝업창이 열립니다.
- Manifest key 값을 수정하고 저장 버튼을 클릭하세요.
ArgoCD 인증정보 수정하기
ArgoCD 인증정보를 수정하려면 다음 절차를 따르세요.
- ArgoCD 사용자 ID 옆의 편집 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
- 인증정보 값을 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.
연동 Git 저장소 인증정보 수정하기
연동 Git 저장소의 인증정보를 수정하려면 다음 절차를 따르세요.
- 연동 Git ID 옆의 편집 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
- 인증정보를 수정하고 저장 버튼을 클릭하여 수정을 완료하세요.
Sync 설정하기
Sync 설정을 변경하려면 다음 절차를 따르세요.
- Current Sync 옆의 동기화 아이콘을 클릭하세요. ArgoCD App Sync 팝업창이 열립니다.
- 수정할 내용을 입력하고 동기화 버튼을 클릭하여 Sync 설정을 완료하세요.
| 항목 | 설명 |
|---|
| Revision | 동기화 대상 브랜치를 선택합니다. |
| Sync Options | 동기화 관련 옵션을 선택합니다. |
| Synchronize Resources | 동기화 대상을 선택합니다. |
표. Sync 설정 항목
참고
ArgoCD 동기화와 관련된 자세한 내용은
공식사이트를 참고하세요.
Auto-Sync 설정하기
ArgoCD 애플리케이션의 Auto-Sync 설정을 변경하려면 다음 절차를 따르세요.
- Auto-Sync 옆의 편집 아이콘을 클릭하세요. Auto-Sync 옵션 팝업창이 열립니다.
- 수정하고 저장 버튼을 클릭하여 설정을 완료하세요.
| 항목 | 설명 |
|---|
| Prune Resources | Git 설정이 삭제되는 경우 동기화 대상도 함께 삭제할지 여부를 선택합니다. |
| Self Heal | 클러스터에서 동기화 대상의 값이 변경된 경우 Git에 정의된 값으로 자동으로 변경할지 여부를 선택합니다. |
표. Auto-Sync 설정 항목
애플리케이션 시크릿 관리하기
헬름차트로 생성한 ArgoCD 애플리케이션인 경우, 애플리케이션의 시크릿을 추가/수정/삭제할 수 있습니다.
애플리케이션 시크릿 관리를 시작하려면 다음 절차를 따르세요.
- 애플리케이션 이름 오른쪽의 애플리케이션 시크릿을 클릭하세요.
- 애플리케이션 시크릿 설정 팝업창이 열립니다.
애플리케이션 시크릿 추가하기
애플리케이션 시크릿을 추가하려면 다음 절차를 따르세요.
- 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
- Chart Image를 pull 할 때 사용할 시크릿의 추가가 필요한 경우 Chart Install Secret 영역의 추가 버튼을 클릭하세요.
- 빌드/배포 시 사용하는 App Image를 pull 할 때 사용할 시크릿의 추가가 필요한 경우 ImagePull Secret 영역의 추가 버튼을 클릭하세요.
- 내용을 입력하고 저장 버튼을 클릭하여 추가를 완료하세요.
항목 | 설명 |
|---|
| Registry URL | 이미지 저장소에 등록된 이미지 목록에서 ImagePull Secret이 사용할 이미지를 선택하세요. |
| 시크릿 | ImagePull Secret 정보 입력 방식을 선택- 자동생성: Docker URL에서 선택한 이미지 저장소의 인증정보를 사용해서 자동으로 ImagePull Secret을 생성합니다.
- 기존 시크릿 사용: 이미 생성되어 있는 시크릿 중 하나를 선택하여 ImagePull Secret으로 사용합니다.
|
표. 애플리케이션 시크릿 추가 설정 항목
애플리케이션 시크릿 수정하기
애플리케이션 시크릿을 수정하려면 다음 절차를 따르세요.
- 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
- 애플리케이션 시크릿 목록에서 수정을 원하는 시크릿 이름을 클릭하세요.
- 내용을 입력하고 저장 버튼을 클릭하여 수정을 완료하세요.
애플리케이션 시크릿 삭제하기
애플리케이션 시크릿을 삭제하려면 다음 절차를 따르세요.
- 애플리케이션 이름 옆의 인증정보 수정 아이콘을 클릭하세요. 애플리케이션 시크릿 설정 팝업창이 열립니다.
- 애플리케이션 시크릿 목록에서 삭제를 원하는 시크릿 이름을 클릭하세요.
- 삭제 버튼을 클릭하여 삭제를 완료하세요.
Values.yaml 파일 비교하기
헬름차트를 이용한 ArgoCD 애플리케이션인 경우 values.yaml 파일을 비교할 수 있습니다.
각 릴리스에 사용한 values.yaml 파일을 비교하려면 다음 절차를 따르세요.
- 내역 탭을 클릭하세요.
- 비교를 원하는 2개 리비전을 클릭하세요.
- App Diff 버튼을 클릭하세요. App Diff 팝업창이 열립니다.
애플리케이션 롤백하기
애플리케이션을 이전 리비전으로 롤백하려면 다음 절차를 따르세요.
- 내역 탭을 클릭하세요.
- 롤백을 원하는 리비전의 롤백 커럼의 롤백 버튼을 클릭하세요. 롤백 팝업창이 열립니다.
- 확인 버튼을 클릭하여 롤백을 완료하세요.
애플리케이션 삭제하기
애플리케이션을 삭제하려면 다음 절차를 따르세요.
- 오른쪽 아래의 삭제 버튼을 클릭하세요. 애플리케이션 삭제 팝업이 열립니다.
- 확인 버튼을 클릭하여 삭제를 완료하세요.
참고
DevOps Console에서만 삭제되며, 실제 ArgoCD 애플리케이션은 삭제되지 않습니다.