OpenShell Kubernetes Operator
OpenShell Kubernetes Operator (github.com)
要約
OpenShell Kubernetes Operatorは、OpenShellサンドボックスをKubernetesネイティブに宣言的に管理するためのツールです。kubectl applyを使用して、OpenShellサンドボックスのライフサイクル、プロバイダー、ポリシー、ワークスペースなどをKubernetesリソースとして定義・管理できます。このオペレーターは、Agent Sandbox Kubernetes SIGプロジェクトと連携し、開発やデモ用途に適した迅速なセットアップを提供します。
全文翻訳
OpenShell Kubernetes Operator
OpenShellサンドボックスに対する宣言的でKubernetesネイティブな制御 — ゲートウェイに直接対話するのではなく、kubectl applyで管理します。
ステータス: 初期開発段階。5つのリソースが実装されています:
OpenShellSandbox(フルライフサイクル — ファイナライザーのクリーンアップ、プロビジョニングされたボリューム、インプレースでの収束、ドリフト時の再作成)、OpenShellProvider(Secretからの認証情報、静的コピーまたはゲートウェイ発行のリフレッシュとして同期)、OpenShellPolicy(サンドボックス作成時に適用される再利用可能なポリシー)、OpenShellWorkspace(宣言的なメンバーシップを持つクラスター スコープのテナンシー境界)、およびOpenShellProviderProfile(クラスター スコープでプラットフォーム スコープのプロバイダータイプ定義)。
何をするものか
このオペレーターは、OpenShellゲートウェイのgRPC APIの薄いフロントエンドです。カスタムリソースとして望ましい状態を宣言すると、オペレーターがそれらをゲートウェイ呼び出しに調整し、ゲートウェイの状態をリソースの.statusにミラーリングします。ゲートウェイを再実装するものではありません。
インストール
前提条件: Agent Sandbox
OpenShellゲートウェイは、Agent Sandbox Kubernetes SIGプロジェクト(sandboxes.agents.x-k8s.io)を通じてサンドボックスポッドをプロビジョニングします。そのコントローラーとCRDはクラスター全体で必須です — バンドルされたゲートウェイを使用する場合でも、自分で用意する場合でも、チャートの前に一度インストールしてください:
kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/download/v0.5.2/sandbox.yaml
kubectl -n agent-sandbox-system rollout status deploy/agent-sandbox-controller
これがないと、ゲートウェイは起動しますが、そのコンピュートドライバーはno supported Agent Sandbox API version is availableをログに出力し、サンドボックスを作成できません。チャートはこれをバンドルしません — これは共有のクラスターインフラストラクチャ(CRD + コントローラー)であり、このリリースにライフサイクルを紐付けるべきではありません。ゲートウェイの後にインストールした場合、ゲートウェイを再起動して、提供されているAPIを再検出させてください。
チャート
1つのコマンドで、ゲートウェイ、OIDC発行者、およびオペレーターの完全なスタックがインストールされ、すでに連携されています:
helm install openshell deploy/charts/openshell-operator \
--namespace openshell-system --create-namespace
デフォルト(gateway.bundled=true)では、チャートはアップストリームのOpenShellゲートウェイをサブチャートとしてプルし、小さな静的なOIDC発行者を起動してオペレーターの管理者ベアラーを発行し、TLS経由でオペレーターをゲートウェイに向けます — 外部ゲートウェイ、IdP、または手動設定は不要です。バンドルされたゲートウェイはTLSを自己署名し(cert-manager不要)、一時的なSQLiteストアを使用し、固定のインクラスターIDを取るため、名前空間ごとの1つのリリース向けであり、本番環境ではなく開発/デモ向けです。
--set gateway.bundled=false --set gateway.endpoint=https://your-gateway:8080で独自のゲートウェイを使用します。この場合、チャートはオペレーター(およびデフォルトで発行者)のみをインストールし、インストールノートにissuer/audience/admin_roleの値が表示され、ゲートウェイが発行者を信頼するように設定します。発行者はプライベートCAでHTTPSを提供し、ConfigMapに公開されます。それをゲートウェイの名前空間にコピーし、ゲートウェイチャートのserver.oidc.caConfigMapNameに設定します。サンドボックスボリュームについては、server.drivers.kubernetes.allowDriverConfig=trueも設定してください。または、バンドルされた発行者の代わりにトークンSecret(auth.byo.tokenSecret)をマウントするためにauth.mode=byoを設定します。設計についてはdocs/operator-auth.mdを参照してください。
operator.deployStandalone=falseは、CRDとRBACのみをインストールします(オペレーターコンテナを他の場所に埋め込むため。gateway.bundled=falseと組み合わせて使用)。
高可用性。 リーダー選出はデフォルトで有効になっているため、オペレーターのスケーリングは安全です: --set replicaCount=3は3つのレプリカを実行し、それらはcoordination.k8s.io Leaseを競合し、ホルダーのみが調整を許可し、残りは待機状態になるため、ローリングアップデートまたはノード損失時にクリーンにフェイルオーバーします。コンテナはポート8080で/healthz(liveness)および/readyz(readiness)を提供し、プローブとして配線されています。readinessはリーダーシップをゲートしないため、スタンバイは準備完了を報告し、ロールアウトを遅延させることはありません。
replicaCountを増やすと、PodDisruptionBudget(minAvailable: 1、ノードドレインが最後の利用可能なレプリカをエビクトできないようにする)とソフトな同一ノードスプレッドも提供されます。ソフトなので、レプリカ数よりノード数が少ないクラスターでもすべてスケジュールされます。両方ともreplicaCountに従います。単一レプリカの場合、予算は順序付けするものがなく、ドレインをスタックさせるだけなのでレンダリングされません(そこで1つを要求してもレンダリング時に拒否されます)。厳密またはゾーンスプレッドのためにtopologySpreadConstraintsを置き換え、ノード圧力下でオペレーターがエビクションリストから外れるようにpriorityClassNameを設定してください。
オペレーターポッドへのイングレス専用NetworkPolicyがnetworkPolicy.enabled=trueで利用可能で、プローブおよびWebフックポートへの到達可能性を制限します。デフォルトではオフになっています。ポリシーは、それを強制しないCNIの下ではサイレントに不活性であるためです。エグレスは意図的にそのままにされています: オペレーターがダイヤルするもの(APIサーバー、ゲートウェイ、DNS)はクラスター固有であるため、独自のEgressポリシーと組み合わせてください。
主要な値: gateway.bundled, gateway.endpoint, gateway.caSecret, auth.mode, auth.oidc.*, image.repository / image.tag, logLevel, crds.install, operator.deployStandalone, replicaCount, leaderElection.enabled, podDisruptionBudget.enabled, topologySpreadConstraints, priorityClassName, networkPolicy.enabled, webhook.execConfinement.enabled, resources。
例
完全で自己完結型のセットアップ: 認証情報Secret、ゲートウェイにそれをバインドするOpenShellProvider、サンドボックスを制約するOpenShellPolicy、およびprovidersとpolicyRefを介して両者をまとめるOpenShellSandbox。
# 認証情報はSecretに格納され、CR上には決して格納されません。参照されることをオプトインします。
apiVersion: v1
kind: Secret
metadata:
name: anthropic-credentials
annotations:
openshell.lenshq.io/allow-provider-ref: "true"
stringData:
ANTHROPIC_API_KEY: sk-ant-...
---
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellProvider
metadata:
name: anthropic
spec:
type: claude-code # インポートされたゲートウェイプロバイダープロファイルID(エイリアスではなく正確なもの)
credentialsSecretRef:
name: anthropic-credentials # keys: [] はすべてのキーを読み取ります
---
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellPolicy
metadata:
name: restricted
spec:
filesystem:
# マウントオプションではなく、Landlockの許可リストです。空でない場合、エントリポイントが実行できないものを含め、
# 存在しないものはすべて拒否されます。エントリポイントが必要なものをリストアップしてください。
includeWorkdir: true
readOnly: ["/usr", "/lib", "/proc", "/dev/urandom", "/app", "/etc", "/var/log"]
readWrite: ["/tmp", "/dev/null"]
process:
runAsUser: sandbox
networkPolicies:
claude_code:
endpoints:
- host: api.anthropic.com
port: 443
---
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellSandbox
metadata:
name: my-sandbox
spec:
image: ghcr.io/nvidia/openshell-community/sandboxes/python:latest
environment:
LOG_LEVEL: debug
providers:
- anthropic # 上記のOpenShellProvider
policyRef: restricted # 上記のOpenShellPolicy、作成時に適用
gpu: false
gpuCount: 1 # gpuがtrueの場合に要求するGPU数(それ以外の場合は無視)
logLevel: info # sandbox-runtimeのログレベル
runtimeClassName: gvisor # コンピュートプラットフォームから要求されるRuntimeClass。openshell.ai/sandbox-attachable: "true"ラベルを持つ必要があります
resources: # サンドボックスポッドのCPU/メモリ(Kubernetesの数量)
requests:
cpu: "500m"
memory: 512Mi
limits:
cpu: "2"
memory: 2Gi
labels: # サンドボックスのポッドに適用される
team: platform
annotations:
example.com/owner: platform
volumes: # オペレータープロビジョニング、再作成間で永続化
- name: work
mountPath: /data
claim:
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 10Gi
volumeRetention: Retain # サンドボックスが削除されたときにPVCを保持(デフォルト)
$ kubectl apply -f example.yaml
$ kubectl get oss
NAME READY PHASE SANDBOX AGE
my-sandbox True Ready 3f2b... 30s
$ kubectl get osp anthropic
NAME TYPE READY AGE
anthropic claude True 30s
$ kubectl get ospol restricted
NAME READY AGE
restricted True 30s
$ kubectl wait --for=condition=Ready oss/my-sandbox
openshellsandbox.openshell.lenshq.io/my-sandbox condition met
以下のセクションでは、各リソースタイプを詳細に説明します。
プロバイダー
OpenShellProviderは、ゲートウェイ上で認証情報セットをバインドします。認証情報の値はリソース上に格納されることはありません — オペレーターは同じ名前空間のSecretから読み取ります。このSecretは、openshell.lenshq.io/allow-provider-ref: "true"アノテーションでオプトインする必要があります(上記の例のOpenShellProviderとSecretを参照)。オペレーターはSecretを監視するため、外部ローテーション(external-secrets, Vault)は再同期をトリガーします。
credentialsSecretRef.keysはSecretのキーのサブセットを選択し(空の場合はすべて読み取ります)、spec.configは(例: region)非シークレット設定をゲートウェイに渡します。
認証情報の処理
同じOpenShellProvider(追加フィールドなし)で、ゲートウェイがそのtypeに対してサポートする最も強力な認証情報処理を取得します。調整時にオペレーターはプロバイダータイププロファイルを読み取り、各認証情報ごとに選択します:
Copied— 値はゲートウェイに静的キー(例:claude-code)として保存されます。Refresh— ゲートウェイは、Secretで提供するシードマテリアル(OAuth2リフレッシュ/クライアントクレデンシャル、GoogleサービスアカウントJWT)から短命のトークンを発行します。長命のシードはゲートウェイのリフレッシュストアにのみ存在し、保存された静的認証情報としては存在しません。オペレーターはそれを一度設定し、Secretのローテーション時に再シードします — トークン自体を発行しません。Mixed— 両方を使用するマルチ認証情報プロバイダー。
オペレーターは選択されたティアを.status.credentialMode(Modeプリントカラム)に表示します。Refreshを取得するためにCRに変更はありません — Secretの内容のみが異なり、プロバイダータイプによって決定されます:
apiVersion: v1
kind: Secret
metadata:
name: vertex-credentials
annotations:
openshell.lenshq.io/allow-provider-ref: "true"
stringData:
# google-vertex-aiのgcloud_adc_tokenリフレッシュマテリアル — オペレーターはこれらを
# 保存された静的認証情報ではなく、ゲートウェイのリフレッシュ設定にルーティングします。
client_id: "...apps.googleusercontent.com"
client_secret: "..."
refresh_token: "1//..."
---
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellProvider
metadata:
name: vertex
spec:
type: google-vertex-ai
credentialsSecretRef:
name: vertex-credentials
$ kubectl get openshellproviders
NAME TYPE MODE READY
anthropic claude-code Copied True
vertex google-vertex-ai Refresh True
リフレッシュ可能な認証情報が部分的にしかプロビジョニングされていない場合(一部の必須マテリアルが不足している)、オペレーターは静的コピーにフォールバックし、サイレントに劣化するのではなく警告をログに出力します。AWS STS assume-roleは認識されますが、延期されます(providers_v2の背後でゲートウェイによってゲートされている)ため、現在はCopiedのままです。
ポリシー
OpenShellPolicy(上記の例を参照)は、再利用可能なサンドボックスポリシー文書です。OpenShellSandboxはspec.policyRefを介してそれを名前指定します。オペレーターはそれを解決し、サンドボックスが作成されたときに適用します。高価値のセクション(filesystem, landlock, process)は型付けされています。networkPoliciesは不透明にパススルーされ、ゲートウェイ自体のパーサーがそれを検証します。オペレーターがここでミラーリングするのではなく。OpenShellPolicyレコンサイラーは文書を検証し、そのReady条件に結果を報告します(条件メッセージにパーサーの診断が含まれます)。そのため、無効なポリシーはサンドボックスが使用する前に表面化します。
一時的なサンドボックスの場合、個別のリソースをスキップし、spec.policyRefの代わりにspec.policyの下に同じ文書を直接インライン化できます(2つのうち1つのみを指定):
kind: OpenShellSandbox
spec:
policy:
filesystem:
includeWorkdir: true
readOnly: ["/usr", "/lib", "/proc", "/dev/urandom", "/app", "/etc", "/var/log"]
readWrite: ["/tmp", "/dev/null"]
process:
runAsUser: sandbox
ポリシー(インラインまたは共有OpenShellPolicy)の編集は遡及的です。オペレーターは参照されるポリシーを監視し、それらを指定するすべてのサンドボックスを再収束します。どのように収束するかはセクションによります(更新と再作成を参照)。networkPoliciesと加算的なfilesystemの変更はインプレースでライブサンドボックスにプッシュされますが、landlock/processの変更は再作成を強制します。ゲートウェイがそれらを不変として保持するためです。共有ポリシーが見つからなくなったり無効になったりしても、実行中のサンドボックスは削除されません。サンドボックスは最後に適用されたポリシーを保持し、そのReady条件で障害が表面化します。
ワークスペース
ワークスペースは、サンドボックスとプロバイダーのゲートウェイの分離境界です。ゲートウェイ上では、その名前は単一のフラットなグローバル名前空間であるため、OpenShellWorkspaceはクラスター スコープです — metadata.nameがゲートウェイワークスペース名であり、それを1つ作成したり、メンバーを付与したりすることはクラスターレベルの管理であり、名前空間テナントがセルフサービスできるものではありません。これはNamespaceやStorageClassのようなテナントであり、チームごとのリソースではありません。
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellWorkspace
metadata:
name: team-ml # DNS-1123ラベル、≤19文字、連続するハイフンなし
spec:
labels:
owner: ml-platform
members:
- subject: alice@example.com # OIDC `sub`クレーム
role: Admin
- subject: bob@example.com
role: User
名前空間スコープのOpenShellSandboxとOpenShellProviderは、spec.workspace: team-mlでワークスペースに参加します。空または省略された値は、ゲートウェイの組み込みdefaultワークスペースを使用します(したがって、既存のリソースには影響しません)。spec.workspaceは不変です — ゲートウェイはオブジェクトを{workspace}--{name}と名前付けするため、変更は古いオブジェクトを移動するのではなく孤立させるため、別の場所に配置するにはリソースを削除して再作成する必要があります。
メンバーシップは、spec.membersが存在する場合(空でも)に権威があります。オペレーターはゲートウェイのメンバーをリストされたセットと正確に一致するように収束します — 追加、削除、およびロール変更時の再付与を行います。メンバーシップを完全に省略すると、アウトオブバンドツールにメンバーシップを任せます。オペレーターはその場合、ワークスペースのライフサイクルのみを管理します。spec.labelsは作成時にのみ適用されます — ゲートウェイにはワークスペース更新RPCがないため、後からのラベル編集は収束しません。
削除はファイナライザーによって保護されています。ゲートウェイはブロックを確認する前にワークスペースを終了としてマークするため、削除後に元に戻すことはできません。したがって、リソースを保持しているワークスペースを削除しようとすると、永久にスタックします。そのため、オペレーターはOpenShellSandboxまたはOpenShellProviderがまだ参照している間はワークスペースの削除を拒否します(空になるまでReady条件にWorkspaceNotEmptyを表示します)。また、組み込みのdefaultは決して削除しません。
プロバイダープロファイル
プロバイダープロファイルは、プロバイダーのタイプ定義です — OpenShellProviderがインスタンス化されるスキーマとテンプレートです。OpenShell v0.1以降、ゲートウェイは組み込みプロファイルを提供しません。そのカタログには、インポートされたものだけが含まれています。アップストリームは、そのproviders/ディレクトリ(claude-code, github, …)にレビュー可能な例を保持しています。OpenShellProviderProfileを使用すると、プラットフォーム管理者はそれを宣言的にインポートできるため、そのtypeのOpenShellProviderが同期できるようになります。これはクラスター スコープであり、ゲートウェイのプラットフォームスコープでインポートされるため、すべてのワークスペースで共有されます — metadata.nameがプロファイルID(小文字のケバブケース)です。ワークスペース スコープのプロファイルは、後のリビジョンで延期されます。
apiVersion: openshell.lenshq.io/v1alpha1
kind: OpenShellProviderProfile
metadata:
name: acme-inference
spec:
displayName: Acme Inference
category: inference
inferenceCapable: true
credentials: # ゲートウェイネイティブのsnake_caseスキーマ
- name: api_key
env_vars: ["ACME_API_KEY"]
required: true
endpoints:
- host: api.acme.example
port: 443
OpenShellPolicyと同様に、安定したスパイン(displayName, description, category, inferenceCapable)のみが型付けされています。大きく、急速に変化する配列(credentials, endpoints, binaries, discovery)は、ゲートウェイ自身のsnake_caseスキーマで不透明にパススルーされ、ゲートウェイのopenshell-providersパーサーが調整時に検証します。オペレーターがここでミラーリングするのではなく。レコンサイラーは、Ready条件(メッセージにパーサーの診断が含まれる)に結果を報告するため、無効なプロファイルはプロバイダーが使用する前に表面化します。ゲートウェイにプロファイルをインポートし、変更時にインプレースで更新します(ゲートウェイの保存済みリソースバージョンの楽観的同時実行制御、.status.resourceVersionにミラーリング)。
削除はファイナライザーによって保護されています。オペレーターは、OpenShellProviderがまだそのtypeを選択している間はプロファイルの削除を拒否します(それらがなくなるまでReady条件にProfileInUseを表示します)。それを削除すると、認証情報処理が壊れるためです。これは、プロファイルがゲートウェイ上でインポートされ、変更時にインプレースで更新されることを意味します(ゲートウェイの保存済みリソースバージョンの楽観的同時実行制御、.status.resourceVersionにミラーリング)。
永続ボリューム
spec.volumesは、サンドボックスに永続ストレージを提供します。各エントリについて、オペレーターは埋め込まれたclaimからPersistentVolumeClaim(名前は<sandbox>-<volume>)をプロビジョニングします。これは標準のKubernetes PersistentVolumeClaimSpecであるため、storageClassName, accessModes, resources, およびdataSource(VolumeSnapshotから復元または既存のPVCをクローン)がすべて利用可能です。そしてそれをmountPathにサンドボックスにマウントします。
OpenShellSandboxはPVCを所有します。下のゲートウェイサンドボックスではなく、それがポイントです。ゲートウェイはサンドボックスのイメージ、ポリシー、その他のフィールドを不変として扱います。したがって、それらを変更することは、サンドボックスの削除と再作成を意味します。そしてPVCはリソースにアンカーされているため、使い捨てのサンドボックスではなく、そのデータはその再作成を生き延びます。/sandboxの下にボリュームをマウントすると、OpenShellのワークスペース永続性がそれに渡されます。他の場所(例: /data、上記のように)にマウントすると、イメージシードされたワークスペースと並んで永続ストレージを保持できます。
ゲートウェイは、リソースアドミッションラベルopenshell.ai/sandbox-attachable: "true"およびopenshell.ai/sandbox-attachable-workspace: <workspace>を持つPVCのみをアタッチします。オペレーターは、プロビジョニングするPVCに両方を設定し、それらを持たない古いPVCに追加します。ボリュームは、server.drivers.kubernetes.allowDriverConfigがtrueでない限り、ゲートウェイが拒否する呼び出し元ドライバー設定としてゲートウェイに到達します。バンドルされたゲートウェイはそれを設定します。独自のゲートウェイにも設定してください。
volumeRetentionは、OpenShellSandbox自体が削除されたときにPVCに何が起こるかを制御します: Retain(デフォルト)はデータをリソースよりも長く保持するために保持し、Deleteはそれらを削除します。volumeMode: Blockは拒否されます — サンドボックスはファイルシステムをマウントします。
更新と再作成
ゲートウェイは、実行中のサンドボックスの多くのフィールドを不変として扱います。不変なフィールド(image, environment, gpu/gpuCount, logLevel, runtimeClassName, resources, labels, annotations、ボリュームマウント、または解決されたポリシーのlandlock/process(spec.policyまたは参照されるOpenShellPolicyから))を編集すると、オペレーターはゲートウェイサンドボックスを削除して再作成することで収束します。適用されたフィールドを.status.appliedSpecHashのハッシュとして追跡するため、実際の変更があった場合にのみ再作成します(そして、再作成せずに既存のサンドボックスを採用します)。再作成中、Normal Recreatingイベントを発行します。
オペレーター所有のボリュームはOpenShellSandboxにアンカーされているため、再作成を生き延び、名前で再アタッチします — これがボリューム機能の理由全体です。
⚠️ 再作成はオペレーター所有ボリュームのデータのみを保持します。 ゲートウェイサンドボックスを削除すると、ゲートウェイが所有するものはすべてカスケード削除されます — サンドボックスに
/sandbox上のカスタムボリュームがない場合に、そのインジェクトされたワークスペースPVCを含みます。カスタムボリューム(claimNameで参照され、所有者参照がないもの)のみが生き残ります。イメージまたはポリシーの変更をまたいでワークスペース状態を保持するには、/sandboxにボリュームをマウントしてください。それ以外の場合、ワークスペースは再作成時にイメージから再構築されます。
オペレーターは、再作成なしでインプレースで変更可能なフィールドを収束します:
providers— 実行中のサンドボックスでspec.providersを編集すると、新しくリストされたプロバイダーがアタッチされ、削除されたものがデタッチされ、ゲートウェイが実際に報告するものに対して調整されます(手動デタッチも修復されます)。- ポリシーの
networkPoliciesとfilesystem— 変更は、別のハッシュ.status.appliedPolicyHashで追跡されるUpdateConfigを介してライブサンドボックスにプッシュされ、NormalPolicyUpdatedイベントで通知されます。filesystemは加算的に変更可能です。読み取り専用または読み書きパスの追加は機能しますが、ゲートウェイはパスの削除(またはincludeWorkdirの切り替え)を拒否します。その失敗は、PolicyUpdateRejectedとしてReady条件に表面化します。ファイルシステムパスを削除するには、サンドボックスを再作成してください。
ステータスとイベント
すべてのリソースは標準的な方法で調整の健全性を報告するため、既存のツールはそのまま機能します:
.status.conditions[]は、信頼できる情報源です。各リソースは標準のReady条件(metav1.Condition、reason,message,observedGeneration付き)を持ちます。そのため、kubectl wait --for=condition=Ready、Argo CD / Fluxのヘルス評価、およびkstatusが理解できます。失敗時にはReadyはFalseになり、機械可読なreason(例:VolumeProvisionFailed,SecretNotFound,PolicyConflict)と人間が読めるmessageが表示されます。- Kubernetesイベントは、一時的なパンくずリストです。調整の失敗はリソースに対して
Warningイベントを発行し、kubectl describeで表示されます。イベントは期限切れになります。条件はそうではありません — したがって、自動化がキーをオンにすべきは条件であり、イベントではありません。
OpenShellSandboxは、さらにゲートウェイ自体のライフサイクルを.status.phaseにミラーリングします(Readyとは別の軸、Pod.status.phaseに似ています)。
限定されたkubectl exec
サンドボックスのエージェントコンテナは特権で実行されるため、通常のkubectl execは、スーパーバイザーがワークロードに適用するプロセスごとの制限の外側でrootとして着地し、サンドボックスをバイパスします。オペレーターが提供するオプションのAdmission Webhookがそれを閉じます。pods/execに対する変更Webフックは、スーパーバイザーを介してサンドボックスに再入力するようにコマンドを書き換えます(Landlockの下でサンドボックスユーザーにドロップし、ライブゲートウェイから再導出されたポリシー)、検証Webフックは、それを回避する可能性のあるkubectl attach / kubectl debugを拒否します。これはデフォルトのトポロジーで機能します — 特権コンテナの変更は不要です。
webhook.execConfinement.enabledはデフォルトでgateway.bundledです — バンドルされたインストールではオン(オペレーターはサンドボックスがリリース名前空間に着地することを知っており、Webフックをそこにスコープします — ラベル付けするものは何もありません)、独自のゲートウェイを使用する場合はオプトイン(それを有効にし、サンドボックス名前空間にopenshell.lenshq.io/exec-confinement=enabledというラベルを付けます)。これはfailurePolicy: Fail(フェイルクローズ: オペレーターの障害は、rootシェルを再オープンするのではなく、限定された名前空間への実行を拒否します)であり、サービング証明書を自己管理します — cert-manager不要。設計についてはdocs/exec-confinement.mdを参照してください。
アーキテクチャ
オペレーターは、ゲートウェイのgRPCコントロールプレーンの薄い、宣言的なフロントエンドです。カスタムリソースをゲートウェイ呼び出しに変換し、ゲートウェイの状態を.statusにミラーリングします。完全な設計 — モジュールレイアウト、調整モデル、ドリフト検出、およびランタイムの懸念事項については、docs/architecture.mdを参照してください。
ゲートウェイには、チャートにバンドルされた小さな静的OIDC発行者が発行するベアラー トークンを持つOIDC User(管理者)として認証されます — 外部IDプロバイダーはありません。ゲートウェイは通常の姿勢を維持します: それはメソッドごとの認可を自身で強制します(フェイルクローズ)。したがって、ゲートウェイ発行のJWTを提示するサンドボックスは、追加のプロキシなしでデータプレーンに限定されたままです。完全な設計についてはdocs/operator-auth.mdを参照してください。
開発
cargo build
cargo test
cargo run --bin openshell-operator # 現在のkubecontextに対して。ゲートウェイが$OPENSHELL_GATEWAY_ENDPOINTにあると想定
完全な検証ゲート、ピン留めされたツールチェーン、gitフック、CRD再生成、およびコミット規則については、CONTRIBUTING.mdを参照してください。
openshell-sdk, openshell-core, openshell-policy, およびopenshell-providersは、NVIDIA/OpenShellリリースタグにピン留めされたgit依存関係として消費されます — チャートがバンドルされたゲートウェイサブチャートとしてピン留めするのと同じリリースであり、クライアントクレートとその通信先ゲートウェイは常に1つのアップストリームリリースから提供されます。両方のピンを一緒に引き上げてください。
リリース
release-pleaseは、Conventional Commit履歴からのリリースを自動化します。チャートのversion + appVersionを更新し、CHANGELOG.mdを更新するリリースPRを開いたままにします。それをマージするとvX.Y.Zがタグ付けされ、すべてGHCRに発行されます:
ghcr.io/lensapp/openshell-operator:X.Y.Zおよびopenshell-issuer:X.Y.Z(マルチアーチlinux/amd64+linux/arm64)、さらに:latest。- Helmチャートは
oci://ghcr.io/lensapp/charts/openshell-operator(バージョンX.Y.Z)で提供されます。
Cargo.tomlのクレートバージョンは内部的なものであり、リリースによって意図的に変更されません。feat:はマイナーを、fix:はパッチをインクリメントします(破壊的変更は、意図的な1.0.0まで0.x内に留まります)。
ライセンス
Apache-2.0 — LICENSEを参照してください。