롤백, 점진적 출시, 트래픽 마이그레이션

Knative serving을 사용하면 트래픽을 수신할 버전을 지정하고 특정 버전에 수신되는 트래픽 백분율을 지정할 수 있습니다. 이 기능을 사용하면 이전 버전으로 롤백하고, 버전을 점진적으로 출시(블루-그린 배포라고도 함)하고, 여러 버전 간에 트래픽을 분할 할 수 있습니다. 이 페이지에서는 이 기능을 사용하여 Knative serving 버전에 대한 트래픽을 관리하는 방법을 설명합니다.

이전 버전으로 롤백

이전 버전으로 롤백하려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Knative serving으로 이동합니다.

    Knative serving으로 이동

  2. 서비스 목록에서 서비스를 찾고 클릭합니다.

  3. 버전 탭을 클릭하여 해당 서비스의 현재 버전 목록을 표시합니다.

  4. 버전 목록에서 롤백하려는 버전의 오른쪽에 있는 줄임표 아이콘을 클릭합니다.

  5. 트래픽 관리를 클릭하여 트래픽 관리 양식을 표시합니다.

    1. 드롭다운 목록에서 롤백하려는 이전 버전을 선택합니다.
    2. 이전 버전의 트래픽 백분율을 100으로 설정합니다.
    3. 현재 제공 중인 버전의 백분율을 0으로 설정합니다.
    4. 저장을 클릭합니다.

명령줄

다음 명령어를 사용하세요.

gcloud run services update-traffic SERVICE --to-revisions REVISION=100

  • SERVICE를 서비스 이름으로 바꿉니다.
  • REVISION을 롤백할 버전의 이름으로 바꿉니다.

YAML

--format=export 플래그를 사용하여 gcloud run services describe 명령어로 YAML 파일에 기존 서비스 구성을 다운로드할 수 있습니다. 그런 다음 gcloud run services replace 명령어로 YAML 파일을 수정하고 변경사항을 배포할 수 있습니다. 지정된 속성만 수정해야 합니다.

  1. 서비스 구성을 로컬 작업공간의 service.yaml 파일에 다운로드합니다.

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE를 Knative serving 서비스의 이름으로 바꿉니다.

  2. 로컬 파일에서 spec에 있는 traffic 속성을 업데이트합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
spec:
...
  traffic:
  - revisionName: REVISION
    percent: 100

    다음과 같이 바꿉니다.

    • REVISION을 롤백할 버전의 이름으로 바꿉니다.

  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

점진적인 버전 출시

새 버전을 점진적으로 출시(블루-그린 배포)하려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Knative serving으로 이동합니다.

    Knative serving으로 이동

  2. 서비스 목록에서 서비스를 찾고 클릭합니다.

  3. 새 버전 배포를 클릭합니다.

  4. 필요에 따라 배포 양식을 작성하고 이 버전을 즉시 제공 라벨이 표시된 체크박스가 선택 해제되었는지 확인합니다.

  5. 배포를 클릭합니다.

  6. 트래픽 관리를 클릭합니다.

  7. 새 버전이 나열되지만 백분율이 0으로 설정되어 있으면 현재 트래픽을 제공하지 않는 것입니다. 다음 안내를 따라 양식을 작성하세요.

    1. 원하는 백분율로 설정합니다(예: 5). 현재 제공 중인 버전의 백분율이 동일한 크기로 자동으로 줄어듭니다.
    2. 저장을 클릭합니다.
    3. 트래픽 관리 단계를 반복하되 백분율을 변경하여 새 버전에 필요한 만큼 백분율을 늘립니다. 트래픽 백분율을 변경하기 위해 다시 배포할 필요는 없습니다.

명령줄

  1. 처음에는 트래픽을 수신하지 않도록 설정하고, 점진적으로 출시할 버전을 배포하려면 --no-traffic 매개변수와 함께 update 명령어를 사용합니다.

    gcloud run deploy --image IMAGE --no-traffic

    IMAGE를 배포할 이미지로 바꿉니다.

  2. 새 버전이 처리할 트래픽 백분율을 지정합니다(예: 5퍼센트).

    gcloud run services update-traffic SERVICE --to-revisions REVISION=PERCENTAGE
    • SERVICE를 서비스 이름으로 바꿉니다.
    • REVISION을 점진적으로 출시할 버전의 이름으로 바꿉니다. 최신 버전을 지정하려면 LATEST를 사용할 수 있습니다(예: LATEST=5).
    • PERCENTAGE를 새 버전으로 보낼 트래픽의 백분율로 바꿉니다. 예를 들어 5로 설정하면 트래픽의 5%를 보내게 됩니다.

  3. 버전 성능이 만족스러우면 앞의 update-traffic 단계를 반복하되 백분율 값을 원하는 값으로 늘립니다.

YAML

--format=export 플래그를 사용하여 gcloud run services describe 명령어로 YAML 파일에 기존 서비스 구성을 다운로드할 수 있습니다. 그런 다음 gcloud run services replace 명령어로 YAML 파일을 수정하고 변경사항을 배포할 수 있습니다. 지정된 속성만 수정해야 합니다.

  1. 서비스 구성을 로컬 작업공간의 service.yaml 파일에 다운로드합니다.

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE를 Knative serving 서비스의 이름으로 바꿉니다.

  2. 다양한 구성 페이지의 설명대로 서비스 구성을 원하는 대로 변경하고 새 버전에 사용할 버전 이름을 지정합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
template:
  metadata:
    annotations:
      ...
    name: REVISION-NAME
 ```

Replace
    • REVISION-NAME을 새 버전에 사용할 이름으로 바꿉니다.

  3. spec 속성 아래에서 traffic 속성을 찾아 업데이트하여 새 버전이 소량의 트래픽만 처리하도록 합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
spec:
...
  traffic:
  - revisionName: REVISION-NEW
    percent: PERCENT-NEW
  - revisionName: REVISION-FORMER
    percent: PERCENT-FORMER

    백분율을 합치면 100이 되어야 합니다. 다음과 같이 바꿉니다.

    • REVISION-NEW를 점진적으로 출시할 버전의 이름으로 바꿉니다.
    • REVISION-FORMER를 현재 처리 중인 버전의 이름으로 바꿉니다.
    • PERCENT-NEW를 새 버전으로 전송하려는 트래픽 백분율로 바꿉니다. 예를 들어 10을 지정하면 트래픽의 10%가 버전으로 전송됩니다.
    • PERCENT-FORMER를 이전 버전으로 전송하려는 트래픽 백분율로 바꿉니다.

여러 버전 간 트래픽 분할

두 개 이상의 버전 간에 트래픽을 분할하려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Knative serving으로 이동합니다.

    Knative serving으로 이동

  2. 서비스 목록에서 서비스를 찾고 클릭합니다.

  3. 트래픽 관리를 클릭합니다.

  4. 현재 제공 중인 새 버전이 나열됩니다. 다음 안내를 따라 양식을 작성하세요.

    1. 현재 제공 중인 버전 백분율을 원하는 분할로 설정합니다.
    2. 드롭다운 목록에서 이전 버전 중 하나를 선택하고 이를 원하는 백분율 분할로 설정합니다.
    3. 더 많은 버전으로 트래픽을 분할하려면 버전 추가를 클릭하고 원하는 버전을 선택한 다음 원하는 분할로 백분율을 설정합니다.
    4. 저장을 클릭합니다.

명령줄

버전 및 각 버전의 트래픽 백분율을 쉼표로 구분된 목록으로 지정합니다.

gcloud run services update-traffic SERVICE --to-revisions LIST

다음과 같이 바꿉니다.

  • SERVICE을 서비스 이름으로 바꿉니다.
  • LIST을 트래픽을 수신하려는 쉼표로 구분된 수정 목록과 해당 트래픽의 비율(총 100퍼센트)로 바꿉니다.
    REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEn
    (예: hello2-00005-red=25,hello2-00001-bod=25,hello2-00002-nan=50)

YAML

--format=export 플래그를 사용하여 gcloud run services describe 명령어로 YAML 파일에 기존 서비스 구성을 다운로드할 수 있습니다. 그런 다음 gcloud run services replace 명령어로 YAML 파일을 수정하고 변경사항을 배포할 수 있습니다. 지정된 속성만 수정해야 합니다.

  1. 서비스 구성을 로컬 작업공간의 service.yaml 파일에 다운로드합니다.

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE를 Knative serving 서비스의 이름으로 바꿉니다.

  2. 로컬 버전에서 traffic 속성을 업데이트하여 새 버전이 소량의 트래픽만 제공하도록 합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
spec:
...
  traffic:
  - revisionName: REVISION-A
    percent: PERCENT-A
  - revisionName: REVISION-B
    percent: PERCENT-B
  - revisionName: REVISION-C
    percent: PERCENT-C

    백분율을 합치면 100이 되어야 합니다. 다음과 같이 바꿉니다.

    • REVISION-A, REVISION-B, REVISION-C를 트래픽을 할당할 버전으로 바꿉니다.
    • PERCENT-A, PERCENT-B, PERCENT-C를 해당하는 버전의 백분율로 바꿉니다.

  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

최신 버전으로 모든 트래픽 전송

새 버전을 배포할 때 기존의 트래픽 분할을 재정의하여 이 버전 및 이후의 모든 버전이 최대한 빨리 100%의 트래픽을 제공하도록 설정할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Knative serving으로 이동합니다.

    Knative serving으로 이동

  2. 서비스 목록에서 서비스를 찾고 클릭합니다.

  3. 새 버전 배포를 클릭합니다.

  4. 필요에 따라 배포 양식을 작성하고 이 버전을 즉시 제공 라벨이 표시된 체크박스를 선택합니다. 그러면 기존 트래픽 분할이 재정의되어 새 버전이 트래픽을 100% 제공합니다.

  5. 배포를 클릭합니다.

명령줄

최근에 배포된 버전으로 모든 트래픽을 전송하려면 다음 안내를 따르세요.

gcloud run services update-traffic SERVICE --to-latest

SERVICE를 서비스 이름으로 바꿉니다.

YAML

--format=export 플래그를 사용하여 gcloud run services describe 명령어로 YAML 파일에 기존 서비스 구성을 다운로드할 수 있습니다. 그런 다음 gcloud run services replace 명령어로 YAML 파일을 수정하고 변경사항을 배포할 수 있습니다. 지정된 속성만 수정해야 합니다.

  1. 서비스 구성을 로컬 작업공간의 service.yaml 파일에 다운로드합니다.

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE를 Knative serving 서비스의 이름으로 바꿉니다.

  2. 로컬 파일에서 spec에 있는 traffic 속성을 업데이트합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
spec:
...
  traffic:
  - latestRevision: true
    percent: 100

  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

테스트, 트래픽 마이그레이션, 롤백에 태그 사용

서비스를 배포한 후에는 새 버전을 만들어서 트래픽을 제공하지 않고도 특정 URL에서 버전에 액세스할 수 있는 태그를 할당할 수 있습니다. 그러면 이 태그를 사용하여 트래픽을 태그가 지정된 버전으로 점진적으로 마이그레이션하고 태그가 지정된 버전을 롤백할 수 있습니다.

이 기능의 일반적인 사용 사례는 트래픽을 제공하기 전에 다음과 같은 일반적인 시퀀스로 새 서비스 버전을 테스트 및 조사하는 것입니다.

  1. 개발 중에 컨테이너에서 통합 테스트를 실행합니다.
  2. 트래픽을 제공하지 않고 스테이징에만 사용하는 Google Cloud 프로젝트에 컨테이너를 배포하고 태그가 지정된 버전을 대상으로 테스트합니다.
  3. 트래픽을 제공하지 않고 프로덕션에 배포하고 프로덕션에서 태그가 지정된 버전을 대상으로 테스트합니다.
  4. 태그가 지정된 버전으로 트래픽을 마이그레이션합니다.

태그가 지정된 새 버전 배포

기존 서비스의 새 버전을 프로덕션에 배포하려면 다음을 실행합니다.

gcloud run deploy myservice --image IMAGE_URL  --no-traffic --tag TAG_NAME

다음과 같이 바꿉니다.

  • IMAGE_URL을 이미지의 URL로 바꿉니다.
  • TAG_NAME을 소문자 태그 이름으로 바꿉니다.

태그를 사용하면 트래픽을 제공하지 않고도 특정 URL에서 새 버전을 직접 테스트할 수 있습니다. 테스트 URL은 제공한 태그 이름(http://{TAG_NAME}---{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io)으로 시작됩니다.

예를 들어 myservice 서비스에 태그 이름 green을 사용한 경우 URL https://green---myservice.default.kuberun.11.111.11.111.nip.io에서 태그가 지정된 버전을 테스트합니다.

태그가 지정된 버전으로 트래픽 마이그레이션

새 버전이 제대로 작동하는지 확인한 후 Google Cloud 콘솔, gcloud 명령줄, YAML 파일을 사용하여 해당 버전으로 트래픽 마이그레이션을 시작할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Knative serving으로 이동합니다.

    Knative serving으로 이동

  2. 서비스 목록에서 서비스를 찾고 클릭합니다.

  3. 트래픽을 전송할 태그가 지정된 버전을 선택합니다.

  4. 트래픽 관리를 클릭합니다.

  5. 태그가 지정된 버전 이름을 찾습니다. 이 버전이 나열되지만 백분율이 0으로 설정되어 있으면 현재 트래픽을 제공하지 않는 것입니다. 트래픽 관리* 양식에서 다음을 수행합니다.

    1. 원하는 백분율로 설정합니다(예: 5). 현재 제공 중인 버전의 백분율이 동일한 크기로 자동으로 줄어듭니다.
    2. 저장을 클릭합니다.
    3. 몇 시간 또는 며칠에 걸쳐 필요에 따라 트래픽 관리 단계를 반복하되 태그가 지정된 버전에 필요한 만큼 백분율을 늘리면서 변경된 백분율로 반복합니다. 트래픽 백분율을 변경하기 위해 다시 배포할 필요는 없습니다.

명령줄

특정 버전 태그로 트래픽을 마이그레이션하려면 다음을 실행합니다.

gcloud run deploy update-traffic myservice --tag TAG_NAME=TRAFFIC_PERCENT

다음과 같이 바꿉니다.

  • TAG_NAME을 트래픽을 마이그레이션할 태그의 이름으로 바꿉니다.
  • TRAFFIC_PERCENT를 태그가 지정된 버전에서 제공할 트래픽의 백분율로 바꿉니다(예: 1).

YAML

--format=export 플래그를 사용하여 gcloud run services describe 명령어로 YAML 파일에 기존 서비스 구성을 다운로드할 수 있습니다. 그런 다음 gcloud run services replace 명령어로 YAML 파일을 수정하고 변경사항을 배포할 수 있습니다. 지정된 속성만 수정해야 합니다.

  1. 서비스 구성을 로컬 작업공간의 service.yaml 파일에 다운로드합니다.

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE를 Knative serving 서비스의 이름으로 바꿉니다.

  2. 다양한 구성 페이지의 설명대로 서비스 구성을 원하는 대로 변경합니다.

  3. spec 속성 아래에서 태그가 지정된 버전의 traffic 속성을 찾아 업데이트하여 태그가 지정된 버전이 소량의 트래픽만 제공하도록 합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
 name: SERVICE
spec:
...
  traffic:
  - revisionName: REVISION
    tag: TAG_NAME
    percent: PERCENT-NEW
  - revisionName: REVISION-FORMER
    percent: PERCENT-FORMER

    백분율을 합치면 100이 되어야 합니다. 다음과 같이 바꿉니다.

    • REVISION을 태그가 지정된 버전의 이름으로 바꿉니다.
    • TAG_NAME을 점진적으로 출시할 태그의 이름으로 바꿉니다.
    • PERCENT-NEW를 태그가 지정된 버전으로 전송할 트래픽 백분율로 바꿉니다. 예를 들어 트래픽의 10%를 해당 버전으로 전송하려면 10을 사용합니다.
    • REVISION-FORMER를 현재 처리 중인 버전의 이름으로 바꿉니다.
    • PERCENT-FORMER를 이전 버전으로 전송하려는 트래픽 백분율로 바꿉니다.

  4. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml