---
title: "KubernetesクラスターでのCanary Releaseの決定を自動化する - API7.ai"
description: "API7 Cloudを使用して、カナリアリリースを宣言的に操作し、カナリアリリースを自動化する方法を学びましょう。"
url: "https://api7.ai/ja/blog/automate-canary-release-decisions-kubernetes-cluster"
---

[Blog](https://api7.ai/ja/blog)

[Products](https://api7.ai/ja/category/products)[Technology](https://api7.ai/ja/category/technology)[Ecosystem](https://api7.ai/ja/category/ecosystem)[Case Study](https://api7.ai/ja/category/usercase)[Team & Community](https://api7.ai/ja/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Technology

# KubernetesクラスターでのCanary Releaseの決定を自動化する

[![Chao Zhang](https://avatars.githubusercontent.com/u/10428333?v=4)](https://github.com/tokers)

[Chao Zhang](https://github.com/tokers)

December 30, 2022

[Technology](https://api7.ai/category/technology)

## 背景

現在、マイクロサービスは典型的で広く使用されているソフトウェアアーキテクチャパターンとなっています。サービスは疎結合で、APIを介して連携します。マイクロサービスパターンにより、各アプリケーションは独立してデプロイおよびメンテナンス可能となり、リリースがより頻繁に行われます。ご存知の通り、リリースにはリスクが伴います。新しいバージョンにバグがないかどうかは誰にもわかりません。そのため、カナリアリリースやブルーグリーンデプロイメントなどの戦略を使用して、最新バージョンを段階的に展開し、リスクを低減します。

カナリアリリースでは、トラフィックを安定グループとカナリアグループの2つのターゲットサービスに分割します。Apache APISIXのようなAPIゲートウェイは、マイクロサービスアーキテクチャをAPIとして効率的かつ安全に公開します。カナリアリリースの機能を備えています。通常、トラフィックを分割する方法には2つあります：重みベースの方法と述語式ベースの方法です。

### 重みベースの方法

![重みベースの方法](https://static.api7.ai/2022/12/21/63a2bc4fa251e.png?imageMogr2/format/webp)

ユーザーは、カナリアグループにヒットするトラフィックの割合を指定する必要があります。上の画像では、95%のトラフィックが安定サービスに転送され、残りの5%がカナリアサービスに転送されます。

### 述語式ベースの方法

![述語式ベースの方法](https://static.api7.ai/2022/12/21/63a2bc4edf43c.png?imageMogr2/format/webp)

リクエスト述語式ベースの方法では、指定された特性に合致するトラフィックのみがカナリアグループにヒットします。例えば、リクエストヘッダーにX-Debugとその実際の値を持つHTTPリクエストのみがカナリアサービスに到達します。

### カナリアリリースの自動化

APIゲートウェイをAPIやダッシュボードを介して操作する場合、トラフィック比率（重みベースの方法）や述語（述語式ベースの方法）を調整する際に時間差が生じます。現在、多くのユーザーがKubernetesを使用してマイクロサービスをオーケストレーションしています。新しいサービスバージョンが作成されたら、カナリアリリースを開始できるでしょうか？この記事では、API7 Cloudを使用してKubernetesクラスター内でカナリアリリースを自動化する方法を紹介します。

## API7 Cloudとは

API7 Cloudは、任意のクラウド、複数のロケーションでAPIを大規模にデプロイ、制御、可視化、監視するためのSaaSプラットフォームです。APIをどこで実行しても、1か所で管理できます。API7 Cloudは、Apache APISIXをAPIゲートウェイとして使用し、APIを効率的かつ安全に公開します。

![API7 Cloud](https://static.api7.ai/2022/12/16/639be9e4e5030.png?imageMogr2/format/webp)

API7 Cloudを使用するには、DockerやKubernetesなどのインフラストラクチャにApache APISIXをデプロイする必要があります。Cloud CLIを使用してデプロイを簡素化できます。

```
# API7 Cloudコンソールからアクセストークンを設定します。
cloud-cli configure --token {YOUR TOKEN}

# Apache APISIX（バージョン2.15.1）をapisixネームスペースにデプロイし、レプリカ数を1に設定します。
cloud-cli deploy kubernetes \
  --name my-apisix \
  --namespace apisix \
  --replica-count 1 \
  --apisix-image apache/apisix:2.15.1-centos
```

カナリアリリースはAPI7 Cloudの組み込み機能の1つです。ユーザーはコンソールを介してカナリアリリースルールを設定するか、API7 Cloud Open APIを呼び出すことができます。カナリアリリースの決定を自動化するために、後者の方法を使用します。

## シナリオ

Kubernetesクラスター内に、常にエラーメッセージを返すシンプルなerror-pageアプリケーションがあるとします。バージョン2.0をリリースし、カナリアリリース戦略を使用してリリースリスクを低減したいと考えています。さらに、このプロセス全体を自動化したいと考えています。そこで、Kubernetesサービスリソースの変更を監視し、API7 Cloud Go SDKを介してAPI7 Cloud上でカナリアリリースを作成/変更するカナリアリリースコントローラーを作成します。トラフィックを分割するために重みベースの方法のみを使用します。Apache APISIX APIゲートウェイを含むすべてのコンポーネントはKubernetes上にデプロイされるため、図は次のようになります：

![図](https://static.api7.ai/2022/12/16/639bea2c4fb9d.png?imageMogr2/format/webp)

カナリアリリースコントローラーはサービスの変更を監視し、いくつかのアノテーションに基づいて反応します。具体的には：

- サービスに`api7.cloud/published-service`アノテーションが含まれている場合、カナリアリリースコントローラーはAPI7 Cloud上にアプリケーションを作成しようとします。
- サービスに`api7.cloud/published-canary-service`アノテーションが含まれている場合、カナリアリリースコントローラーはAPI7 Cloud上にカナリアリリースルールを設定しようとし、`api7.cloud/published-service-canary-percentage`アノテーションが割合を決定します。

このコントローラーは自己完結型ではありません（サービスが削除された場合にアプリケーションを削除しません）が、自動化されたカナリアリリースプロセスを示すには十分です。

## さあ、始めましょう！

まず、Apache APISIXとカナリアリリースコントローラーをデプロイします。前述の通り、Cloud CLIを使用してApache APISIXをデプロイします。また、error-pageアプリケーションとカナリアリリースコントローラーをデプロイするための2つのYAMLファイル（error-page/manifest-v1.yamlとcontroller/manifest.yaml）があります。

1. 以下のコマンドを実行するために、利用可能なKubernetesクラスターを準備してください。
2. カナリアリリースコントローラーはAPI7 Cloud APIを呼び出すためにアクセストークンが必要です。このドキュメントに従ってトークンを取得し、K8sシークレットに保存します。

```
kubectl create namespace canary-release-demo
# error-page v1バージョンをデプロイします。
kubectl apply -f https://raw.githubusercontent.com/tokers/canary-release-automation-demo/main/error-page/manifest-v1.yaml -n canary-release-demo

# API7 Cloudアクセストークンを保存するK8sシークレットを作成します。
kubectl create secret generic api7-cloud --namespace canary-release-demo --from-literal token={Your Access Token}

# カナリアリリースコントローラーをデプロイします。
kubectl apply -f https://raw.githubusercontent.com/tokers/canary-release-automation-demo/main/controller/manifest.yaml -n canary-release-demo

# すべてのワークロードが正常か確認します。
kubectl get all -n canary-release-demo
```

### プロキシを確認する

このサービスをアノテーションして公開します。

```
kubectl annotate service -n canary-release-demo error-page-v1 "api7.cloud/published-service=error-page"
```

カナリアリリースコントローラーはこの変更を監視し、API7 Cloud上にアプリケーションを作成します。Apache APISIXにアクセスして、プロキシが正常かどうかを確認します。

```
kubectl port-forward -n canary-release-demo service/apisix-gateway 10080:80
curl http://127.0.0.1:10080/api/error_page -H 'Host: error-page' -s
```

すべてが正常であれば、`{"error": "injected by error_page service", "version": "v1"}`が表示されます。

現在、カナリアリリースコントローラーはアプリケーション内に「すべてにマッチする」APIを作成し、ホストはアプリケーション名（error-page）と同じです。

### V2をロールアウトする

error-pageアプリケーションのバージョン2をロールアウトしたいと考えています。まず、manifest-v2.yamlを適用してバージョン2をデプロイします。error-page-v2サービスにカナリアリリースのアノテーションを付けます。

```
kubectl apply -f https://raw.githubusercontent.com/tokers/canary-release-automation-demo/main/error-page/manifest-v2.yaml -n canary-release-demo

# カナリアリリースコントローラーに、error-page-v2のカナリアリリースを有効にし、割合を10%にすることを伝えます。
kubectl annotate service -n canary-release-demo error-page-v2 "api7.cloud/published-canary-service=true" "api7.cloud/published-service-canary-percentage=10"

# カナリアを開始します。
kubectl annotate service -n canary-release-demo error-page-v2 "api7.cloud/published-service=error-page"
```

Apache APISIXに再度`100`リクエストを送信し、いくつかのリクエストがカナリアサービスerror-page-v2に転送されたかどうかを確認します。

```
kubectl port-forward -n canary-release-demo service/apisix-gateway 10080:80
for ((i=0; i<100; i++)); do
  curl http://127.0.0.1:10080/api/error_page -H 'Host: error-page' -s
done
```

すべてが正常であれば、約10%のリクエストがerror-page-v2に到達します（Apache APISIXがバックエンドを選択する内部戦略により、正確に10%ではありません）。

### ロールバック

バージョン2が不安定であることがわかり、ロールバックしたいと考えています。その前に、カナリアを停止するため、割合を0に変更します。その後、再度Apache APISIXにリクエストを送信します。

```
kubectl annotate service -n canary-release-demo error-page-v2 "api7.cloud/published-service-canary-percentage=0" --overwrite
for ((i=0; i<100; i++)); do
  curl http://127.0.0.1:10080/api/error_page -H 'Host: error-page' -s
done
```

すべてのリクエストがerror-page-v1に転送されることがわかります。

### リリース

長い間、バージョン2が十分に安定していると信じ、すべてのリクエストがバージョン2に到達するようにしたいと考えています。その後、バージョン1のerror-pageアプリケーションをオフラインにできます。そこで、割合を100%に変更します。

```
kubectl annotate service -n canary-release-demo error-page-v2 "api7.cloud/published-service-canary-percentage=100" --overwrite
for ((i=0; i<100; i++)); do
  curl http://127.0.0.1:10080/api/error_page -H 'Host: error-page' -s
done
```

すべてのリクエストがerror-page-v2にプロキシされます。error-page-v1は安全にオフラインにできます。

## まとめ

カナリアリリースはリリースのための有効な手段です。しかし、カナリアリリース戦略を調整するのは遅れる可能性があります。この記事では、カナリアリリースを宣言的に操作し、ある程度自動化する方法を示しました。GitOpsコンポーネントを使用して完全に自動化されたカナリアリリースを追求する人もいるかもしれません。例えば、Argo Rolloutsを使用すると、サービスメトリクスをクエリし、Ingressコントローラーと統合してCRDを変更することで、サービスを自動的にプロモートまたはロールバックできます。最終的に、APIゲートウェイはリクエストを正しい割合でカナリアバージョンに転送します。

## 参考

error-pageとカナリアリリースコントローラーのソースコード: <https://github.com/tokers/canary-release-automation-demo>

Tags:

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[API7 Cloud](https://api7.ai/tags/api7-cloud)

[Kubernetes](https://api7.ai/tags/kubernetes)

Share article link

Share

Related Posts

[![マイクロサービスアーキテクチャにおけるAPIゲートウェイの役割を理解する](https://static.api7.ai/uploads/2025/02/11/Ubz9z2FG_api-gateways-in-microservices.png)](https://api7.ai/blog/api-gateways-in-microservices-architecture)

## [マイクロサービスアーキテクチャにおけるAPIゲートウェイの役割を理解する](https://api7.ai/blog/api-gateways-in-microservices-architecture)

[![DeepSeek APIの不安定性を分析：APIゲートウェイができることとできないこと](https://static.api7.ai/uploads/2025/02/11/uLte0Bp5_deepseek-api-instability.png)](https://api7.ai/blog/analyzing-deepseek-api-instability)

## [DeepSeek APIの不安定性を分析：APIゲートウェイができることとできないこと](https://api7.ai/blog/analyzing-deepseek-api-instability)

Table of Contents

- [背景](#%E8%83%8C%E6%99%AF)

  - [重みベースの方法](#%E9%87%8D%E3%81%BF%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E6%96%B9%E6%B3%95)
  - [述語式ベースの方法](#%E8%BF%B0%E8%AA%9E%E5%BC%8F%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E6%96%B9%E6%B3%95)
  - [カナリアリリースの自動化](#%E3%82%AB%E3%83%8A%E3%83%AA%E3%82%A2%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%81%AE%E8%87%AA%E5%8B%95%E5%8C%96)

- [API7 Cloudとは](#api7-cloud%E3%81%A8%E3%81%AF)

- [シナリオ](#%E3%82%B7%E3%83%8A%E3%83%AA%E3%82%AA)

- [さあ、始めましょう！](#%E3%81%95%E3%81%82%E5%A7%8B%E3%82%81%E3%81%BE%E3%81%97%E3%82%87%E3%81%86)

  - [プロキシを確認する](#%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B)
  - [V2をロールアウトする](#v2%E3%82%92%E3%83%AD%E3%83%BC%E3%83%AB%E3%82%A2%E3%82%A6%E3%83%88%E3%81%99%E3%82%8B)
  - [ロールバック](#%E3%83%AD%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF)
  - [リリース](#%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9)

- [まとめ](#%E3%81%BE%E3%81%A8%E3%82%81)

- [参考](#%E5%8F%82%E8%80%83)

## Related Posts

[![API Gateway、Kubernetes Gateway、およびService Meshの包括的な比較](https://static.api7.ai/uploads/2023/06/07/KS3wtoLx_cover.png)](https://api7.ai/ja/blog/gateway-and-mesh)

Technology

June 9, 2023

#### [API Gateway、Kubernetes Gateway、およびService Meshの包括的な比較](https://api7.ai/ja/blog/gateway-and-mesh)

APIゲートウェイ、Kubernetesゲートウェイ、およびサービスメッシュの包括的な比較と、実践的な洞察を提供します。

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[Kubernetes](https://api7.ai/tags/kubernetes)

[![Kubernetes Service API 初探](https://static.api7.ai/2022/11/18/63772298399d9.png)](https://api7.ai/ja/blog/a-first-look-at-kubernetes-service-api)

Technology

December 18, 2020

#### [Kubernetes Service API 初探](https://api7.ai/ja/blog/a-first-look-at-kubernetes-service-api)

序文 Kubernetesには、...を公開するための数多くのソリューションがあることが知られています。

[Kubernetes](https://api7.ai/tags/kubernetes)

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[Comparison to Competitors](https://api7.ai/tags/comparison-to-competitors)

[![実世界におけるAPIゲートウェイの選定：技術評価プロセスの内側](https://static.api7.ai/uploads/2025/06/03/E7OqOddo_api-gateway-decision.webp)](https://api7.ai/ja/blog/api-gateway-decision-inside-technical-evaluation)

Technology

June 3, 2025

#### [実世界におけるAPIゲートウェイの選定：技術評価プロセスの内側](https://api7.ai/ja/blog/api-gateway-decision-inside-technical-evaluation)

実世界におけるAPIゲートウェイの評価プロセスを探り、Apache APISIXの柔軟性、パフォーマンス、オープンソースとしての利点を明らかにします。

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)
