카나리 배포
사용자는 카나리 배포를 추가할 수 있습니다.
카나리 추가는 두개의 헬름릴리스를 묶어 카나리 테스트를 할 수 있도록 설정하는 것을 의미합니다.
프로젝트, 클러스터, 릴리스 타입, 차트명, 차트버전, 개발 구분이 모두 같은 두 개의 헬름릴리스만 묶을 수 있습니다.
카나리 배포 시작하기
카나리 이용을 시작하려면 다음 절차를 따르세요.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
항목 설명 이름 카나리 이름을 표시합니다. 클릭해서 상세 정보를 볼 수 있습니다. 클러스터 배포된 클러스터를 표시합니다. (운영) 현재 운영 중인 헬름릴리스를 표시합니다. (카나리) 카나리 중인 헬름릴리스를 표시합니다. 종료 카나리를 종료합니다. 표. Kubernetes 배포 화면 카나리 카드 항목 - Kubernetes 배포 페이지의 배포 목록에서 이용하려는 카나리의 이름을 클릭하세요. 배포상세 페이지로 이동합니다.
카나리 추가하기
카나리를 추가하려면 다음 절차를 따르세요.
참고
카나리는 다음 환경에서 지원됩니다. 카나리 추가 전 확인하세요.
Kubernetesv1.17이상nginx-ingressv0.29.0이상
안내
카나리 추가를 위해서는 동일한 차트를 사용해서 헬름인스톨 된 2개의 헬름릴리스가 필요합니다.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
- Kubernetes 배포 페이지의 우측 상단 카나리 추가 버튼을 클릭하세요. 카나리 추가 팝업창이 열립니다.
- 카나리 추가 팝업창에서 정보 입력 후 저장 버튼을 클릭하여 카나리 추가를 완료합니다.
항목 설명 구분 개발, 운영을 선택합니다. - 개발, 운영 구분에 따라 각 역할자 별 할 수 있는 Action이 달라집니다. (표. 프로젝트 내 각 역할자별 권한(2))
카나리 명 카나리 이름을 입력합니다. 운영 - 릴리스 이름: 현재 운영중인 헬름릴리스의 이름을 목록에서 선택합니다.
- 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파일을 수정할 수 있습니다. - 미수행: 운영 헬름릴리스에 변경이 없이 카나리만 종료합니다.
표. 카나리 종료 선택 항목