배포 실행 및 관리
  • PDF

배포 실행 및 관리

  • PDF

배포 실행 및 관리에서 생성한 배포 시나리오를 배포 타깃에 배포하는 방법을 설명합니다. 권한에 따라 배포를 직접 실행하거나 승인 요청 및 승인을 통해 배포할 수 있습니다.

배포 실행

주의

배포 타깃이 Kubernetes Service이며 배포 전략이 Rolling 또는 블루/그린인 경우, 배포 중에 배포를 취소할 수 없습니다. 배포가 필요한 경우에만 배포를 실행해 주십시오.

참고

배포를 실행하려면 고객 계정 또는 doDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 Sub Account 사용 가이드를 참고해 주십시오.

배포를 실행하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

  2. Services > Developer Tools > SourceDeploy 메뉴를 차례대로 클릭해 주십시오.

  3. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 [배포로 이동] 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.

  4. 배포할 시나리오를 클릭해 주십시오.

  5. 배포 시나리오의 정보와 설정을 확인해 주십시오.

    • 배포 타깃을 상세 확인하려면 [확인] 버튼을 클릭해 주십시오.
    • 배포 파일의 설정을 변경하려면 배포 파일[설정 변경] 버튼을 클릭해 주십시오.
    • 배포 명령어를 변경하려면 배포 명령어[설정 변경] 버튼을 클릭해 주십시오.
    • 배포 경로를 변경하려면 배포 경로[설정 변경] 버튼을 클릭해 주십시오.
    • 매니페스트 파일을 확인하려면 [Show File] 버튼을 클릭해 주십시오.
    • 배포 실패 시 롤백 여부를 변경할 수 있습니다.
    참고
    • 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
    • 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
  6. [배포 시작하기] 버튼을 클릭해 주십시오.

    • 배포가 시작되며, 배포 작업 결과 화면으로 이동합니다.
    • 배포를 취소하려면 [취소] 버튼을 클릭해 주십시오.
참고

Kubernetes Service 클러스터에 오브젝트 배포 시

  • 오브젝트 업데이트 시 동일한 네임스페이스(namespace)로만 업데이트할 수 있습니다.
  • 매니페스트의 kind에 상관없이 SourceDeploy는 배포 전략 메커니즘에 따라 배포를 수행합니다.
  • 매니페스트가 여러 개일 경우 하나라도 실패하면 모든 오브젝트가 롤백됩니다.
  • Replica Set, Replication Controller와 같은 종류의 오브젝트는 업데이트가 되더라도 Kubernetes spec에 따라 이미지가 업데이트되지 않습니다. 다음 Kubernetes 권장 사항을 확인하여 배포해 주십시오.

배포 승인 요청

참고

배포 승인을 요청하려면 doDeploy 권한을 가지지 않으며, requestDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 Sub Account 사용 가이드를 참고해 주십시오.

주의

배포 승인 요청은 취소할 수 없습니다. 배포가 필요한 경우에만 승인 요청해 주십시오.

배포 승인을 요청하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

  2. Services > Developer Tools > SourceDeploy 메뉴를 차례대로 클릭해 주십시오.

  3. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 [배포로 이동] 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.

  4. 배포할 시나리오를 클릭해 주십시오.

  5. 배포 시나리오의 정보와 설정을 확인한 후 [배포 승인 요청] 버튼을 클릭해 주십시오.

    • 배포 타깃을 상세 확인하려면 [확인] 버튼을 클릭해 주십시오.
    • 배포 파일의 설정을 변경하려면 배포 파일[설정 변경] 버튼을 클릭해 주십시오.
    • 배포 명령어를 변경하려면 배포 명령어[설정 변경] 버튼을 클릭해 주십시오.
    • 배포 경로를 변경하려면 배포 경로[설정 변경] 버튼을 클릭해 주십시오.
    • 매니페스트 파일을 확인하려면 [Show File] 버튼을 클릭해 주십시오.
    • 배포 실패 시 롤백 여부를 변경할 수 있습니다.
    참고
    • 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
    • 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
  6. 배포 승인 요청 팝업 창의 [확인] 버튼을 클릭해 주십시오.

    • 배포 승인 권한(approveDeploy)을 가진 사용자에게 배포 승인을 요청합니다.
주의

배포 승인 요청에 대해 이메일 또는 SMS 알림 기능이 제공되지 않습니다.

배포 승인/거절

참고

배포 승인 요청에 대해 승인 또는 거절하려면 고객 계정 또는 approveDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 Sub Account 사용 가이드를 참고해 주십시오.

배포 승인 요청에 대해 승인 또는 거절하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

  2. Services > Developer Tools > SourceDeploy 메뉴를 차례대로 클릭해 주십시오.

  3. 배포를 승인/거절할 시나리오가 포함된 배포 프로젝트를 선택한 후 [배포로 이동] 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.

  4. [작업 결과] 탭을 클릭해 주십시오.

  5. 상태가 배포 승인 대기 중인 시나리오의 [승인] 버튼을 클릭해 주십시오.

  6. 시나리오 배포 승인 여부에 따라 배포 승인 팝업 창에서 [승인] 또는 [승인 안함] 버튼을 클릭해 주십시오.

    • 배포가 시작됩니다.
    • 배포를 취소하려면 [취소] 버튼을 클릭해 주십시오.

배포 작업 결과 확인

배포 작업 결과를 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

  2. Services > Developer Tools > SourceDeploy 메뉴를 차례대로 클릭해 주십시오.

  3. 배포 작업 결과를 확인할 배포 프로젝트를 선택한 후 [배포로 이동] 버튼을 클릭하거나 해당 배포 프로젝트의 이름을 클릭해 주십시오.

  4. [작업 결과] 탭을 클릭해 주십시오.

  5. 작업 결과를 확인할 내역을 클릭해 주십시오.

    • 배포 요약배포 로그 정보를 확인할 수 있습니다.
      • 로그는 최대 30일까지 저장합니다.
    주의

    배포 로그/var/sourcedeploy/log 경로에 저장되며, 해당 경로를 삭제할 경우 배포 로그를 확인할 수 없습니다.

배포 작업 결과 화면

배포 작업 결과 화면은 다음과 같이 구성되어 있습니다.

sourcedeploy-deploy_result_ko

영역 설명
① 프로젝트명 배포 프로젝트 이름 표시
② 작업 결과 목록 정보 작업 결과 목록에 표시되는 정보(배포 시나리오 이름, 배포 Stage, 배포 요청자, 배포 요청 시간, 배포 상태)
  • 배포 상태에 따라 버튼 표시
      • 배포 중인 경우 [취소] 버튼이 표시되며, 클릭하여 배포 취소 가능
      • 배포 승인 대기 중인 경우 [승인] 버튼이 표시되며, 클릭하여 배포 승인 가능(단, 배포 승인 권한이 있는 경우에만 승인 가능)
  • 배포 요약 배포 타깃에 따라 배포 요약 정보(배포 상태, 배포 요청 시간, 배포 종료 시간, 배포 파일, Canary 분석 리포트, 백업 파일) 표시
  • 배포 상태
      • 배포 승인 대기 중: 배포 권한이 없는 사용자로부터 배포 승인 요청된 상태
      • 배포 승인 거절됨: 배포 승인 요청이 거절된 상태
      • 배포 중: 배포가 실행되고 있는 상태
      • 배포 취소: 배포 실행 중 취소된 상태
      • 배포 완료: 배포가 완료된 상태
      • 배포 실패: 배포를 실패한 상태
  • 배포 로그 배포 단계별로 수집된 로그 표시
    참고
    • 배포를 취소하면 현재 실행 중인 단계까지 진행되고 이후 단계는 진행되지 않습니다.
    • 배포 취소 또는 배포 실패 시 블루/그린 배포로 생성된 Auto Scaling Group이나 서버는 자동으로 반납되지 않습니다. Auto Scaling Group 또는 서버가 더 이상 필요하지 않은 경우, 직접 해당 서비스에서 반납/삭제해 주십시오.
    • Canary 수동 배포를 취소하는 경우, Canary 버전이 배포되지 않으며 Baseline, Canary 버전의 애플리케이션이 종료됩니다.

    배포 단계 상세 확인

    배포 타깃별 배포 단계는 다음과 같습니다.

    배포 타깃
    배포 단계
    설명
    Server 또는
    Auto Scaling(기본)
    서버명 배포 에이전트 상태 확인
    배포 전 실행 배포 전 명령어 수행
    파일 배포 설정한 경로에 파일 배포
    배포 후 실행 배포 후 명령어 수행
    Auto Scaling(블루/그린) 배포 준비 블루/그린 배포를 위한 사전 준비 수행
  • 새 Auto Scaling Group 생성
  • 새 Auto Scaling Group 내 서버 생성 완료 대기
  • 새 그룹에 배포 새 Auto Scaling Group 내 서버에 대해 배포 에이전트 상태 확인
    새 그룹 검증 새 Auto Scaling Group 검증
  • 새 Auto Scaling Group 내 생성된 서버를 로드밸런서에 연결
  • 로드밸런서 헬스 체크가 정상인지 확인(모든 헬스 체크를 성공해야 다음 단계로 진행, 타임 아웃(1시간) 내 헬스 체크를 실패할 경우 배포는 실패로 종료)
  • 배포 마무리 블루/그린 배포 마무리 수행
  • 기존 그룹 내 서버에 설정된 값에 때라 기존 Auto Scaling Group 내 서버 처리
  • 기존 Auto Scaling Group에 연결된 Cloud Insight 이벤트 존재 시 이벤트 복사
  • Kubernetes Service 배포 준비 배포 준비
  • kubectl 로드
  • 클러스터 접근
  • 매니페스트 파일 다운로드
  • 매니페스트 파일 로드
  • 배포 배포 진행
    Object Storage 배포 준비 배포 준비
  • 백업 파일 다운로드
  • 백업 파일 압축
  • 백업 파일 업로드
  • 배포 배포 진행
  • 배포 파일 다운로드
  • 배포 파일 압축 해제
  • 배포 파일 업로드
  • Canary 분석 리포트 확인

    배포 전략이 Canary이면서 분석 방법이 자동인 경우, Canary 분석 리포트를 확인할 수 있습니다.

    배포 작업 결과 화면에서 Canary 분석 리포트리포트를 클릭해 주십시오. Canary 분석 화면이 나타납니다.

    Canary 분석 화면은 다음과 같이 구성되어 있습니다.

    sourcedeploy-use-deploy_canary_ko

    영역 설명
    ① 분석 단계
  • Canary 자동 분석 설정 시 설정한 분석 시간, 분석 주기로 분석 단계 결정
  • 분석 데이터는 누적되어 분석
    <예시> 분석 시간이 10분이고 분석 주기가 3분인 경우, 10분 동안 3분마다 총 4번의 분석 단계 점수가 나오며 마지막 분석 단계 시간은 1분
  • ② 분석 점수 분석 단계 점수 표시
  • 해당 점수가 분석 성공 점수 이상이 되어야 성공이며, 분석에 실패할 경우 다음 분석 미진행
  • ③ 분석 정보 분석 시간 및 분석 성공 점수(Pass), Metric 수집 주기(Step) 표시
    ④ Metric 정보 Canary 자동 분석 설정 시 설정한 Metric과 Weight(가중치) 표시
  • Metric 클릭 시 Canary 분석 결과 표시
  • ⑤ 분석 결과 목록 Canary 분석 결과 표시
  • 종류: Baseline(Baseline 버전 쿼리의 질의 결과), Canary(Canary 버전 쿼리의 질의 결과)
  • 시작 시간/종료 시간: 분석이 시작된 시간/완료된 시간
  • Count: 분석 시간 동안 나온 실제 데이터 개수
  • Avg: 데이터 평균 값
  • Max: 데이터 최댓값
  • Min: 데이터 최솟값
  • Element 결과 Prometheus 질의 결과에서 나온 데이터의 Element 값 표시
  • Baseline과 Canary 질의 결과의 Element가 같아야 정상적으로 분석 진행
  • 클릭하여 Element 확인
  • 편차 Baseline 값 대비 Canary 값의 증가/감소율 표시
    결과 Baseline 기준 Canary의 편차로 계산된 결과 표시
  • Metric 생성 시 설정한 성공 기준에 따라 결과(성공/실패) 결정
      • Baseline 버전의 결과와 Canary 버전의 결과가 같을 경우 성공(오차 범위 5%)
        <예시> -5≤편차≤+5 일 경우, 성공으로 결정
  • 참고
    • Canary 분석 리포트는 설정된 Prometheus의 보관 주기 동안만 확인할 수 있습니다.
    • 분석 단계 점수 계산 방법
      • Metric 점수: (성공한 질의 결과/전체 질의 결과)*(메트릭 가중치)
        <예시>
        • Metric Name: success_rate1
          성공 질의 결과: 2개(#1, #3)
          전체 질의 결과: 3개(#1, #2, #3)
          Weight: 30
          Metric 점수: (2/3)*30=20
        • Metric Name: success_rate2
          성공 질의 결과: 1개(#1)
          전체 질의 결과: 1개(#1)
          Weight: 70
          Metric 점수: (1/1)*70=70
        • 분석 단계 점수: 20+70=90

    이 글이 도움이 되었나요?