Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Skema Aggrega Workload

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

Id skema: https://aggrega.ai/schemas/workload-v1beta1.schema.json

Spesifikasi workload abstrak milik platform. Sebuah Recipe yang menggunakan mode synthesized mendeklarasikan tepat satu Workload melalui kata kunci workload: (block scalar inline atau workload: { $import: } sesuai kosakata impor file terpadu). Provider target menerjemahkan Workload menjadi manifest native provider (Deployment/StatefulSet/Services/PVC K8s untuk helm; services + volumes + networks compose untuk compose; dan seterusnya). Sebuah Workload tidak membawa metadata sendiri — tanpa nama, tanpa label, tanpa anotasi. Identitas dan pelabelan berasal dari instans component yang mendeklarasikannya: provider target menurunkan nama setiap resource yang dirender dari instans tersebut dan membubuhkan kunci provenance aggrega.ai/* untuk node tersebut pada resource itu. Kind Workload BUKAN entitas katalog — file yang dipublikasikan ini adalah JSON Schema Workload kanonis, dan compiler memvalidasi Workload terhadapnya.

Lihat referensi penulisan Workload untuk panduan prosa tentang penulisan entitas Workload; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.

Jenis tingkat teratas: object

Properti

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “Workload”yaKonstanta: "Workload"
formstring (enum)tidakMaksud bentuk pengendali abstrak untuk workload. Memilih jenis siklus hidup runtime yang dimiliki workload, terlepas dari platform target mana pun: stateless (replika berjalan lama yang dapat saling dipertukarkan), stateful (replika dengan identitas stabil per replika dan penyimpanan per replika), daemon (satu instans per host yang memenuhi syarat), scheduled (eksekusi berulang yang dipicu waktu), task (satu eksekusi hingga selesai), reference (endpoint eksternal tanpa komputasi — tanpa pengendali; helm menghasilkan Service ExternalName, compose meneruskan endpoint melalui kontrak injeksi). Nilai kosong diperlakukan sebagai stateless. Setiap provider target memetakan bentuk ini ke bentuk native-nya sendiri; bentuk ini sendiri tidak membawa jenis sumber daya native platform. Volume persistentTemplate merupakan pendamping stateful dan hanya valid pada workload stateful. Workload reference mendeklarasikan endpoint (dan secara opsional port) tanpa kontainer, dan tidak membawa field kredensial sendiri, karena nama variabel lingkungan milik konsumen, bukan milik endpoint. Konsumen yang memerlukan kredensial untuk endpoint mendeklarasikan slot pada featuresSchema milik Component-nya sendiri dan mengisinya dari blok attachments kontainernya, jika daftar inject slot tersebut mengizinkan pengiriman itu. Nilai yang diizinkan: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Default: "stateless"
endpointstringtidakEndpoint eksternal untuk form: reference — sebuah host atau URL. Compiler meneruskannya sebagai string penunjuk yang deterministik; nilai ini tidak pernah di-resolve pada waktu kompilasi (AOT). Wajib jika form adalah reference dan hanya bermakna dalam kasus itu. helm menghasilkannya sebagai externalName pada Service ExternalName (bagian host); compose meneruskannya ke konsumen melalui provides milik recipe.
portintegertidakPort opsional untuk endpoint reference (form: reference). helm menghasilkannya sebagai port pada Service ExternalName. Minimum: 1. Maksimum: 65535.
schedulestringtidakJadwal cron untuk form: scheduled — ekspresi crontab standar 5 field (misalnya ‘0 0 * * *’) atau salah satu makro @hourly, @daily, @weekly, @monthly, @yearly. Wajib jika form adalah scheduled dan hanya bermakna dalam kasus itu; provider target meneruskannya apa adanya ke field schedule pada sumber daya terjadwal.
suspendbooleantidakMenahan jadwal berulang dari workload form: scheduled. Jika true, resource terjadwal dirender dengan jadwalnya tetap di tempat, tetapi tidak ada eksekusi yang dimulai dari jadwal tersebut hingga dilanjutkan kembali; eksekusi masih dapat dibuat dari resource secara manual — di Kubernetes, kubectl create job —from=cronjob/. suspend: false dirender persis sama seperti suspend yang tidak ada. Hanya bermakna dengan form: scheduled. helm menghasilkannya sebagai spec.suspend milik CronJob. compose tidak memiliki bentuk terjadwal dan berhenti pada workload form: scheduled, baik ditangguhkan maupun tidak. Default: false
replicasintegertidakJumlah replika. Default 1. Pada target compose, nilai ini tidak mencapai bagian mana pun dari output, dan sebuah peringatan melaporkannya setiap kali nilai ini ditulis — termasuk 1 yang eksplisit. Minimum: 0. Default: 1
initContainerscontainer[]tidakDaftar berurutan kontainer yang berjalan hingga selesai sebelum kontainer utama dimulai.
containersmap dari containertidakMap berurutan dari nama kontainer → spesifikasi kontainer. Minimal satu entri wajib ada. Urutan penulisan dipertahankan. Minimal 1 entri.
volumesmap dari volumetidakMap berurutan dari nama volume → spesifikasi volume. Setiap spesifikasi volume mendeklarasikan tepat satu dari: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmap dari servicetidakMap berurutan dari nama service → spesifikasi service. Pada helm, setiap entri menjadi Service K8s tersendiri, dan entri yang type-nya Loopback menghentikan build. Pada compose tidak ada primitif service tersendiri, sehingga entri tidak dipetakan satu banding satu: entri yang type-nya NodePort atau LoadBalancer memublikasikan port-portnya pada setiap antarmuka host dari service compose milik workload itu sendiri, entri yang type-nya Loopback memublikasikan port-portnya di sana hanya pada alamat loopback host, entri yang type-nya ClusterIP atau Headless tidak memublikasikan apa pun, dan setiap port yang dipublikasikan dikumpulkan ke dalam daftar port service tunggal tersebut dengan port host yang sama dengan port kontainer. Pada helm, setiap Service dinamai <name>-<key>: nama yang dibawa Deployment (atau controller lain) milik workload itu sendiri, lalu tanda hubung dan kunci entri, sehingga Workload yang mendeklarasikan services.http dengan Deployment bernama api-server merender Service bernama api-server-http. Pada compose, kunci tidak menamai apa pun dalam output.
schedulingobjecttidakBatasan penjadwalan native K8s. Diterjemahkan langsung untuk helm. Pada target compose, batasan ini tidak mencapai bagian mana pun dari output, dan sebuah peringatan melaporkan blok tersebut jika ditulis.
podSecurityContextobjecttidak
serviceAccountstringtidakNama ServiceAccount tempat workload ini berjalan. RBAC yang sebenarnya (sumber daya ServiceAccount/Role/RoleBinding) sebaiknya dihasilkan melalui Features atau artefak, bukan melalui field ini.
imagePullSecretsstring[]tidakNama Secret image-pull untuk menarik image dari registry privat. helm menghasilkan pod.imagePullSecrets. compose tidak memiliki padanan di dalam file — autentikasi registry dikonfigurasi di luar file melalui docker login — dan menghilangkannya.
priorityClassNamestringtidakNama PriorityClass yang mengatur prioritas penjadwalan workload ini. helm menghasilkan pod.priorityClassName. compose tidak memiliki padanan prioritas penjadwalan host tunggal dan menghilangkannya.
runtimeClassNamestringtidakNama RuntimeClass yang memilih runtime kontainer tempat workload ini berjalan (misalnya runtime berkemampuan GPU seperti ‘nvidia’). Compiler meneruskan nama ini apa adanya; klaster me-resolve-nya ke RuntimeClass yang telah dikonfigurasi pada waktu penjadwalan. helm menghasilkan pod.runtimeClassName. compose tidak memiliki padanan runtime-class dan menghilangkannya. Khusus komputasi: tidak diizinkan pada workload reference.
terminationGracePeriodSecondsintegertidakJumlah detik antara SIGTERM dan SIGKILL saat shutdown. helm menghasilkan pod.terminationGracePeriodSeconds; compose menghasilkan stop_grace_period. Minimum: 0.
dnsPolicystring (enum)tidakKebijakan DNS pod. helm menghasilkan pod.dnsPolicy. compose tidak memiliki padanan kebijakan DNS dan menghilangkannya (sebagai gantinya compose memetakan nameservers/searches dari dnsConfig secara langsung). Nilai yang diizinkan: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjecttidakKonfigurasi DNS pod kustom. helm menghasilkan pod.dnsConfig. compose memetakan nameservers ke dns dan searches ke dns_search; options tidak memiliki padanan di compose dan dihilangkan di sana.
hostAliasesobject[]tidakPemetaan statis hostname ke IP yang diinjeksikan ke file hosts pod. helm menghasilkan pod.hostAliases; compose menghasilkan extra_hosts (satu entri hostname:ip per hostname).
hostNetworkbooleantidakMenjalankan workload di namespace jaringan milik node host itu sendiri, bukan di namespace yang terisolasi. Port yang dibuka workload kemudian dapat dijangkau pada alamat node itu sendiri, dan workload melihat antarmuka jaringan node. Ini hanya memilih namespace jaringan dan tidak lebih: ini tidak mendeklarasikan port, dan setiap port yang dibuka workload tetap dideklarasikan di bawah containers..ports. helm menghasilkan pod.hostNetwork. compose menghasilkan network_mode: host pada service milik workload itu sendiri; service compose dalam mode tersebut tidak terhubung ke jaringan batas, sehingga peer-nya menjangkaunya pada alamat node, bukan melalui nama service, dan service setiap init container bergabung ke jaringan batas secara tersendiri. Khusus komputasi: tidak diizinkan pada workload reference.

Properti tambahan tidak diizinkan.

workload.scheduling

Batasan penjadwalan native K8s. Diterjemahkan langsung untuk helm. Pada target compose, batasan ini tidak mencapai bagian mana pun dari output, dan sebuah peringatan melaporkan blok tersebut jika ditulis.

PropertiJenisWajibDeskripsi
nodeSelectormap of stringtidak
affinityobjecttidak
tolerationsobject[]tidak
topologySpreadConstraintsobject[]tidak

Properti tambahan tidak diizinkan.

workload.podSecurityContext

PropertiJenisWajibDeskripsi
runAsUserintegertidak
runAsGroupintegertidak
fsGroupintegertidak
supplementalGroupsinteger[]tidak

Properti tambahan tidak diizinkan.

workload.dnsConfig

Konfigurasi DNS pod kustom. helm menghasilkan pod.dnsConfig. compose memetakan nameservers ke dns dan searches ke dns_search; options tidak memiliki padanan di compose dan dihilangkan di sana.

PropertiJenisWajibDeskripsi
nameserversstring[]tidak
searchesstring[]tidak
optionsobject[]tidak

Properti tambahan tidak diizinkan.

workload.hostAliases[]

PropertiJenisWajibDeskripsi
ipstringya
hostnamesstring[]ya

Properti tambahan tidak diizinkan.

Definisi

container

PropertiJenisWajibDeskripsi
namestringtidakNama container opsional. Untuk entri initContainers posisional, nilai ini menetapkan nama container yang dihasilkan, dengan nama init- yang dibangkitkan (posisi entri dalam daftar) sebagai cadangan bila dihilangkan. Untuk entri map containers, kunci map adalah nama container dan field ini diabaikan.
imagestringyaReferensi image container (mis., ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)tidakKebijakan pull image. helm menghasilkannya sebagai container.imagePullPolicy. compose memetakannya ke pull_policy service (Always ke always, Never ke never, IfNotPresent ke if_not_present). Nilai yang diizinkan: "Always", "Never", "IfNotPresent"
commandstring[]tidakMenimpa entrypoint image. K8s: .command. Compose: entrypoint.
argsstring[]tidakArgumen yang diteruskan ke command (atau ke entrypoint image jika command tidak ada). K8s: .args. Compose: command.
variablesmap of stringtidakVariabel lingkungan sebagai pasangan kunci-nilai string. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmap containerAttachmenttidakMap berurutan dari nama env atau file → { from, as, key?, path?, connection? }. Setiap entri mereferensikan slot yang dideklarasikan dalam featuresSchema milik Component — atau, bila entri menyebut connection, slot yang dideklarasikan oleh socket connection tersebut — dan mengirimkan apa yang dipublikasikan oleh attachment yang mengisi slot itu. Field ‘as’ memilih mekanisme pengiriman, yang harus tercantum dalam allowlist array inject: milik slot. Slot blackbox (inject: []) TIDAK BOLEH muncul di sini.
envFromobject[]tidakLingkungan massal yang diimpor dari sumber ConfigMap atau Secret. helm menghasilkan container.envFrom (configMapRef/secretRef). compose tidak memiliki primitif env-from-object — referensi sumber bukan file host, sehingga menafsirkannya ulang sebagai env_file akan mengubah makna secara diam-diam; workload yang mendeklarasikan envFrom dihentikan secara eksplisit pada target compose.
portsmap integer atau objecttidakPort container bernama. Port ditulis sebagai nomor port saja (web: 8080) atau sebagai object yang memuat nomor tersebut beserta protokol transport yang dibawa port itu (dns: { port: 53, protocol: UDP }); bila tidak ada protokol yang dideklarasikan, kedua bentuk bermakna sama. Nilai protokol yang diizinkan adalah TCP, UDP dan SCTP, dan menghilangkan kunci tersebut membiarkan default target sendiri tetap berlaku. Nama port direferensikan oleh services.*.ports dan oleh resolusi port pada probe http, dan port service mengambil transport dari port container yang dirujuk namanya, sehingga transport dideklarasikan sekali saja. K8s: containerPort, dengan protocol hanya bila dideklarasikan. Compose: port container hanya masuk ke output bila spesifikasi service mempublikasikannya; port container itu sendiri tidak memiliki field compose tersendiri, dan port yang dipublikasikan membawa transport yang dideklarasikan sebagai sufiks /protocol pada entri yang dipublikasikan — transport yang tidak dapat dituliskan oleh compose menghentikan build alih-alih mempublikasikan port yang akan membawa transport lain.
resourcesobjecttidak
healthobjecttidakProbe kesehatan container — ready, live dan startup — masing-masing dideklarasikan sebagai http, tcp atau exec. Diterjemahkan menjadi httpGet/tcpSocket/exec K8s untuk helm. Untuk compose, sebuah service membawa satu healthcheck: http dan tcp menjadi tes CMD-SHELL, exec menjadi tes CMD, dan bila lebih dari satu probe dideklarasikan hanya satu yang dipertahankan — sebuah peringatan menyebutkan probe yang diterjemahkan dan probe yang dibuang.
volumeMountsobject[]tidak
restartPolicystring (enum)tidakNilai yang diizinkan: "Always", "OnFailure", "Never"
lifecycleobjecttidakHook siklus hidup container. Diterjemahkan menjadi container.lifecycle K8s (postStart/preStop) untuk helm. compose tidak memiliki primitif lifecycle-hook; workload yang mendeklarasikan lifecycle dihentikan secara eksplisit pada target compose alih-alih membuang hook secara diam-diam.
securityContextobjecttidak

Properti tambahan tidak diizinkan.

container.envFrom[]

PropertiJenisWajibDeskripsi
configMapstringtidakNama sumber ConfigMap yang dihasilkan oleh input artifacts Recipe ini atau oleh Feature yang terpasang.
secretstringtidakNama slot featuresSchema — milik Component sendiri, atau, bila connection ditetapkan, slot yang dideklarasikan oleh socket connection tersebut; nama Secret yang diimpor di-resolve dari provides milik slot.
connectionstringtidakAlias dari connection yang digunakan komponen — nama yang dipakai untuk menuliskannya dalam blok uses komponen, pada Aggregate atau Release. Bila ditetapkan, secret menyebut slot yang dideklarasikan oleh socket yang dilalui connection tersebut, dan Secret yang diimpor adalah Secret yang dipublikasikan oleh attachment yang dibawa connection itu pada slot tersebut, sehingga komponen yang menjangkau beberapa target mengimpor Secret milik masing-masing target. Hanya bermakna bersama secret. Connection yang tidak digunakan komponen, atau slot yang tidak dideklarasikan socket-nya, ditolak dengan menyebut keduanya.
prefixstringtidakPrefiks opsional yang ditambahkan di depan setiap nama variabel lingkungan yang diimpor.

Properti tambahan tidak diizinkan.

container.resources

PropertiJenisWajibDeskripsi
requestsresourceListtidak
limitsresourceListtidak

Properti tambahan tidak diizinkan.

container.health

Probe kesehatan container — ready, live dan startup — masing-masing dideklarasikan sebagai http, tcp atau exec. Diterjemahkan menjadi httpGet/tcpSocket/exec K8s untuk helm. Untuk compose, sebuah service membawa satu healthcheck: http dan tcp menjadi tes CMD-SHELL, exec menjadi tes CMD, dan bila lebih dari satu probe dideklarasikan hanya satu yang dipertahankan — sebuah peringatan menyebutkan probe yang diterjemahkan dan probe yang dibuang.

PropertiJenisWajibDeskripsi
readyprobetidak
liveprobetidak
startupprobetidak

Properti tambahan tidak diizinkan.

container.volumeMounts[]

PropertiJenisWajibDeskripsi
namestringyaHarus cocok dengan sebuah kunci dalam map volumes: tingkat atas.
pathstringyaTitik mount di dalam container.
subPathstringtidakMe-mount satu file atau subdirektori dari volume pada path, tanpa menutupi file lain di direktori target.
readonlybooleantidakDefault: false

Properti tambahan tidak diizinkan.

container.lifecycle

Hook siklus hidup container. Diterjemahkan menjadi container.lifecycle K8s (postStart/preStop) untuk helm. compose tidak memiliki primitif lifecycle-hook; workload yang mendeklarasikan lifecycle dihentikan secara eksplisit pada target compose alih-alih membuang hook secara diam-diam.

PropertiJenisWajibDeskripsi
postStartlifecycleHooktidak
preStoplifecycleHooktidak

Properti tambahan tidak diizinkan.

container.securityContext

PropertiJenisWajibDeskripsi
runAsUserintegertidak
runAsGroupintegertidak
runAsNonRootbooleantidak
readOnlyRootFilesystembooleantidak
allowPrivilegeEscalationbooleantidak
capabilitiesobjecttidak

Properti tambahan tidak diizinkan.

container.securityContext.capabilities
PropertiJenisWajibDeskripsi
addstring[]tidak
dropstring[]tidak

Properti tambahan tidak diizinkan.

containerAttachment

PropertiJenisWajibDeskripsi
fromstringyaNama slot yang dideklarasikan dalam featuresSchema milik Component — atau, bila connection ditetapkan, slot yang dideklarasikan oleh socket yang dilalui connection tersebut.
connectionstringtidakAlias dari connection yang digunakan komponen — nama yang dipakai untuk menuliskannya dalam blok uses komponen, pada Aggregate atau Release. Bila ditetapkan, from menyebut slot yang dideklarasikan oleh socket yang dilalui connection tersebut (usesSchema..featuresSchema), dan entri mengirimkan apa yang dipublikasikan oleh attachment yang dibawa connection itu pada slot tersebut, sehingga komponen yang menjangkau beberapa target menyajikan kredensial milik masing-masing. Allowlist inject: milik slot mengatur as, persis seperti untuk slot yang dideklarasikan Component. Connection yang tidak digunakan komponen, atau slot yang tidak dideklarasikan socket-nya, ditolak dengan menyebut keduanya.
asstring (enum)yaMekanisme pengiriman. Harus tercantum dalam allowlist array inject: milik slot. Nilai yang diizinkan: "env", "file"
keystringtidakUntuk as: env, kunci data spesifik dari secret slot yang direferensikan yang dibaca entri ini. Tetapkan bila secret slot memuat beberapa kunci data, sehingga entri ini memilih salah satunya berdasarkan nama; dua entri dapat mereferensikan slot yang sama dengan kunci berbeda untuk membaca beberapa kunci dari satu secret. Bila dihilangkan, entri membaca satu-satunya kunci yang dipublikasikan slot. Diabaikan untuk as: file, yang me-mount seluruh secret.
pathstringtidakPath file di dalam container (wajib bila as: file).

Properti tambahan tidak diizinkan.

resourceList

PropertiJenisWajibDeskripsi
cpustringtidakKuantitas CPU (mis., ‘100m’, ‘0.5’, ‘2’). helm mengeluarkannya apa adanya di bawah resources.{requests,limits}.cpu. compose memetakannya ke deploy.resources.{reservations,limits}.cpus sebagai jumlah core pecahan — kuantitas millicpu dikonversi (500m menjadi 0.5); kuantitas core biasa diteruskan apa adanya. Kuantitas yang tidak dapat dikonversi oleh compose menghentikan proses secara eksplisit alih-alih mengeluarkan nilai yang salah.
memorystringtidakKuantitas memori (mis., ‘128Mi’, ‘1Gi’). helm mengeluarkannya apa adanya di bawah resources.{requests,limits}.memory. compose memetakannya ke deploy.resources.{reservations,limits}.memory sebagai jumlah byte yang tepat. Kuantitas yang menghasilkan jumlah byte bulat dikonversi secara tepat (1.5Gi menjadi 1610612736); kuantitas yang tidak demikian, atau yang bukan kuantitas, menghentikan proses secara eksplisit alih-alih dibulatkan.

Kunci tambahan: Kuantitas sumber daya yang diperluas (dengan cakupan vendor/domain), dengan kunci berupa nama yang sepenuhnya memenuhi syarat ’/’ (misalnya ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). Segmen domain memuat setidaknya satu titik, yang membedakan kunci yang diperluas dari kuantitas cpu/memory biasa. Compiler meneruskan kuantitas tersebut apa adanya; device plugin milik cluster menyelesaikan dan mengalokasikannya pada saat penjadwalan. helm mengeluarkannya di bawah resources.{requests,limits}.. compose mencadangkan jumlah ‘nvidia.com/gpu’ sebagai reservasi perangkat NVIDIA pada service milik container — jumlah dari limit jika limit ditulis, jika tidak jumlah dari request, dan tanpa reservasi untuk jumlah 0 — serta berhenti pada jumlah yang bukan bilangan bulat perangkat, atau pada request dan limit yang meminta jumlah berbeda. compose tidak memiliki padanan untuk kunci diperluas lainnya dan menghilangkannya, dengan memberi peringatan sekali untuk setiap kunci diperluas yang berbeda dan menyebutkan kunci tersebut, sehingga penghilangan itu dilaporkan, tidak diam-diam. Pola: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)+/[A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?$.

Properti lain apa pun tidak diizinkan.

probe

PropertiJenisWajibDeskripsi
httpstringtidakProbe HTTP GET: path diperiksa terhadap port container yang namanya berada paling awal menurut urutan abjad.
tcpintegertidakProbe soket TCP pada nomor port container yang diberikan. Minimum: 1. Maksimum: 65535.
execstring[]tidakProbe exec — perintah yang dijalankan di dalam container. Minimal 1 entri.
timeoutSecondsintegertidakMinimum: 1.
initialDelaySecondsintegertidakMinimum: 0.
periodSecondsintegertidakMinimum: 1.
failureThresholdintegertidakMinimum: 1.
successThresholdintegertidakMinimum: 1.

Properti tambahan tidak diizinkan.

lifecycleHook

PropertiJenisWajibDeskripsi
execstring[]tidakMinimal 1 entri.
httpGetobjecttidakBentuk httpGet bawaan K8s (path, port, scheme, host, httpHeaders). Diteruskan ke helm. Pada target compose, workload yang mendeklarasikan lifecycle hook akan berhenti, karena compose tidak memiliki primitif lifecycle-hook — hook tersebut tidak pernah dihilangkan diam-diam.

Properti tambahan tidak diizinkan.

volume

PropertiJenisWajibDeskripsi
ephemeralobjecttidak
configmapobjecttidak
secretobjecttidak
persistentobjecttidak
persistentTemplateobjecttidakTemplat klaim per replika. Memerlukan form: stateful, karena hanya bentuk stateful yang memberi setiap replika identitas stabil yang dibutuhkan oleh klaim per replika. Di Kubernetes, ini menjadi StatefulSet.volumeClaimTemplates. Pada target compose, ini diturunkan menjadi satu volume bernama yang digunakan bersama oleh semua replika, dan sebuah peringatan melaporkan penurunan tersebut.

Properti tambahan tidak diizinkan.

volume.ephemeral

PropertiJenisWajibDeskripsi
sizeLimitstringtidakKuantitas K8s (mis., ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: volume menjadi entri tmpfs yang tidak memuat ukuran, sehingga nilai ini tidak mencapai bagian mana pun dari output — sebuah peringatan melaporkannya jika ditulis.

Properti tambahan tidak diizinkan.

volume.configmap

PropertiJenisWajibDeskripsi
sourcestringyaNama ConfigMap, yang dikeluarkan oleh Recipe ini melalui artifacts: atau oleh Feature yang terpasang; ConfigMap yang dikeluarkan Recipe lain tidak dirujuk di sini.
itemsobject[]tidakPemilihan kunci-ke-path opsional.

Properti tambahan tidak diizinkan.

volume.secret

PropertiJenisWajibDeskripsi
sourcestringya
itemsobject[]tidak

Properti tambahan tidak diizinkan.

volume.persistent

PropertiJenisWajibDeskripsi
sizestringyaKuantitas K8s (mis., ‘10Gi’).
classstringtidakStorageClassName. Opsional.
accessModesstring (enum)[]tidakMode akses PVC. helm mengeluarkan spec.accessModes, dengan default [ReadWriteOnce] jika dihilangkan. Volume compose tidak memiliki konsep mode akses dan menghilangkannya. Nilai yang diizinkan untuk setiap entri: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Properti tambahan tidak diizinkan.

volume.persistentTemplate

Templat klaim per replika. Memerlukan form: stateful, karena hanya bentuk stateful yang memberi setiap replika identitas stabil yang dibutuhkan oleh klaim per replika. Di Kubernetes, ini menjadi StatefulSet.volumeClaimTemplates. Pada target compose, ini diturunkan menjadi satu volume bernama yang digunakan bersama oleh semua replika, dan sebuah peringatan melaporkan penurunan tersebut.

PropertiJenisWajibDeskripsi
sizestringya
classstringtidak
accessModesstring (enum)[]tidakMode akses PVC untuk templat klaim per replika. helm mengeluarkan spec.accessModes, dengan default [ReadWriteOnce] jika dihilangkan. compose tidak memiliki konsep mode akses dan menghilangkannya. Nilai yang diizinkan untuk setiap entri: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Properti tambahan tidak diizinkan.

service

PropertiJenisWajibDeskripsi
typestring (enum)yaJenis service: seberapa jauh port entri dapat dijangkau. ClusterIP mempertahankannya di jaringan target itu sendiri, dapat dijangkau dari peer workload; Headless juga demikian, dan pada helm merender Service K8s dengan clusterIP: None; NodePort dan LoadBalancer memublikasikannya di luar jaringan tersebut; Loopback memublikasikannya hanya pada alamat loopback host itu sendiri, dapat dijangkau dari mesin tempat workload berjalan dan tidak dari tempat lain. helm merender ClusterIP, NodePort, dan LoadBalancer sebagai jenis Service K8s dengan nama yang sama, dan menolak entri Loopback dengan menyebut namanya, karena Service K8s tidak memiliki jenis yang terikat ke alamat loopback host. compose tidak memublikasikan apa pun untuk ClusterIP dan Headless, memublikasikan port NodePort dan LoadBalancer pada setiap antarmuka host sebagai host:container, dan memublikasikan port Loopback pada alamat loopback IPv4 sebagai 127.0.0.1:host:container; port yang juga dipublikasikan oleh entri NodePort atau LoadBalancer dipublikasikan pada setiap antarmuka. Nilai yang diizinkan: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback"
portsmap dari integeryaMap dari nama port service → nomor port container. Nama port harus cocok dengan kunci di containers..ports. Port service tidak memiliki protokol transport sendiri: port tersebut mengambil transport dari port container yang dirujuk oleh namanya, sehingga transport sebuah port dideklarasikan sekali, pada port container, dan eksposur service tidak dapat berbeda dari apa yang dibuka oleh container.

Properti tambahan tidak diizinkan.