클러스터 알림 수신

이 페이지에서는 Pub/Sub에서 Google Kubernetes Engine(GKE) 클러스터에 대한 알림을 수신하는 방법을 보여줍니다.

개요

중요한 예약 업그레이드 또는 사용 가능한 보안 게시판과 같이 GKE 클러스터와 관련된 특정 이벤트가 발생하면 GKE는 해당 이벤트에 대한 알림을 구성한 Pub/Sub 주제에 메시지로 게시합니다. Pub/Sub 구독에서 이러한 알림을 수신하고 타사 서비스와 통합하고 수신하려는 알림 유형을 필터링할 수 있습니다.

클러스터 알림의 이점, 알림의 작동 원리, 필터링이 중요한 이유에 대해 자세히 알아보려면 클러스터 알림을 참조하세요. 신규 및 기존 Standard 클러스터에서, 기존 Autopilot 클러스터를 업데이트하여 클러스터 알림을 구성할 수 있습니다.

시작하기 전에

시작하기 전에 다음 태스크를 수행했는지 확인합니다.

Google Kubernetes Engine API를 사용 설정합니다.

Google Kubernetes Engine API 사용 설정

이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 가져옵니다.
참고: 기존 gcloud CLI 설치의 경우 compute/region 및 compute/zone 속성을 설정해야 합니다. 기본 위치를 설정하면 gcloud CLI에서 One of [--zone, --region] must be supplied: Please specify location과 같은 오류를 방지할 수 있습니다.

프로젝트에서 Pub/Sub 주제를 만듭니다.

새 클러스터에서 클러스터 알림 사용 설정

Google Cloud CLI 또는 Google Cloud 콘솔을 사용하여 새 Standard 클러스터에서 GKE 클러스터 알림을 사용 설정할 수 있습니다. Autopilot 클러스터에서 알림을 사용 설정하려면 먼저 Autopilot 클러스터를 만든 다음 클러스터 알림을 사용하도록 클러스터를 업데이트해야 합니다.

gcloud

새 클러스터에서 클러스터 알림을 사용 설정하려면 다음 명령어를 실행하세요.

gcloud container clusters create CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

다음을 바꿉니다.

CLUSTER_NAME: 새 클러스터의 이름입니다.
COMPUTE_REGION: 새 클러스터의 컴퓨팅 리전입니다. 영역 표준 클러스터의 경우 --zone=COMPUTE_ZONE을 사용합니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.
TOPIC_NAME: Pub/Sub 주제의 이름입니다.
NOTIFICATION_TYPE: 수신하려는 알림 유형을 파이프(|)로 구분한 목록입니다. 예를 들어 filter="UpgradeEvent|SecurityBulletinEvent"는 UpgradeEvent 및 SecurityBulletinEvent 알림만 전송하고 다른 모든 유형은 무시합니다.

참고: filter 값을 지정하지 않으면 클러스터 구성에 적용 가능한 모든 알림을 수신하게 됩니다.

콘솔

새 Standard 클러스터에서 클러스터 알림을 사용 설정하려면 다음을 수행하세요.

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
만들기를 클릭합니다.
클러스터 만들기 대화상자에서 GKE 표준 옆에 있는 구성을 클릭합니다.
탐색창의 클러스터 섹션에서 자동화를 클릭합니다.
알림 사용 설정 체크박스를 선택합니다.
드롭다운 목록에서 앞서 만든 Pub/Sub 주제를 선택합니다.
알림을 필터링하려면 알림 유형 필터링 체크박스를 선택한 후 수신할 알림 유형을 선택합니다.

참고: 필터링할 알림 유형을 선택하지 않으면 모든 관련 알림을 수신하게 됩니다.
계속해서 클러스터를 원하는 대로 구성합니다.
만들기를 클릭합니다.

알림을 사용 설정한 후 주제에 대한 Pub/Sub 구독을 만듭니다.

기존 클러스터에서 클러스터 알림 사용 설정

Google Cloud CLI 또는 Google Cloud 콘솔을 사용하여 기존 클러스터에서 GKE 클러스터 알림을 사용 설정할 수 있습니다.

gcloud

기존 클러스터에서 클러스터 알림을 사용 설정하려면 다음 명령어를 실행하세요.

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME,filter=NOTIFICATION_TYPE

다음을 바꿉니다.

CLUSTER_NAME: 클러스터 이름입니다.
COMPUTE_REGION: 새 클러스터의 컴퓨팅 리전입니다. 영역 표준 클러스터의 경우 --zone=COMPUTE_ZONE을 사용합니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.
TOPIC_NAME: Pub/Sub 주제의 이름입니다.
NOTIFICATION_TYPE: 수신하려는 알림 유형을 파이프(|)로 구분한 목록입니다. 예를 들어 filter="UpgradeEvent|SecurityBulletinEvent"는 UpgradeEvent 및 SecurityBulletinEvent 알림만 전송하고 다른 모든 유형은 무시합니다.

참고: filter 값을 지정하지 않으면 클러스터 구성에 적용 가능한 모든 알림을 수신하게 됩니다.

콘솔

기존 클러스터에서 클러스터 알림을 사용 설정하려면 다음을 수행하세요.

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
수정할 클러스터의 이름을 클릭합니다.
자동화 섹션에서 알림 옆에 있는 알림 수정을 클릭합니다.
알림 수정 대화상자에서 알림 사용 설정 체크박스를 선택합니다.
드롭다운 목록에서 앞서 만든 Pub/Sub 주제를 선택합니다.
알림을 필터링하려면 알림 유형 필터링 체크박스를 선택한 후 수신할 알림 유형을 선택합니다.

참고: 필터링할 알림 유형을 선택하지 않으면 모든 관련 알림을 수신하게 됩니다.
변경사항 저장을 클릭합니다.

알림을 사용 설정한 후 주제에 대한 Pub/Sub 구독을 만듭니다.

클러스터 알림 필터링

알림 유형으로 알림을 필터링하여 원하는 알림을 수신할 수 있습니다.

다음 방법을 사용하여 알림을 필터링할 수 있습니다.

GKE: 클러스터 알림을 사용 설정하는 이전 예시와 같이 --notification-config 플래그에 filter 값을 지정합니다.
Pub/Sub: 구독을 만들 때 메시지를 필터링하도록 Pub/Sub 구독을 구성합니다.

GKE에서 기존 필터 수정

기존 GKE 클러스터 알림 필터를 수정하려면 기존 클러스터에서 알림 사용 설정의 안내에 따라 gcloud 명령어에서 필터링할 새 알림 유형을 지정하거나 Google Cloud 콘솔에서 새 유형을 선택합니다.

GKE에서 필터 중지

gcloud CLI 또는 Google Cloud 콘솔을 사용하여 GKE 알림 필터를 중지하고 클러스터에 적용 가능한 모든 알림 유형을 수신할 수 있습니다.

gcloud

gcloud CLI를 사용하여 필터를 중지하려면 다음 명령어를 실행합니다.

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=ENABLED,pubsub-topic=projects/PROJECT_ID/topics/TOPIC_NAME

콘솔

Google Cloud 콘솔을 사용하여 필터를 중지하려면 다음 단계를 수행합니다.

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
수정할 클러스터의 이름을 클릭합니다.
자동화 섹션에서 알림 옆에 있는 알림 수정을 클릭합니다.
알림 수정 대화상자에서 알림 유형 필터링 체크박스를 선택 취소합니다.
변경사항 저장을 클릭합니다.

클러스터 알림 설정 확인

Autopilot 모드에서 다음과 같이 클러스터 알림을 확인할 수 있습니다.

제어 영역 업그레이드를 시작합니다.
GKE가 노드를 새 버전으로 자동으로 업그레이드할 때까지 기다립니다. 소요 시간은 구성된 유지보수 기간 및 제외 항목에 따라 달라집니다.
GKE가 노드를 업그레이드한 후 Pub/Sub 구독을 확인합니다.

표준 모드에서 다음과 같이 클러스터 알림을 확인할 수 있습니다.

특정 노드 풀을 새 버전으로 업그레이드합니다. 노드에서 GKE 버전을 변경하지 않으려면 현재 노드에 있는 동일한 버전으로 업그레이드하면 됩니다.

주의: 표준 노드 풀을 수동으로 업그레이드하면 구성된 유지보수 기간이 무시되고 실행 중인 워크로드가 중단될 수 있습니다.
GKE가 노드를 업그레이드한 후 Pub/Sub 구독을 확인합니다.

UpgradeEvent 알림 유형의 설정만 수동으로 확인할 수 있습니다. 필터가 이 유형을 무시하도록 구성된 경우 메시지가 표시되지 않습니다.

클러스터 알림 중지

gcloud CLI 또는 Google Cloud 콘솔을 사용하여 클러스터 알림을 중지할 수 있습니다.

gcloud

gcloud CLI를 사용하여 알림을 중지하려면 다음 명령어를 실행합니다.

gcloud container clusters update CLUSTER_NAME \
  --region=COMPUTE_REGION \
  --notification-config=pubsub=DISABLED

콘솔

Google Cloud 콘솔을 사용하여 알림을 중지하려면 다음 단계를 수행합니다.

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
수정할 클러스터의 이름을 클릭합니다.
자동화 섹션에서 알림 옆에 있는 알림 수정을 클릭합니다.
알림 수정 대화상자에서 알림 사용 설정 체크박스를 선택 취소합니다.
변경사항 저장을 클릭합니다.

필요한 경우 알림을 위해 만든 Pub/Sub 주제를 삭제합니다.

다음 단계

클러스터 알림 자세히 알아보기
Pub/Sub 알림 구성 알아보기
타사 서비스의 클러스터 알림을 구성하는 방법 알아보기