8.4. トラフィック分割の CLI フラグ

Knative (kn) CLI は kn service update コマンドの一環として、サービスのトラフィックブロックでのトラフィック操作をサポートします。

以下の表は、トラフィック分割フラグ、値の形式、およびフラグが実行する操作の概要を表示しています。Repetition 列は、フラグの特定の値が kn service update コマンドで許可されるかどうかを示します。

フラグ	値	操作	繰り返し
`--traffic`	`RevisionName=Percent`	`Percent` トラフィックを `RevisionName` に指定します。	はい
`--traffic`	`Tag=Percent`	`Percent` トラフィックを、`Tag` を持つリビジョンに指定します。	はい
`--traffic`	`@latest=Percent`	`Percent` トラフィックを準備状態にある最新のリビジョンに指定します。	いいえ
`--tag`	`RevisionName=Tag`	`Tag` を `RevisionName` に指定します。	はい
`--tag`	`@latest=Tag`	`Tag` を準備状態にある最新リビジョンに指定します。	いいえ
`--untag`	`Tag`	リビジョンから `Tag` を削除します。	はい

すべてのトラフィック関連のフラグは、単一の kn service update コマンドを使用して指定できます。kn は、これらのフラグの優先順位を定義します。コマンドの使用時に指定されるフラグの順番は考慮に入れられません。

kn で評価されるフラグの優先順位は以下のとおりです。

タグをリビジョンに追加してから、設定したタグに応じてトラフィックを分割することができます。

kn service update コマンドを使用して --tag フラグをサービスに割り当てると、サービスの更新時に作成されるリビジョンのカスタム URL が作成されます。カスタム URL は、https://<tag>-<service_name>-<namespace>.<domain> パターンまたは http://<tag>-<service_name>-<namespace>.<domain> パターンに従います。

--tag フラグおよび --untag フラグは以下の構文を使用します。

以下の例では、タグ latest を、example-revision という名前のリビジョンに割り当てます。

$ kn service update <service_name> --tag @latest=example-tag

--untag フラグを使用して、カスタム URL を削除するタグを削除できます。

注記

リビジョンのタグが削除され、トラフィックの 0% が割り当てられる場合、リビジョンはトラフィックブロックから完全に削除されます。

以下のコマンドは、example-revision という名前のリビジョンからすべてのタグを削除します。

$ kn service update <service_name> --untag example-tag