クラスタ通知を受信する

Autopilot Standard

---

このページでは、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 トピックを作成します。

新しいクラスタでクラスタ通知を有効にする

新しい Standard クラスタでの GKE クラスタ通知は、Google Cloud CLI または Google Cloud コンソールを使用して有効にできます。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: 新しいクラスタのコンピューティング リージョン。ゾーン Standard クラスタの場合は、--zone=COMPUTE_ZONE を使用します。
• PROJECT_ID: Google Cloud プロジェクト ID。
• TOPIC_NAME: Pub/Sub トピックの名前。

• NOTIFICATION_TYPE: 受信する通知タイプのパイプ（|）区切りリスト。たとえば、filter="UpgradeEvent|SecurityBulletinEvent" は UpgradeEvent と SecurityBulletinEvent の通知のみを送信し、他のすべてのタイプは無視します。

  注: filter の値を指定しないと、クラスタ構成に適用されるすべての通知が送信されます。

コンソール

新しい Standard クラスタでクラスタ通知を有効にするには、次の操作を行います。

1. Google Cloud コンソールで Google Kubernetes Engine のページに移動します。

   Google Kubernetes Engine に移動

2. [ 作成] をクリックします。

3. [クラスタを作成] ダイアログで、[GKE Standard] の横にある [構成] をクリックします。

4. ナビゲーション パネルの [クラスタ] セクションで、[自動化] をクリックします。

5. [通知を有効にする] チェックボックスをオンにします。

6. プルダウン リストから、作成した Pub/Sub トピックを選択します。

7. 通知をフィルタリングするには、[通知タイプをフィルタする] チェックボックスをオンにして、受信する通知タイプを選択します。

   注: フィルタする通知タイプを選択しないと、該当するすべての通知が送信されます。

8. 必要に応じてクラスタの構成を続けます。

9. [作成] をクリックします。

通知を有効にした後、トピックの Pub/Sub サブスクリプションを作成します。

注: GKE では、トピックがクラスタと同じプロジェクトにある限り、トピックとクラスタの関連付けに制限はありません。すべてのクラスタに対して 1 つのトピックを作成することも、クラスタのグループに対して複数のトピックを作成することもできます。

既存のクラスタでクラスタ通知を有効にする

既存のクラスタでの GKE クラスタ通知は、Google Cloud CLI または Google Cloud コンソールを使用して有効にできます。

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: 新しいクラスタのコンピューティング リージョン。ゾーン Standard クラスタの場合は、--zone=COMPUTE_ZONE を使用します。
• PROJECT_ID: Google Cloud プロジェクト ID。
• TOPIC_NAME: Pub/Sub トピックの名前。

• NOTIFICATION_TYPE: 受信する通知タイプのパイプ（|）区切りリスト。たとえば、filter="UpgradeEvent|SecurityBulletinEvent" は UpgradeEvent と SecurityBulletinEvent の通知のみを送信し、他のすべてのタイプは無視します。

  注: filter の値を指定しないと、クラスタ構成に適用されるすべての通知が送信されます。

コンソール

既存のクラスタでクラスタ通知を有効にするには、次の手順を行います。

1. Google Cloud コンソールで Google Kubernetes Engine のページに移動します。

   Google Kubernetes Engine に移動

2. 変更するクラスタの名前をクリックします。

3. [自動化] セクションで、[通知] の横にある [通知を編集] をクリックします。

4. [通知を編集] ダイアログで、[通知を有効にする] チェックボックスをオンにします。

5. プルダウン リストから、作成した Pub/Sub トピックを選択します。

6. 通知をフィルタリングするには、[通知タイプをフィルタする] チェックボックスをオンにして、受信する通知タイプを選択します。

   注: フィルタする通知タイプを選択しないと、該当するすべての通知が送信されます。

7. [保存] をクリックします。

通知を有効にした後、トピックの Pub/Sub サブスクリプションを作成します。

注: GKE では、トピックがクラスタと同じプロジェクトにある限り、トピックとクラスタの関連付けに制限はありません。すべてのクラスタに対して 1 つのトピックを作成することも、クラスタのグループに対して複数のトピックを作成することもできます。

クラスタ通知をフィルタする

通知を通知タイプでフィルタすると、必要な通知を受け取ることができます。

次の方法でフィルタする通知を選択できます。

• GKE: クラスタ通知の有効化の前の例で示したように、--notification-config フラグに filter の値を指定します。
• Pub/Sub: サブスクリプションの作成時にメッセージをフィルタするように Pub/Sub サブスクリプションを構成します。

注: GKE を使用してフィルタすることをおすすめします。GKE ではフィルタをいつでも変更できます。これにより、Pub/Sub フィルタに関連付けられた未配信メッセージのコストを排除できます。フィルタリング オプションの違いについては、通知のフィルタリングをご覧ください。

GKE で既存のフィルタを変更する

既存の GKE クラスタ通知フィルタを変更するには、既存のクラスタで通知を有効にするの操作を行い、gcloud コマンドでフィルタする新しい通知タイプを指定するか、Google Cloud コンソールで新しいタイプを選択します。

GKE でフィルタを無効にする

GKE 通知フィルタは、gcloud CLI または Google Cloud コンソールを使用して無効にし、クラスタに該当するすべての通知タイプを受け取ることができます。

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 コンソールを使用してフィルタを無効にするには、次の操作を行います。

1. Google Cloud コンソールで Google Kubernetes Engine のページに移動します。

   Google Kubernetes Engine に移動

2. 変更するクラスタの名前をクリックします。

3. [自動化] セクションで、[通知] の横にある [通知を編集] をクリックします。

4. [通知を編集] ダイアログで、[通知タイプをフィルタする] チェックボックスをオフにします。

5. [保存] をクリックします。

クラスタ通知の設定を確認する

Autopilot モードでは、クラスタの通知を次のように確認できます。

1. コントロール プレーンのアップグレードを開始します。
2. GKE がノードを新しいバージョンに自動的にアップグレードするまで待ちます。所要時間は、構成したメンテナンスの時間枠と除外によって変動する場合があります。
3. GKE がノードをアップグレードしたら、Pub/Sub サブスクリプションを確認します。

Standard モードでは、クラスタの通知を次のように確認できます。

1. 特定のノードプールを新しいバージョンにアップグレードします。ノード上の GKE バージョンを変更しない場合は、ノード上で現在インストールされている同じバージョンにアップグレードできます。

   注意: Standard ノードプールを手動でアップグレードすると、構成されたメンテナンスの時間枠が無視され、ワークロードの実行が中断される可能性があります。

2. 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 コンソールを使用して通知を無効にするには、次の操作を行います。

1. Google Cloud コンソールで Google Kubernetes Engine のページに移動します。

   Google Kubernetes Engine に移動

2. 変更するクラスタの名前をクリックします。

3. [自動化] セクションで、[通知] の横にある [通知を編集] をクリックします。

4. [通知を編集] ダイアログで、[通知を有効にする] チェックボックスをオフにします。

5. [保存] をクリックします。

必要に応じて、通知用に作成した Pub/Sub トピックを削除します。

次のステップ

• クラスタ通知の詳細を理解する。
• Pub/Sub 通知の構成を確認する。
• サードパーティ サービス用のクラスタ通知を構成する方法を確認する。