11.3. GetClusters

any には、シリアライズされたメッセージの型を記述する URL とともに、任意のシリアライズされたプロトコルバッファーメッセージが含まれます。

Protobuf ライブラリーは、パック/アンパックをサポートします。任意の値は、ユーティリティー関数の形式で、または Any タイプの追加の生成されたメソッドになります。

例 1: C++ のメッセージをパックして展開します。

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

例 2: Java でメッセージをパックして解凍します。

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}

Example 3: Pack and unpack a message in Python.

Example 3: Pack and unpack a message in Python.

foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...

foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...

Example 4: Pack and unpack a message in Go

Example 4: Pack and unpack a message in Go

foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

protobuf ライブラリーが提供するパックメソッドは、デフォルトで type.googleapis.com/full.type.name をタイプ URL として使用し、unzip メソッドは、タイプ URL の最後の//のみを使用します。たとえば、"foo.bar.com/x/y.z" のように、"foo.bar.com/x/y.z" の型名 "y.z" が生成されます。

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}

{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}

AdmissionControlHealthInfo は、アドミッションコントロールのデプロイメントに関するデータを保管しますが、このデータから派生した受付制御ヘルスステータスは含まれません。集約された受付制御の健全性ステータスは、最初に AdmissionControlHealthInfo (sensor)を報告するコンポーネントではなく、中央で派生するため、含まれません。

ClusterMetadata には、クラスターインフラストラクチャーに関するメタデータ情報が含まれます。

CollectorHealthInfo は、コレクターのデプロイメントに関するデータを保持しますが、このデータから取得するコレクターのヘルスステータスは含まれません。集約コレクターのヘルスステータスは、最初に CollectorHealthInfo (sensor)を報告するコンポーネントではなく、中央で派生しているため、含まれません。

静的および動的設定を含む ID/名前識別子から完全なクラスター設定をエンコードします。

静的クラスター設定と動的クラスター設定の相違点は、動的値が Central 経由で Sensor gRPC 接続に送信されることです。これには、Secured クラスターコンポーネントを再起動せずに値をホットリロードできるという利点があります。

ScannerHealthInfo は、セキュアなクラスターにデプロイされたスキャナーインスタンスの健全性情報（ローカルスキャナーと呼ばれる）を表します。スキャナーが中央クラスターにデプロイされると、次のメッセージは使用されません。ScannerHealthInfo は、スキャナーのデプロイメントに関するデータを保管しますが、このデータから派生したスキャナーの正常性ステータスは含まれません。集約されたスキャナーの正常性ステータスは中央で派生しており、最初に ScannerHealthInfo (sensor)を報告するコンポーネントに含まれていないため、含まれません。

StackRoxDeploymentIdentification は、StackRox Sensor デプロイメントを一意に識別するためのものです。これは、再起動または再作成されたセンサー Pod からのセンサー接続（ネットワークパーティション後）、または別の namespace またはクラスターへのデプロイメントからのセンサー接続の提供に使用されるために使用されます。

静的クラスター設定と動的クラスター設定の相違点は、静的な値がセントラルの gRPC 接続を介して送信されないことです。これらは、たとえば、セキュアなクラスターの k8s コンポーネントの設定に使用できるマニフェストを生成するために使用されます。動的に再読み込みされ ません。