ポリシーリファレンス

このページでは、サンドボックスポリシーのすべてのフィールドを説明します。ポリシーは、マネージドランナー上で policy フィールドとして保持され、クラスターは最大で 1 つのランナーをホストするため、1 つのポリシーが 1 つのクラスターを管理します。タスク指向の手順ガイドについては、サンドボックスポリシーを設定するを参照してください。実例については、ポリシーの例を参照してください。

トップレベルフィールド

Field	タイプ	Description
`display_name`	string	このポリシーが表すポスチャーの、人が読みやすい名前。
`base`	オブジェクト	サンドボックスの spec より前に適用される、ランタイムのデフォルトとアタッチメント。`base` を参照してください。
`constraints`	`PolicyConstraints`	解決済みの spec に対して検証される、型付きのクランプ。`constraints` を参照してください。

空のポリシーも有効で、制限が一切ないポスチャーを宣言します。base と constraints はどちらもオプションです。そのため、クラスターのポスチャーは常に明示的に宣言され、意図せず継承されることはありません。

解決順序

サンドボックスは2つの段階で解決されます。

Base. ランタイムのデフォルト、base、サンドボックスの spec の順に適用されます。個々の値についてはサンドボックスの値が優先されます。base のリスト型のアタッチメントは常に適用されます。
Constraints. クランプは、完全に解決された spec に対して検証されます。違反があった場合は拒否され、暗黙的に書き換えられることはありません。

制約は送信された spec ではなく解決後の spec に対して検証を行うため、base が指定した値も、サンドボックスが指定した値と同じ条件でチェックされます。

`base`

ランタイムのデフォルトとアタッチメントのフラグメントです。Kubernetes ランナー上では、これは Pod spec のフラグメントです。 base は、サンドボックスが宣言すべきではないインフラストラクチャー設定が存在する場所です: スケジューラー、ノードセレクター、トレランス、優先度クラス、トポロジスプレッド、サービスアカウント、イメージプルシークレット、プラットフォームボリューム、DNS 設定、およびピン留めされたアノテーションなどの Pod メタデータです。セキュリティ上重要なフィールドは、 affinity、Pod およびコンテナーの securityContext、 runtimeClassName、および initContainers を含め、即座に拒否されます。

`constraints`

PolicyConstraints は、ポリシーが強制する型付きのクランプをグループ化します。各グループはオプションで、省略されたグループは制限を適用しません。

グループ	タイプ	管理対象
`resources`	`ResourceConstraints`	CPU、メモリ、GPUの境界とデフォルト。
`image`	`ImageConstraints`	サンドボックスが実行できるイメージ。
`network`	`NetworkConstraints`	外向き通信およびイングレスの許可リストとデフォルト。
`security`	`SecurityConstraints`	特権、ケーパビリティ、分離。
`instance`	`InstanceConstraints`	サンドボックスが配置可能なノードインスタンスタイプ。
`lifecycle`	`LifecycleConstraints`	サンドボックスの存続可能期間。
`metadata`	`MetadataConstraints`	アノテーションのキーと数。
`volumes`	`VolumeConstraints`	ストレージメディアとボリュームごとのサイズ。

`ResourceConstraints`

フィールド	タイプ	説明
`max_cpu`	string	コンテナーがリクエストできるCPUの最大値。Kubernetesのquantityとして指定します。
`max_memory`	string	コンテナーがリクエストできるメモリの最大値。
`min_cpu`	string	コンテナーがリクエストできるCPUの最小値。
`min_memory`	string	コンテナーがリクエストできるメモリの最小値。
`default_cpu`	string	サンドボックスがリクエストしない場合に適用されるCPU。
`default_memory`	string	サンドボックスがリクエストしない場合に適用されるメモリ。
`max_gpu_count`	int64	サンドボックスがリクエストできるGPUの最大数。
`cpu_ceiling`	string	サンドボックスの解決済み総CPUの上限。
`memory_ceiling`	string	サンドボックスの解決済み総メモリの上限。
`require_limits`	bool	trueの場合、CPUとメモリの両方の制限を宣言していないサンドボックスを拒否します。

上限は最大値とは異なります。max_cpuは1つのコンテナーのリクエストを制限しますが、cpu_ceilingは解決済みの合計を制限します。これはbaseが独自のコンテナーを提供する場合に重要です。

`ImageConstraints`

フィールド	タイプ	説明
`allowed_registries`	string list	サンドボックスのイメージの取得元として許可するレジストリ。空の場合はすべて許可されます。
`allowed_images`	string list	サンドボックスで実行を許可するイメージ (完全一致) 。空の場合はすべて許可されます。

`NetworkConstraints`

ネットワーク制約は、サンドボックスがリクエストできるアクセスの許可リストを定義します。サンドボックスが外向き通信を宣言した場合、ポリシーはその宣言を拡張せずに、受け入れるか拒否するかを判断します。サンドボックスが外向き通信を宣言しない場合は、サンドボックスで deny_egress が設定されていない限り、ポリシーによって default_egress が適用されます。プラットフォームの DNS とストレージへのアクセスは別途付与されます。

フィールド	タイプ	説明
`allowed_egress`	`EgressRule` リスト	外向き通信の許可リストです。サンドボックスの作成時にチェックされます。空でない場合、宣言されたすべてのルールがこのリストの範囲内に収まる必要があります。空の場合は、宣言可能なものがすべて許可されます。
`default_egress`	`EgressRule` リスト	サンドボックスが外向き通信を宣言せず、かつ `deny_egress` を設定していない場合に適用されます。宣言が 1 つでもあれば、全体がその宣言に置き換えられます。`allowed_egress` の範囲内に収まる必要があり、`https_hostname` ルールを含めることはできません。
`allowed_ingress`	`IngressRule` リスト	可視性が `CUSTOM` のポートに対するイングレスの許可リストです。サンドボックスの作成時にチェックされます。空でない場合、宣言されたすべてのルールがこのリストの範囲内に収まる必要があります。空の場合は、宣言可能なものがすべて許可されます。
`default_ingress`	`IngressRule` リスト	サンドボックスが可視性 `CUSTOM` のポートを公開し、イングレスを宣言せず、かつ `deny_ingress` を設定していない場合に適用されます。明示的なイングレスルールがあれば、全体がそのルールに置き換えられます。`allowed_ingress` の範囲内に収まる必要があります。
`deny_https_hostname_rules`	bool	true の場合、`allowed_egress` およびサンドボックスのリクエストに含まれる `https_hostname` ルールを拒否します。DNS クエリや、CIDR ルールで許可された HTTPS 通信はブロックしません。
`dns_egress`	`DNSEgressMode`	UDP/TCP ポート 53 の外向き DNS トラフィックを制御します。指定しない場合のデフォルトは `DNS_EGRESS_MODE_ALLOW` です。サンドボックスは `DNS_EGRESS_MODE_DENY` を選択できますが、ポリシーで `DENY` が必須とされている場合は `ALLOW` をリクエストできません。

許可リストが空でない場合、包含関係は送信先またはソースのタイプとポートに基づいてチェックされます。宣言された CIDR は、許可された CIDR 範囲を合わせた範囲内、または any ルールの範囲内に収まる必要があります。テナントスコープを宣言するには、一致するテナントルールまたは any ルールが必要です。また、any を宣言するには any ルールが必要です。

`EgressRule`

各ルールで指定する送信先は 1 つだけです。必要に応じて、ポートで絞り込むこともできます。

フィールド	タイプ	説明
`cidr`	`CidrBlock`	アドレス範囲。除外範囲を任意で指定できます。
`https_hostname`	string	HTTPS ホスト名。完全一致で指定するか、`.example.com` のように左端の 1 つのラベルだけをワイルドカードにして指定します。ホスト名ベースの HTTPS ルールをサポートするランナーが必要です。`allowed_egress` で `` を指定すると、任意のホスト名の宣言が許可されます。
`https_hostname_except`	string のリスト	このルールから除外するホスト名。`allowed_egress` 内で `https_hostname` と併用する場合にのみ有効です。`*` 以外は同じホスト名パターンを使用できます。
`tenant`	`TenantScope`	関係性に基づいて選択される他のサンドボックス。
`any`	bool	プラットフォーム内部の範囲を除く、到達可能なすべての送信先。他のサンドボックスやクラスター内のワークロードに到達するには、tenant ルールまたは selector ルールを使用してください。
`selector`	`SelectorBlock`	ラベルで選択されるワークロード。
`ports`	`PortRange` のリスト	ルールを適用するポート。省略するとすべてのポートが対象になります。ただし、`https_hostname` ルールで許可されるのは TCP 443 のみです。

ホスト名ルールで許可されるのは HTTPS アクセスであり、DNS クエリは対象外です。allowed_egress が空でない場合、宣言するホスト名は、除外を適用した後の許可済みホスト名パターン、または any ルールのいずれかに当てはまる必要があります。CIDR のみで構成された許可リストでは、ホスト名を宣言できません。再利用するホスト名のグラントは、default_egress ではなくサンドボックステンプレートに記述してください。 dns_egress は、UDP/TCP ポート 53 への外向き通信を個別に制御します。DNS_EGRESS_MODE_ALLOW は、プラットフォームのリゾルバーへのアクセスを許可します。その他のリゾルバーを使用するには、外向き通信ルールが必要です。DNS_EGRESS_MODE_DENY は、他のルールで許可されている場合でも、ポート 53 への外向き通信をブロックします。ただし、ローカルで応答されるルックアップや、HTTPS など許可されている他のトランスポートを経由する DNS はブロックされません。

`IngressRule`

Field	タイプ	Description
`cidr`	`CidrBlock`	オプションの除外を含むアドレス範囲。
`tenant`	`TenantScope`	関係によって選択された他のサンドボックス。
`any`	bool	任意のソース。
`ports`	`PortRange` リスト	ルールが適用されるポート。省略すると、可視性が `CUSTOM` のすべてのポートが対象になります。

イングレスルールはソースを名前で指定することはありません。インバウンドパケットには名前が含まれていないためです。

`CidrBlock`

フィールド	タイプ	説明
`cidr`	string	必須。アドレス範囲、例: `10.0.0.0/8`。
`except`	string list	`cidr` から切り出された範囲。除外は自身のルールのみを狭めます。

`PortRange`

フィールド	タイプ	説明
`protocol`	string	オプション。デフォルトは TCP。
`port`	int32	必須。ポート、または範囲の開始。
`end_port`	int32	オプション。範囲の終了。

`TenantScope`

Value	選択対象
`TENANT_SCOPE_SAME_USER`	同じユーザーが所有するサンドボックス。
`TENANT_SCOPE_SAME_ORG`	同じ組織内のサンドボックス。
`TENANT_SCOPE_SANDBOX_NETWORK`	同じサンドボックスネットワーク上のサンドボックス。まだサポートされていません。この値を使用する外向き通信ルールは拒否されます。

`SelectorBlock`

フィールド	タイプ	説明
`pod_labels`	string map	必須。送信先のPodに一致するラベル。
`namespace_labels`	string map	オプション。送信先のnamespaceに一致するラベル。

一致判定はラベルペアの完全一致で行われますが、宣言側でラベルを追加することもできます。外向き通信の許可リストが空でない場合、宣言されたセレクターには、一致するセレクタールールのラベルペアがすべて含まれている必要があります。namespace ラベルは、両方のセレクターで省略するか、両方で指定する必要があります。指定する場合は、必要な namespace ラベルペアがすべて宣言側に含まれている必要があります。any ルールはセレクターには適用されませんが、許可リストが空の場合はセレクターを宣言できます。

`SecurityConstraints`

フィールド	タイプ	説明
`allow_privileged`	bool	コンテナーが特権モードで実行できるかどうか。
`allowed_capabilities`	string list	コンテナーが追加できるLinuxのケーパビリティ。
`allowed_seccomp_profiles`	string list	許可されるseccompプロフィール (例: `RuntimeDefault` や `Unconfined`) 。
`allow_host_network`	bool	サンドボックスがホストのネットワークnamespaceを使用できるかどうか。非推奨で削除予定。
`allow_host_pid`	bool	サンドボックスがホストのPIDnamespaceを使用できるかどうか。非推奨で削除予定。
`allowed_runtime_classes`	string list	サンドボックスがピン留めできるランタイムクラス。フェイルクローズド: 空の場合は一切のピン留めを許可しない。
`default_cpu_runtime_class`	string	ピン留めを行わないCPUサンドボックスに適用されるランタイムクラス。
`default_gpu_runtime_class`	string	ピン留めを行わないGPUサンドボックスに適用されるランタイムクラス。

allowed_runtime_classes は、空が「何もなし」を意味する唯一のリストであり、「何でも」を意味するわけではない。サンドボックスは、明示的に指定したランタイムクラスのみを選択できる。ホストに到達する設定はポリシーのみで、サンドボックスの spec には表示されない。使用する分離方式に関係なく。

`InstanceConstraints`

フィールド	タイプ	説明
`allowed_instance_types`	string list	サンドボックスが配置可能なノードのインスタンスタイプ。空の場合はすべてを許可。

`LifecycleConstraints`

Field	タイプ	Description
`default_lifetime_seconds`	int32	サンドボックスが指定しない場合に適用される有効期間。

ポリシーは有効期間の上限を持ちません。プラットフォームの最大値 (現在30日) がすべてのサンドボックスを制限します：それを超える作成リクエストは拒否されます。max_lifetime_seconds フィールドはポリシードキュメントから削除され、cwic はそれを含むポリシーを拒否します。

`MetadataConstraints`

Field	タイプ	Description
`denied_annotation_prefixes`	string list	拒否されるアノテーションキーの接頭辞。
`max_annotation_count`	int32	サンドボックスが設定できるアノテーションの最大数。`0` は制限なしを意味します。

`VolumeConstraints`

フィールド	タイプ	説明
`allowed_media`	`StorageMedium` list	許可するストレージメディア。空の場合はすべて許可されます。
`max_size`	string	ボリュームあたりの最大サイズ (例: `100Gi`) 。

`StorageMedium`

Value	Description
`STORAGE_MEDIUM_UNSPECIFIED`	プラットフォームのデフォルトで、ディスクバックアップです。
`STORAGE_MEDIUM_DISK`	ディスクバックアップ。
`STORAGE_MEDIUM_MEMORY`	RAMバックアップで、コンテナーのメモリにカウントされます。

allowed_media から STORAGE_MEDIUM_MEMORY を省略して、RAMバックアップのボリュームを禁止します。

検証ルール

ポリシーは、以下のいずれかに該当する場合に拒否されます：

エンコードされたドキュメントが256 KiBを超える。
ポリシーがnullです。設定されたポリシーはクリアできず、置き換えることのみ可能です。
default_egress に https_hostname ルールが含まれている。
デフォルトの外向き通信ルールまたはイングレスルールが、対応する許可リストの範囲外にある。

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

ポリシーリファレンス

トップレベルフィールド

解決順序

`base`

`constraints`

`ResourceConstraints`

`ImageConstraints`

`NetworkConstraints`

`EgressRule`

`IngressRule`

`CidrBlock`

`PortRange`

`TenantScope`

`SelectorBlock`

`SecurityConstraints`

`InstanceConstraints`

`LifecycleConstraints`

`MetadataConstraints`

`VolumeConstraints`

`StorageMedium`

検証ルール

関連項目

​トップレベルフィールド

​解決順序

​base

​constraints

​ResourceConstraints

​ImageConstraints

​NetworkConstraints

​EgressRule

​IngressRule

​CidrBlock

​PortRange

​TenantScope

​SelectorBlock

​SecurityConstraints

​InstanceConstraints

​LifecycleConstraints

​MetadataConstraints

​VolumeConstraints

​StorageMedium

​検証ルール

​関連項目

トップレベルフィールド

解決順序

`base`

`constraints`

`ResourceConstraints`

`ImageConstraints`

`NetworkConstraints`

`EgressRule`

`IngressRule`

`CidrBlock`

`PortRange`

`TenantScope`

`SelectorBlock`

`SecurityConstraints`

`InstanceConstraints`

`LifecycleConstraints`

`MetadataConstraints`

`VolumeConstraints`

`StorageMedium`

検証ルール

関連項目