ポリシーの例

このページでは、一般的なクラスターのポスチャーに対応する5つの完全なポリシーをまとめています。そのため、ゼロから作成するのではなく、機能するドキュメントから開始できます。クラスターにはポリシーが1つだけ存在するため、これらのサンプルは組み合わせて使用するものではなく、代替となるものです。クラスターの目的に合ったポスチャーを選択し、調整してください。各サンプルは完全なポリシードキュメントです。cwic sandbox runner policy edit [RUNNER-ID] -f policy.json を使用して適用するか、ランナー更新の policy フィールドとして送信します。[RUNNER-ID] をポリシーを編集したいランナーの ID に置き換え、イメージレジストリのサンプルの [GITHUB-ORG] を GitHub Container Registry の組織名またはユーザー名に置き換えてください。フィールドごとの詳細な手順については、サンドボックスポリシーを設定するを参照してください。

GPU データサイエンスクラスター

ユーザーごとの長期的な作業向けのクラスターです。十分なコンピュート、GPU Node に加え、データセットやパッケージをプルするためのインターネットアクセスを備えています。ただし、インスタンスメタデータエンドポイントへのアクセスは除外されています。

policy.json

{
  "displayName": "Data science, GPU",
  "constraints": {
    "resources": {
      "defaultCpu": "4",
      "defaultMemory": "16Gi",
      "maxCpu": "16",
      "maxMemory": "128Gi",
      "maxGpuCount": "2",
      "requireLimits": true
    },
    "instance": { "allowedInstanceTypes": ["h100"] },
    "image": { "allowedRegistries": ["ghcr.io/[GITHUB-ORG]"] },
    "network": {
      "allowedEgress": [
        { "cidr": { "cidr": "0.0.0.0/0", "except": ["169.254.169.254/32"] } }
      ],
      "defaultEgress": [
        { "cidr": { "cidr": "0.0.0.0/0", "except": ["169.254.169.254/32"] } }
      ]
    },
    "security": {
      "allowPrivileged": false,
      "allowedRuntimeClasses": ["kata-qemu", "cw-kata-nvidia-gpu"],
      "defaultCpuRuntimeClass": "kata-qemu",
      "defaultGpuRuntimeClass": "cw-kata-nvidia-gpu",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 86400 }
  }
}

allowedRuntimeClasses はフェイルクローズで動作するため、両方のランタイムクラスを列挙しています。サンドボックスが固定できるのは明示的に指定したクラスのみで、クラスを固定しない場合にどのクラスが割り当てられるかは、2 つのデフォルトによって決まります。

許可リスト付き外向き通信を備えた共有エージェントクラスター

組織内のエージェントワークロード向けのマルチテナントクラスターです。エージェントは組織内の固定された上流のセットと相互に到達可能で、それ以外には到達できません。

policy.json

{
  "displayName": "Agents, allowlisted egress",
  "constraints": {
    "resources": {
      "defaultCpu": "1",
      "defaultMemory": "2Gi",
      "maxCpu": "4",
      "maxMemory": "8Gi",
      "requireLimits": true
    },
    "network": {
      "allowedEgress": [
        { "cidr": { "cidr": "140.82.112.0/20" }, "ports": [{ "port": 443 }] },
        { "cidr": { "cidr": "151.101.0.0/16" }, "ports": [{ "port": 443 }] },
        { "tenant": "TENANT_SCOPE_SAME_ORG" }
      ],
      "defaultEgress": [
        { "cidr": { "cidr": "140.82.112.0/20" }, "ports": [{ "port": 443 }] }
      ]
    },
    "security": {
      "allowPrivileged": false,
      "allowedRuntimeClasses": ["kata-qemu"],
      "defaultCpuRuntimeClass": "kata-qemu",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 3600 }
  }
}

何も宣言しないサンドボックスには、最初の CIDR のみが許可されます。組織内の他のサンドボックスと通信する必要があるサンドボックスは、テナントルールを自ら宣言します。このルールはポリシーの範囲内に収まるため、ポリシーによって許可されます。

エフェメラル CI クラスター

短命で、小規模かつ狭いものです。サンドボックスは test run の期間だけ存在します。

policy.json

{
  "displayName": "CI",
  "constraints": {
    "resources": {
      "defaultCpu": "250m",
      "defaultMemory": "512Mi",
      "maxCpu": "2",
      "maxMemory": "4Gi",
      "requireLimits": true
    },
    "image": { "allowedRegistries": ["ghcr.io/[GITHUB-ORG]"] },
    "network": {
      "allowedEgress": [
        { "cidr": { "cidr": "140.82.112.0/20" }, "ports": [{ "port": 443 }] }
      ],
      "defaultEgress": [
        { "cidr": { "cidr": "140.82.112.0/20" }, "ports": [{ "port": 443 }] }
      ]
    },
    "security": {
      "allowPrivileged": false,
      "allowedRuntimeClasses": ["gvisor"],
      "defaultCpuRuntimeClass": "gvisor",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 900 },
    "volumes": { "allowedMedia": ["STORAGE_MEDIUM_DISK"], "maxSize": "10Gi" }
  }
}

15 分のデフォルトが有用な部分です。何も宣言しない CI ジョブはすぐに自己終了します。ポリシーに有効期間の上限はありません。プラットフォームの最大値である 30 日を超えるリクエストは作成時に拒否され、それ以下のものは許可されます。そのため、ハードなジョブごとの上限が必要な場合は、作成リクエストで max_lifetime_seconds を設定してください。

デフォルトの外向き通信がない VM 分離実行

このポリシーは VM 分離を必須とし、デフォルトの外向き通信ルールを定義しません。UDP/TCP ポート 53 宛ての外向き DNS トラフィックはブロックしますが、allowedEgress が空であるため、サンドボックスはその他の外向き通信を宣言できます。

policy.json

{
  "displayName": "VM-isolated execution",
  "constraints": {
    "resources": {
      "defaultCpu": "500m",
      "defaultMemory": "512Mi",
      "maxCpu": "2",
      "maxMemory": "2Gi",
      "requireLimits": true
    },
    "image": { "allowedImages": ["ghcr.io/[GITHUB-ORG]/sandbox-base:pinned"] },
    "network": {
      "allowedEgress": [],
      "defaultEgress": [],
      "dnsEgress": "DNS_EGRESS_MODE_DENY"
    },
    "security": {
      "allowPrivileged": false,
      "allowedCapabilities": [],
      "allowedRuntimeClasses": ["kata-qemu"],
      "defaultCpuRuntimeClass": "kata-qemu",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 300 },
    "metadata": { "maxAnnotationCount": 0 },
    "volumes": { "allowedMedia": ["STORAGE_MEDIUM_DISK"], "maxSize": "5Gi" }
  }
}

このポリシーは、完全なネットワーク分離を強制するものではありません。allowedEgress リストが空でも明示的な送信先ルールは許可されます。また、プラットフォームのストレージへのアクセスは別途付与されます。dnsEgress は外向きのポート 53 をブロックしますが、HTTPS など、許可されている他のトランスポートを経由した DNS はブロックしません。

allowedImages はレジストリ単位ではなく 1 つのイメージを固定するため、サンドボックスが信頼済みレジストリから任意のイメージを選択することはできません。

内部ワーカークラスター

組織内の他のサンドボックスからサービス経由でアクセスできる、長時間稼働するバックグラウンドワーカーです。サードパーティ API の呼び出し用に外部へのアクセスを備えています。

policy.json

{
  "displayName": "Internal workers",
  "constraints": {
    "resources": {
      "defaultCpu": "1",
      "defaultMemory": "2Gi",
      "maxCpu": "8",
      "maxMemory": "16Gi",
      "requireLimits": true
    },
    "image": { "allowedRegistries": ["ghcr.io/[GITHUB-ORG]"] },
    "network": {
      "allowedEgress": [
        { "cidr": { "cidr": "0.0.0.0/0", "except": ["10.0.0.0/8", "169.254.169.254/32"] } },
        { "tenant": "TENANT_SCOPE_SAME_ORG" }
      ],
      "defaultEgress": [{ "tenant": "TENANT_SCOPE_SAME_ORG" }]
    },
    "security": {
      "allowPrivileged": false,
      "allowedRuntimeClasses": ["kata-qemu"],
      "defaultCpuRuntimeClass": "kata-qemu",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 604800 }
  }
}

外向き通信の範囲は、ワーカーがパブリックインターネットと組織内の同階層のサンドボックスに到達できるように設定されており、プライベートアドレス空間とメタデータアドレスは除外されています。

この例では外向き通信のみを設定します。可視性が CUSTOM のポートへの受信アクセスを制限するには、allowedIngress を追加し、必要に応じて defaultIngress も追加します。詳しくは、ネットワークアクセスを制限するを参照してください。

ベースレイヤーで管理者デフォルトを固定する

上記のどのポリシーにも base フラグメントを含めることができます。これは管理者が設定するアタッチメントで、サンドボックスが何を要求するかにかかわらず、ランナー上のすべてのサンドボックスに適用されます。次に示す内部ワーカーポリシーのバリエーションでは、ノードの選択、プライベートレジストリ用のイメージプルシークレット、コスト配分ラベルをすべてのサンドボックスに固定しています。

policy.json

{
  "displayName": "Internal workers, pinned scheduling",
  "base": {
    "spec": {
      "nodeSelector": { "workload": "sandbox" },
      "tolerations": [
        { "key": "sandbox-only", "operator": "Exists", "effect": "NoSchedule" }
      ],
      "imagePullSecrets": [{ "name": "regcred" }]
    },
    "metadata": {
      "labels": { "cost-center": "sandboxes" }
    }
  },
  "constraints": {
    "resources": {
      "defaultCpu": "1",
      "defaultMemory": "2Gi",
      "maxCpu": "8",
      "maxMemory": "16Gi",
      "requireLimits": true
    },
    "image": { "allowedRegistries": ["ghcr.io/[GITHUB-ORG]"] },
    "security": {
      "allowPrivileged": false,
      "allowedRuntimeClasses": ["kata-qemu"],
      "defaultCpuRuntimeClass": "kata-qemu",
      "allowedSeccompProfiles": ["RuntimeDefault"]
    },
    "lifecycle": { "defaultLifetimeSeconds": 604800 }
  }
}

base フラグメントは、周辺の制約フィールドとは異なり、camelCase キーを使用した Kubernetes の Pod 仕様のサブセットであり、不明なキーは拒否されます。受け入れるのはスケジューリングとランタイムの接続のみです: nodeSelector、tolerations、imagePullSecrets、volumes、topologySpreadConstraints、hostAliases、DNS 設定、name、env、envFrom、volumeMounts、volumeDevices に限定された単一の containers エントリ、および Pod のラベルとアノテーションです。セキュリティ上重要なフィールドは拒否されます: securityContext、runtimeClassName、initContainers、affinity、ホスト namespace、hostPath ボリューム、デフォルト以外のサービスアカウント、およびランナーが所有する namespace です。有効期間、イメージ、外向き通信などの型指定された項目は constraints に属し、base には属しません。 CKS クラスターでは、template attachments がテンプレートごとにこのフラグメントを特化します: imagePullSecrets と tolerations は結合され、重複排除され、他のリストは追加され、マップキーはキーごとに上書きされ、同じ名前の競合は作成を拒否します。base の現在の適用ステータスについては、ベースレイヤーを参照してください。

クラスター間でポスチャーを変える

ポリシーはクラスターに属するため、異なるポスチャーは1つのクラスター上の異なるドキュメントではなく、異なるクラスターとなります。オープンなデータサイエンス環境とロックダウンされた実行環境の両方を必要とするチームは、2つのクラスターを実行し、それぞれに一致するポリシーを割り当てます。リージョンごとに1つのディメンションを変えるには、リージョン固有の値を変更した同じポリシーを各クラスターに適用します。共有または継承されたポリシードキュメントはないため、信頼できるソースをバージョン管理に保持し、クラスターごとに適用します。

サンドボックス

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

サンドボックスの管理

リファレンス

GPU データサイエンスクラスター

許可リスト付き外向き通信を備えた共有エージェントクラスター

エフェメラル CI クラスター

デフォルトの外向き通信がない VM 分離実行

内部ワーカークラスター

ベースレイヤーで管理者デフォルトを固定する

クラスター間でポスチャーを変える

関連項目

​GPU データサイエンスクラスター

​許可リスト付き外向き通信を備えた共有エージェントクラスター

​エフェメラル CI クラスター

​デフォルトの外向き通信がない VM 分離実行

​内部ワーカークラスター

​ベースレイヤーで管理者デフォルトを固定する

​クラスター間でポスチャーを変える

​関連項目

GPU データサイエンスクラスター

許可リスト付き外向き通信を備えた共有エージェントクラスター

エフェメラル CI クラスター

デフォルトの外向き通信がない VM 分離実行

内部ワーカークラスター

ベースレイヤーで管理者デフォルトを固定する

クラスター間でポスチャーを変える

関連項目