REST Resource: projects.locations.fleetPackages

リソース: FleetPackage

Config Delivery API の FleetPackage リソース。

FleetPackage は、Kubernetes 構成を Kubernetes クラスタのフリートにデプロイするパッケージを定義します。

JSON 表現
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "resourceBundleSelector": {
    object (ResourceBundleSelector)
  },
  "target": {
    object (Target)
  },
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "variantSelector": {
    object (VariantSelector)
  },
  "info": {
    object (FleetPackageInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "state": enum (State)
}
フィールド
name

string

ID。FleetPackage の名前。形式は projects/{project}/locations/{location}/fleetPackages/{fleetPackage} です。fleetPackage コンポーネントは [a-z][a-z0-9\-]{0,62} と一致する必要があります。

createTime

string (Timestamp format)

出力専用。FleetPackage が作成された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。FleetPackage が最後に更新された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

labels

map (key: string, value: string)

省略可。ラベルは、ユーザーと Config Delivery の両方が設定して使用できる属性です。ラベルは次の制約を満たしている必要があります。

  • キーと値には、小文字、数字、アンダースコア、ダッシュのみを使用できます。
  • すべての文字は UTF-8 でエンコードする必要があります。国際文字も使用できます。
  • キーは、小文字または国際文字で始める必要があります。
  • 各リソースは最大 64 個のラベルに制限されます。

さらに、キーと値の両方が 128 バイト以下に制限されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }。

resourceBundleSelector

object (ResourceBundleSelector)

必須。デプロイする Kubernetes 構成のソースを指定する情報。

target

object (Target)

省略可。Kubernetes 構成をデプロイするターゲット クラスタを選択するための構成。

rolloutStrategy

object (RolloutStrategy)

省略可。Kubernetes 構成をクラスタにデプロイするために使用する戦略。

variantSelector

object (VariantSelector)

必須。ResourceBundle バリアントをターゲット クラスタにマッピングする方法を指定する情報。

info

object (FleetPackageInfo)

出力専用。すべてのターゲット クラスタにおける FleetPackage のロールアウト ステータスを含む情報。

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

省略可。FleetPackage が削除されたときに、ターゲット クラスタで Kubernetes リソースを処理する方法に関する情報。

state

enum (State)

省略可。フリート パッケージの望ましい状態。

ResourceBundleSelector

デプロイする Kubernetes 構成のソースを指定する情報。

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "resourceBundle": {
    object (ResourceBundleTag)
  },
  "cloudBuildRepository": {
    object (CloudBuildRepository)
  }
  // End of mutually exclusive fields.
}
フィールド
ソースは、直接 push された ResourceBundle または Kubernetes 構成を含む CloudBuildRepository にできます。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
resourceBundle

object (ResourceBundleTag)

ResourceBundle を指定する情報。

cloudBuildRepository

object (CloudBuildRepository)

CloudBuildRepository を指定する情報。

相互に排他的なフィールドの終了。

ResourceBundleTag

ResourceBundleTag には、ResourceBundle のリリースを参照するための情報が含まれています。

JSON 表現
{
  "name": string,
  "tag": string
}
フィールド
name

string

必須。ResourceBundle の名前。形式は projects/{p}/locations/{l}/resourceBundles/{r} です。

tag

string

必須。ResourceBundle 内のリリースのバージョンの Git タグ。タグは、セマンティック バージョニング形式(vX.Y.Z)にする必要があります。

CloudBuildRepository

CloudBuildRepository には、CloudBuildRepository から Kubernetes 構成を取得する際の情報が含まれています。

JSON 表現
{
  "name": string,
  "path": string,
  "tag": string,
  "serviceAccount": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "variantsPattern": string
  // End of mutually exclusive fields.
}
フィールド
name

string

必須。Cloud Build リポジトリの名前。形式は projects/{p}/locations/{l}/connections/{c}/repositories/{r} です。

path

string

省略可。Kubernetes 構成を含むリポジトリ内のディレクトリまたはファイルへのパス。指定しない場合、パスはリポジトリの最上位のルート ディレクトリと見なされます。

tag

string

必須。基盤となる Git リポジトリの Git タグ。git タグは、セマンティック バージョン形式 vX.Y.Z にする必要があります。

serviceAccount

string

必須。Kubernetes 構成を取得して保存するために CloudBuild トリガーで使用する Google サービス アカウント。

リポジトリでバリアントを検索する方法の構成を指定します。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
variantsPattern

string

省略可。リポジトリ内のバリアントを検索するために使用される glob パターン。例: variants/*.yaml、us-*

相互に排他的なフィールドの終了。

ターゲット

ターゲットは、Kubernetes クラスタのセットをターゲットに設定するさまざまな方法を定義します。

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fleet": {
    object (Fleet)
  }
  // End of mutually exclusive fields.
}
フィールド
フリート パッケージのターゲット。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
fleet

object (Fleet)

FleetPackage のロールアウトをターゲットとする GKE フリート情報。

相互に排他的なフィールドの終了。

フリート

FleetPackage をデプロイするフリート。

JSON 表現
{
  "project": string,
  "selector": {
    object (LabelSelector)
  }
}
フィールド
project

string

必須。GKE フリートのホスト プロジェクト。形式は projects/{project} です。

selector

object (LabelSelector)

省略可。セレクタを使用すると、ラベルを使用してフリート メンバーのサブセットをターゲットに設定できます。

LabelSelector

ラベルセレクタは、一連のリソースに対するラベルクエリです。空のラベルセレクタは、すべてのオブジェクトに一致します。

JSON 表現
{
  "matchLabels": {
    string: string,
    ...
  }
}
フィールド
matchLabels

map (key: string, value: string)

省略可。{key,value} ペアのマップ。一致条件を満たすには、各 {key,value} ペアが既存のラベルのキーと値に完全に一致する必要があります。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

VariantSelector

VariantSelector には、ターゲット クラスタにデプロイする ResourceBundle のバリアントを選択するための情報が含まれています。

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "variantNameTemplate": string
  // End of mutually exclusive fields.
}
フィールド
バリアントを選択するための戦略。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
variantNameTemplate

string

必須。variantNameTemplate は、ターゲット クラスタのバリアント名を生成するためのクラスタのメンバーシップに関するメタデータ(ロケーション、名前、ラベルなど)を含む変数を参照できるテンプレートです。変数の構文は、UNIX のシェル変数と同様です。

使用可能な変数は ${membership.name}、${membership.location}、${membership.project}、${membership.labels['label_name']} です。

すべてのクラスタに特定のバリアント(たとえば「default」)をデプロイする場合は、variantNameTemplate に単に「default」(変数なしの文字列)を指定できます。

相互に排他的なフィールドの終了。

FleetPackageInfo

FleetPackageInfo は、すべてのターゲット クラスタにおける FleetPackage のステータスを表します。

JSON 表現
{
  "activeRollout": string,
  "lastCompletedRollout": string,
  "state": enum (State),
  "errors": [
    {
      object (FleetPackageError)
    }
  ]
}
フィールド
activeRollout

string

省略可。アクティブなロールアウト(存在する場合)。形式は projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout} です。

lastCompletedRollout

string

省略可。最後に完了したロールアウト(存在する場合)。形式は projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout} です。

state

enum (State)

省略可。出力専用。FleetPackage の現在の状態。

errors[]

object (FleetPackageError)

省略可。出力専用。構成のデプロイ中に発生したエラー(存在する場合)。

状態

FleetPackage 状態に指定できる値。

列挙型
STATE_UNSPECIFIED 未指定の状態
ACTIVE FleetPackage がアクティブです。
SUSPENDED FleetPackage は停止中です。
FAILED FleetPackage を調整できませんでした。
DELETING 「FleetPackage」を削除しています。

FleetPackageError

構成のロールアウト中に発生したエラーを表す情報。

JSON 表現
{
  "errorMessage": string
}
フィールド
errorMessage

string

省略可。エラーの説明。

状態

state は、フリート パッケージの望ましい状態を示します。未指定の値は ACTIVE と同等です。状態が SUSPENDED に設定されている場合、アクティブなロールアウト(存在する場合)は続行されますが、新しいロールアウトはスケジュールされません。

列挙型
STATE_UNSPECIFIED 未指定の状態
ACTIVE FleetPackage は有効にする必要があります。
SUSPENDED FleetPackage は一時停止される予定です。

メソッド

create

指定されたプロジェクトとロケーションで新しい FleetPackage を作成します。

delete

1 つの FleetPackage を削除します。

get

1 つの FleetPackage の詳細を取得します。

list

指定されたプロジェクトとロケーションの FleetPackage を一覧表示します。

patch

単一の FleetPackage のパラメータを更新します。