|
| 1 | +# Copyright 2026 Google LLC |
| 2 | +# |
| 3 | +# Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 | +# you may not use this file except in compliance with the License. |
| 5 | +# You may obtain a copy of the License at |
| 6 | +# |
| 7 | +# http://www.apache.org/licenses/LICENSE-2.0 |
| 8 | +# |
| 9 | +# Unless required by applicable law or agreed to in writing, software |
| 10 | +# distributed under the License is distributed on an "AS IS" BASIS, |
| 11 | +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 | +# See the License for the specific language governing permissions and |
| 13 | +# limitations under the License. |
| 14 | + |
| 15 | +apiVersion: apiextensions.k8s.io/v1 |
| 16 | +kind: CustomResourceDefinition |
| 17 | +metadata: |
| 18 | + annotations: |
| 19 | + controller-gen.kubebuilder.io/version: v0.20.1 |
| 20 | + name: sandboxconfigs.ate.dev |
| 21 | +spec: |
| 22 | + group: ate.dev |
| 23 | + names: |
| 24 | + kind: SandboxConfig |
| 25 | + listKind: SandboxConfigList |
| 26 | + plural: sandboxconfigs |
| 27 | + shortNames: |
| 28 | + - sandboxconfig |
| 29 | + singular: sandboxconfig |
| 30 | + scope: Cluster |
| 31 | + versions: |
| 32 | + - additionalPrinterColumns: |
| 33 | + - jsonPath: .spec.sandboxClass |
| 34 | + name: Class |
| 35 | + type: string |
| 36 | + - jsonPath: .spec.default |
| 37 | + name: Default |
| 38 | + type: boolean |
| 39 | + - jsonPath: .metadata.creationTimestamp |
| 40 | + name: Age |
| 41 | + type: date |
| 42 | + name: v1alpha1 |
| 43 | + schema: |
| 44 | + openAPIV3Schema: |
| 45 | + description: |- |
| 46 | + SandboxConfig is cluster-scoped configuration describing the sandbox binaries |
| 47 | + for a sandbox runtime family. It is referenced (or defaulted) by WorkerPools |
| 48 | + and decouples sandbox binary selection from ActorTemplate. |
| 49 | + properties: |
| 50 | + apiVersion: |
| 51 | + description: |- |
| 52 | + APIVersion defines the versioned schema of this representation of an object. |
| 53 | + Servers should convert recognized schemas to the latest internal value, and |
| 54 | + may reject unrecognized values. |
| 55 | + More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| 56 | + type: string |
| 57 | + kind: |
| 58 | + description: |- |
| 59 | + Kind is a string value representing the REST resource this object represents. |
| 60 | + Servers may infer this from the endpoint the client submits requests to. |
| 61 | + Cannot be updated. |
| 62 | + In CamelCase. |
| 63 | + More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 64 | + type: string |
| 65 | + metadata: |
| 66 | + type: object |
| 67 | + spec: |
| 68 | + description: spec defines the desired state of SandboxConfig |
| 69 | + properties: |
| 70 | + assets: |
| 71 | + additionalProperties: |
| 72 | + additionalProperties: |
| 73 | + description: |- |
| 74 | + AssetFile is one content-addressed file that atelet fetches for a sandbox |
| 75 | + runtime (e.g. the gVisor runsc binary, or a micro-VM kernel/firmware/config). |
| 76 | + properties: |
| 77 | + sha256: |
| 78 | + description: |- |
| 79 | + SHA256 is the lower-case hex SHA256 of the asset. It both names the cached |
| 80 | + file (preventing collisions) and verifies the download's integrity. |
| 81 | + pattern: ^[a-f0-9]{64}$ |
| 82 | + type: string |
| 83 | + url: |
| 84 | + description: |- |
| 85 | + URL is where to download the asset from (e.g. a gs:// URL). It may be |
| 86 | + fetched anonymously or with credentials depending on atelet's |
| 87 | + configuration. |
| 88 | + minLength: 1 |
| 89 | + type: string |
| 90 | + required: |
| 91 | + - sha256 |
| 92 | + - url |
| 93 | + type: object |
| 94 | + type: object |
| 95 | + description: |- |
| 96 | + Assets is the set of files atelet fetches for this runtime, keyed first by |
| 97 | + architecture (GOARCH, e.g. "amd64", "arm64") and then by asset name. The |
| 98 | + asset names are interpreted by the sandbox backend: gVisor expects a |
| 99 | + "runsc" asset; a micro-VM backend expects several (e.g. "cloud-hypervisor", |
| 100 | + "kata-kernel", "kata-image"). The schema is intentionally generic; |
| 101 | + per-class requirements are enforced by a ValidatingAdmissionPolicy. |
| 102 | + type: object |
| 103 | + default: |
| 104 | + description: |- |
| 105 | + Default marks this SandboxConfig as the cluster-wide default for its |
| 106 | + SandboxClass. A WorkerPool with no explicit SandboxConfigName resolves to |
| 107 | + the default config for its SandboxClass. At most one default is expected |
| 108 | + per SandboxClass. |
| 109 | + type: boolean |
| 110 | + sandboxClass: |
| 111 | + default: gvisor |
| 112 | + description: |- |
| 113 | + SandboxClass is the sandbox runtime family this config applies to. A |
| 114 | + WorkerPool only uses SandboxConfigs whose SandboxClass matches its own. |
| 115 | + enum: |
| 116 | + - gvisor |
| 117 | + - microvm |
| 118 | + type: string |
| 119 | + required: |
| 120 | + - sandboxClass |
| 121 | + type: object |
| 122 | + required: |
| 123 | + - spec |
| 124 | + type: object |
| 125 | + served: true |
| 126 | + storage: true |
| 127 | + subresources: {} |
0 commit comments