Schemat Aggrega Workload
Dokumentacja wygenerowana automatycznie. Nie należy jej edytować ręcznie — należy ją wygenerować ponownie z opublikowanego JSON Schema.
Identyfikator schematu: https://aggrega.ai/schemas/workload-v1beta1.schema.json
Abstrakcyjna specyfikacja obciążenia, której właścicielem jest platforma. Encja Recipe korzystająca z trybu syntetyzowanego deklaruje dokładnie jedną encję Workload za pomocą słowa kluczowego workload: (jako wbudowany skalar blokowy lub workload: { $import:
Wskazówki dotyczące tworzenia encji Workload opisowo przedstawia dokumentacja tworzenia encji Workload; ta strona dokumentuje schemat strukturalny, który opisuje tamta dokumentacja.
Typ najwyższego poziomu: object
Właściwości
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | tak | Stała: "aggrega.ai/v1beta1" |
kind | const “Workload” | tak | Stała: "Workload" |
form | string (enum) | nie | Abstrakcyjna intencja kształtu kontrolera dla obciążenia. Wybiera rodzaj cyklu życia w czasie wykonania, niezależnie od platformy docelowej: stateless (wymienne, długo działające repliki), stateful (repliki ze stabilną tożsamością i pamięcią masową dla każdej repliki), daemon (jedna instancja na każdy kwalifikujący się host), scheduled (cykliczne uruchomienia wyzwalane czasem), task (pojedyncze uruchomienie do zakończenia), reference (zewnętrzny punkt końcowy bez zasobów obliczeniowych — bez kontrolera; helm emituje Service typu ExternalName, compose przenosi punkt końcowy przez kontrakt wstrzykiwania). Pusta wartość jest traktowana jako stateless. Każdy docelowy provider odwzorowuje formę na własny natywny kształt; sama forma nie zawiera rodzajów zasobów natywnych dla platformy. Wolumin persistentTemplate towarzyszy formie stateful i jest dozwolony tylko w obciążeniu stateful. Obciążenie reference deklaruje endpoint (i opcjonalnie port), nie deklaruje kontenerów i nie ma własnego pola poświadczeń, ponieważ nazwa zmiennej środowiskowej należy do konsumenta, a nie do punktu końcowego. Konsument potrzebujący poświadczenia dla punktu końcowego deklaruje slot we własnym featuresSchema encji Component i wypełnia go z bloku attachments swojego kontenera, o ile lista inject tego slotu dopuszcza takie dostarczenie. Dozwolone wartości: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Domyślnie: "stateless" |
endpoint | string | nie | Zewnętrzny punkt końcowy dla form: reference — host lub URL. Kompilator przekazuje go dalej jako deterministyczny ciąg wskaźnika; nigdy nie jest rozwiązywany w czasie kompilacji (AOT). Wymagany, gdy form ma wartość reference, i tylko wtedy ma znaczenie. helm emituje go jako externalName w Service typu ExternalName (część z nazwą hosta); compose przekazuje go konsumentom przez provides receptury. |
port | integer | nie | Opcjonalny port punktu końcowego reference (form: reference). helm emituje go jako port w Service typu ExternalName. Minimum: 1. Maksimum: 65535. |
schedule | string | nie | Harmonogram cron dla form: scheduled — standardowe 5-polowe wyrażenie crontab (na przykład ‘0 0 * * *’) lub jedno z makr @hourly, @daily, @weekly, @monthly, @yearly. Wymagany, gdy form ma wartość scheduled, i tylko wtedy ma znaczenie; docelowy provider przekazuje go dosłownie do pola schedule zasobu harmonogramowanego. |
suspend | logiczna | nie | Wstrzymuje cykliczny harmonogram obciążenia z form: scheduled. Gdy true, zasób harmonogramu jest renderowany z harmonogramem na miejscu, ale żadne uruchomienie nie rozpoczyna się z tego harmonogramu, dopóki nie zostanie wznowiony; uruchomienie nadal można utworzyć z zasobu ręcznie — w Kubernetes: kubectl create job false |
replicas | integer | nie | Liczba replik. Domyślnie 1. W celu compose wartość nie trafia do żadnej części wyniku, a ostrzeżenie zgłasza ją zawsze, gdy zostanie podana — również jawne 1. Minimum: 0. Domyślnie: 1 |
initContainers | container[] | nie | Uporządkowana lista kontenerów, które działają do zakończenia przed uruchomieniem kontenerów głównych. |
containers | mapa container | nie | Uporządkowana mapa nazwa kontenera → specyfikacja kontenera. Wymagany jest co najmniej jeden wpis. Kolejność nadana przez autora jest zachowywana. Co najmniej 1 wpis. |
volumes | mapa volume | nie | Uporządkowana mapa nazwa woluminu → specyfikacja woluminu. Każda specyfikacja woluminu deklaruje dokładnie jedno z: ephemeral, configmap, secret, persistent, persistentTemplate. |
services | mapa service | nie | Uporządkowana mapa nazwa usługi → specyfikacja usługi. W helm każdy wpis staje się osobnym Service K8s, a wpis typu Loopback zatrzymuje kompilację. W compose nie ma osobnego prymitywu usługi, więc wpisy nie odwzorowują się jeden do jednego: wpis typu NodePort lub LoadBalancer publikuje swoje porty na każdym interfejsie hosta we własnej usłudze compose obciążenia, wpis typu Loopback publikuje tam porty tylko na adresie loopback hosta, wpis typu ClusterIP lub Headless nie publikuje niczego, a każdy opublikowany port trafia na listę portów tej jednej usługi z portem hosta równym portowi kontenera. W helm każdy Service otrzymuje nazwę <name>-<key>: nazwę, którą nosi własny Deployment obciążenia (lub inny kontroler), a po niej łącznik i klucz wpisu, więc encja Workload deklarująca services.http, której Deployment nazywa się api-server, renderuje Service o nazwie api-server-http. W compose klucz niczego nie nazywa w wyniku. |
scheduling | object | nie | Natywne dla K8s ograniczenia harmonogramowania. Tłumaczone bezpośrednio dla helm. W celu compose ograniczenia te nie trafiają do żadnej części wyniku, a ostrzeżenie zgłasza blok, gdy zostanie podany. |
podSecurityContext | object | nie | |
serviceAccount | string | nie | Nazwa ServiceAccount, w ramach którego działa to obciążenie. Właściwe RBAC (zasoby ServiceAccount/Role/RoleBinding) należy emitować przez Features lub artefakty, a nie przez to pole. |
imagePullSecrets | string[] | nie | Nazwy sekretów image-pull do pobierania obrazów z prywatnych rejestrów. helm emituje pod.imagePullSecrets. compose nie ma odpowiednika w pliku — uwierzytelnianie w rejestrze konfiguruje się poza plikiem przez docker login — i pomija to pole. |
priorityClassName | string | nie | Nazwa PriorityClass określającej priorytet harmonogramowania tego obciążenia. helm emituje pod.priorityClassName. compose nie ma odpowiednika priorytetu harmonogramowania dla pojedynczego hosta i pomija to pole. |
runtimeClassName | string | nie | Nazwa RuntimeClass wybierającej środowisko uruchomieniowe kontenerów, w którym działa to obciążenie (na przykład środowisko z obsługą GPU, takie jak ‘nvidia’). Kompilator przekazuje nazwę dosłownie; klaster rozwiązuje ją na skonfigurowaną RuntimeClass w momencie harmonogramowania. helm emituje pod.runtimeClassName. compose nie ma odpowiednika runtime class i pomija to pole. Tylko dla obciążeń obliczeniowych: niedozwolone w obciążeniu reference. |
terminationGracePeriodSeconds | integer | nie | Liczba sekund między SIGTERM a SIGKILL podczas zamykania. helm emituje pod.terminationGracePeriodSeconds; compose emituje stop_grace_period. Minimum: 0. |
dnsPolicy | string (enum) | nie | Polityka DNS poda. helm emituje pod.dnsPolicy. compose nie ma odpowiednika polityki DNS i pomija to pole (zamiast tego compose odwzorowuje bezpośrednio nameservers/searches z dnsConfig). Dozwolone wartości: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None" |
dnsConfig | object | nie | Niestandardowa konfiguracja DNS poda. helm emituje pod.dnsConfig. compose odwzorowuje nameservers na dns, a searches na dns_search; options nie mają odpowiednika w compose i są tam pomijane. |
hostAliases | object[] | nie | Statyczne odwzorowania nazwa hosta → IP wstrzykiwane do pliku hosts poda. helm emituje pod.hostAliases; compose emituje extra_hosts (jeden wpis hostname:ip na każdą nazwę hosta). |
hostNetwork | logiczna | nie | Uruchamia obciążenie we własnej przestrzeni nazw sieci węzła hosta zamiast w izolowanej. Porty otwierane przez obciążenie są wtedy osiągalne pod własnymi adresami węzła, a obciążenie widzi interfejsy sieciowe węzła. Wybiera to wyłącznie przestrzeń nazw sieci: nie deklaruje żadnych portów, a każdy port otwierany przez obciążenie nadal deklaruje się w containers. |
Dodatkowe właściwości są niedozwolone.
workload.scheduling
Natywne dla K8s ograniczenia harmonogramowania. Tłumaczone bezpośrednio dla helm. W celu compose ograniczenia te nie trafiają do żadnej części wyniku, a ostrzeżenie zgłasza blok, gdy zostanie podany.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
nodeSelector | mapa string | nie | |
affinity | object | nie | |
tolerations | object[] | nie | |
topologySpreadConstraints | object[] | nie |
Dodatkowe właściwości są niedozwolone.
workload.podSecurityContext
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
runAsUser | integer | nie | |
runAsGroup | integer | nie | |
fsGroup | integer | nie | |
supplementalGroups | integer[] | nie |
Dodatkowe właściwości są niedozwolone.
workload.dnsConfig
Niestandardowa konfiguracja DNS poda. helm emituje pod.dnsConfig. compose odwzorowuje nameservers na dns, a searches na dns_search; options nie mają odpowiednika w compose i są tam pomijane.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
nameservers | string[] | nie | |
searches | string[] | nie | |
options | object[] | nie |
Dodatkowe właściwości są niedozwolone.
workload.hostAliases[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
ip | string | tak | |
hostnames | string[] | tak |
Dodatkowe właściwości są niedozwolone.
Definicje
container
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
name | string | nie | Opcjonalna nazwa kontenera. Dla pozycyjnego wpisu initContainers ustawia nazwę emitowanego kontenera; gdy zostanie pominięta, używana jest wygenerowana nazwa init- |
image | string | tak | Odwołanie do obrazu kontenera (np. ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’). |
imagePullPolicy | string (enum) | nie | Zasada pobierania obrazu. helm emituje ją jako container.imagePullPolicy. compose mapuje ją na pull_policy usługi (Always na always, Never na never, IfNotPresent na if_not_present). Dozwolone wartości: "Always", "Never", "IfNotPresent" |
command | string[] | nie | Nadpisuje entrypoint obrazu. K8s: .command. Compose: entrypoint. |
args | string[] | nie | Argumenty przekazywane do command (lub do entrypointu obrazu, jeśli command nie występuje). K8s: .args. Compose: command. |
variables | mapa string | nie | Zmienne środowiskowe jako pary klucz-wartość typu string. K8s: spec.template.spec.containers[].env[]. Compose: services. |
attachments | mapa containerAttachment | nie | Uporządkowana mapa nazwa zmiennej środowiskowej lub pliku → { from, as, key?, path?, connection? }. Każdy wpis odwołuje się do slotu zadeklarowanego w featuresSchema encji Component — lub, gdy wpis wskazuje połączenie, do slotu deklarowanego przez gniazdo tego połączenia — i dostarcza to, co opublikowało przyłączenie wypełniające ten slot. Pole ‘as’ wybiera mechanizm dostarczania, który musi znajdować się na liście dozwolonych w tablicy inject: slotu. Sloty typu blackbox (inject: []) NIE MOGĄ się tu pojawiać. |
envFrom | object[] | nie | Zbiorcze zmienne środowiskowe importowane ze źródła ConfigMap lub Secret. helm emituje container.envFrom (configMapRef/secretRef). compose nie ma prymitywu env-from-object — odwołanie do źródła nie jest plikiem na hoście, więc reinterpretacja jako env_file po cichu zmieniłaby znaczenie; workload deklarujący envFrom jawnie przerywa kompilację dla celu compose. |
ports | mapa liczb całkowitych lub obiektów | nie | Nazwane porty kontenera. Port zapisuje się albo jako sam numer portu (web: 8080), albo jako obiekt zawierający numer wraz z protokołem transportowym portu (dns: { port: 53, protocol: UDP }); gdy protokół nie jest zadeklarowany, obie formy znaczą to samo. Dozwolone wartości protokołu to TCP, UDP i SCTP, a pominięcie klucza pozostawia w mocy domyślną wartość celu. Do nazw portów odwołują się services.*.ports oraz rozwiązywanie portu sondy http, a port usługi przejmuje transport od portu kontenera, na który wskazuje jego nazwa, więc transport deklaruje się raz. K8s: containerPort, z protocol tylko tam, gdzie został zadeklarowany. Compose: port kontenera trafia do wyniku tylko tam, gdzie publikuje go specyfikacja usługi; sam port kontenera nie ma osobnego pola w compose, a opublikowany port niesie zadeklarowany transport jako przyrostek /protocol we wpisie publikacji — transport, którego compose nie potrafi zapisać, przerywa kompilację zamiast publikować port niosący inny transport. |
resources | object | nie | |
health | object | nie | Sondy kondycji kontenera — ready, live i startup — każda zadeklarowana jako http, tcp lub exec. Dla helm tłumaczone na httpGet/tcpSocket/exec K8s. W compose usługa ma jeden healthcheck: http i tcp stają się testami CMD-SHELL, exec staje się testem CMD, a gdy zadeklarowano więcej niż jedną sondę, zachowywana jest tylko jedna — ostrzeżenie wskazuje przetłumaczoną sondę i pominięte. |
volumeMounts | object[] | nie | |
restartPolicy | string (enum) | nie | Dozwolone wartości: "Always", "OnFailure", "Never" |
lifecycle | object | nie | Hooki cyklu życia kontenera. Dla helm tłumaczone na container.lifecycle K8s (postStart/preStop). compose nie ma prymitywu hooków cyklu życia; workload deklarujący lifecycle jawnie przerywa kompilację dla celu compose, zamiast po cichu pomijać hook. |
securityContext | object | nie |
Dodatkowe właściwości są niedozwolone.
container.envFrom[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
configMap | string | nie | Nazwa źródła ConfigMap emitowanego przez wejście artifacts tej encji Recipe lub przez dołączoną encję Feature. |
secret | string | nie | Nazwa slotu featuresSchema — własnego slotu encji Component lub, gdy ustawiono connection, slotu deklarowanego przez gniazdo tego połączenia; nazwa importowanego obiektu Secret jest rozwiązywana z provides slotu. |
connection | string | nie | Alias połączenia, z którego korzysta komponent — nazwa, pod którą zapisano je w bloku uses komponentu, w encji Aggregate lub Release. Gdy jest ustawiony, secret wskazuje slot deklarowany przez gniazdo, przez które poprowadzono to połączenie, a importowany Secret to ten opublikowany przez przyłączenie, które to połączenie niesie w tym slocie, dzięki czemu komponent sięgający do kilku celów importuje własny Secret każdego z nich. Ma znaczenie tylko obok secret. Połączenie, z którego komponent nie korzysta, lub slot, którego jego gniazdo nie deklaruje, jest odrzucane z podaniem obu nazw. |
prefix | string | nie | Opcjonalny prefiks dodawany na początku nazwy każdej importowanej zmiennej środowiskowej. |
Dodatkowe właściwości są niedozwolone.
container.resources
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
requests | resourceList | nie | |
limits | resourceList | nie |
Dodatkowe właściwości są niedozwolone.
container.health
Sondy kondycji kontenera — ready, live i startup — każda zadeklarowana jako http, tcp lub exec. Dla helm tłumaczone na httpGet/tcpSocket/exec K8s. W compose usługa ma jeden healthcheck: http i tcp stają się testami CMD-SHELL, exec staje się testem CMD, a gdy zadeklarowano więcej niż jedną sondę, zachowywana jest tylko jedna — ostrzeżenie wskazuje przetłumaczoną sondę i pominięte.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
ready | probe | nie | |
live | probe | nie | |
startup | probe | nie |
Dodatkowe właściwości są niedozwolone.
container.volumeMounts[]
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
name | string | tak | Musi odpowiadać kluczowi w mapie volumes: najwyższego poziomu. |
path | string | tak | Punkt montowania wewnątrz kontenera. |
subPath | string | nie | Montuje pojedynczy plik lub podkatalog z woluminu w path, bez przesłaniania innych plików w katalogu docelowym. |
readonly | logiczna | nie | Domyślnie: false |
Dodatkowe właściwości są niedozwolone.
container.lifecycle
Hooki cyklu życia kontenera. Dla helm tłumaczone na container.lifecycle K8s (postStart/preStop). compose nie ma prymitywu hooków cyklu życia; workload deklarujący lifecycle jawnie przerywa kompilację dla celu compose, zamiast po cichu pomijać hook.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
postStart | lifecycleHook | nie | |
preStop | lifecycleHook | nie |
Dodatkowe właściwości są niedozwolone.
container.securityContext
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
runAsUser | integer | nie | |
runAsGroup | integer | nie | |
runAsNonRoot | logiczna | nie | |
readOnlyRootFilesystem | logiczna | nie | |
allowPrivilegeEscalation | logiczna | nie | |
capabilities | object | nie |
Dodatkowe właściwości są niedozwolone.
container.securityContext.capabilities
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
add | string[] | nie | |
drop | string[] | nie |
Dodatkowe właściwości są niedozwolone.
containerAttachment
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
from | string | tak | Nazwa slotu zadeklarowanego w featuresSchema encji Component — lub, gdy ustawiono connection, slotu deklarowanego przez gniazdo, przez które poprowadzono to połączenie. |
connection | string | nie | Alias połączenia, z którego korzysta komponent — nazwa, pod którą zapisano je w bloku uses komponentu, w encji Aggregate lub Release. Gdy jest ustawiony, from wskazuje slot deklarowany przez gniazdo, przez które poprowadzono to połączenie (usesSchema. |
as | string (enum) | tak | Mechanizm dostarczania. Musi znajdować się na liście dozwolonych w tablicy inject: slotu. Dozwolone wartości: "env", "file" |
key | string | nie | Dla as: env konkretny klucz danych sekretu wskazanego slotu, który odczytuje ten wpis. Należy go ustawić, gdy sekret slotu zawiera kilka kluczy danych, aby wpis wybrał jeden z nich po nazwie; dwa wpisy mogą odwoływać się do tego samego slotu z różnymi kluczami, by odczytać kilka kluczy z jednego sekretu. Gdy zostanie pominięty, wpis odczytuje jedyny opublikowany klucz slotu. Ignorowany dla as: file, które montuje cały sekret. |
path | string | nie | Ścieżka pliku wewnątrz kontenera (wymagana, gdy as: file). |
Dodatkowe właściwości są niedozwolone.
resourceList
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
cpu | string | nie | Ilość CPU (np. ‘100m’, ‘0.5’, ‘2’). helm emituje ją dosłownie pod resources.{requests,limits}.cpu. compose mapuje ją na deploy.resources.{reservations,limits}.cpus jako ułamek rdzeni — ilość w milicpu jest konwertowana (500m staje się 0.5); zwykła liczba rdzeni przechodzi bez zmian. Ilość, której compose nie potrafi przekonwertować, jawnie zatrzymuje kompilację zamiast emitować błędną wartość. |
memory | string | nie | Ilość pamięci (np. ‘128Mi’, ‘1Gi’). helm emituje ją dosłownie pod resources.{requests,limits}.memory. compose mapuje ją na deploy.resources.{reservations,limits}.memory jako dokładną liczbę bajtów. Ilość dająca całkowitą liczbę bajtów jest konwertowana dokładnie (1.5Gi staje się 1610612736); ilość, która jej nie daje albo nie jest ilością, jawnie zatrzymuje kompilację zamiast zaokrąglać. |
Dodatkowe klucze: rozszerzona ilość zasobu (o zakresie dostawcy/domeny), kluczowana w pełni kwalifikowaną nazwą ’^[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])?$.
Żadne inne właściwości nie są dozwolone.
probe
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
http | string | nie | Sonda HTTP GET: ścieżka jest sprawdzana na tym porcie kontenera, którego nazwa jest pierwsza w kolejności alfabetycznej. |
tcp | integer | nie | Sonda gniazda TCP na podanym numerze portu kontenera. Minimum: 1. Maksimum: 65535. |
exec | string[] | nie | Sonda exec — polecenie do uruchomienia wewnątrz kontenera. Co najmniej 1 wpis. |
timeoutSeconds | integer | nie | Minimum: 1. |
initialDelaySeconds | integer | nie | Minimum: 0. |
periodSeconds | integer | nie | Minimum: 1. |
failureThreshold | integer | nie | Minimum: 1. |
successThreshold | integer | nie | Minimum: 1. |
Dodatkowe właściwości są niedozwolone.
lifecycleHook
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
exec | string[] | nie | Co najmniej 1 wpis. |
httpGet | object | nie | Natywny dla K8s kształt httpGet (path, port, scheme, host, httpHeaders). Przekazywany do helm. Na celu compose obciążenie deklarujące hook cyklu życia zatrzymuje kompilację, ponieważ compose nie ma prymitywu hooka cyklu życia — hook nigdy nie jest po cichu pomijany. |
Dodatkowe właściwości są niedozwolone.
volume
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
ephemeral | object | nie | |
configmap | object | nie | |
secret | object | nie | |
persistent | object | nie | |
persistentTemplate | object | nie | Szablon żądania na replikę. Wymaga form: stateful, ponieważ tylko kształt stateful daje każdej replice stabilną tożsamość, której potrzebuje żądanie na replikę. W Kubernetes staje się StatefulSet.volumeClaimTemplates. Na celu compose degraduje się do pojedynczego nazwanego wolumenu współdzielonego przez wszystkie repliki, a ostrzeżenie zgłasza tę degradację. |
Dodatkowe właściwości są niedozwolone.
volume.ephemeral
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
sizeLimit | string | nie | Ilość K8s (np. ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: wolumen staje się wpisem tmpfs bez rozmiaru, więc ta wartość nie trafia do żadnej części wyniku — gdy jest podana, zgłasza to ostrzeżenie. |
Dodatkowe właściwości są niedozwolone.
volume.configmap
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
source | string | tak | Nazwa ConfigMap emitowanej przez ten Recipe przez artifacts: albo przez dołączony Feature; ConfigMap emitowana przez inną encję Recipe nie jest tu przywoływana. |
items | object[] | nie | Opcjonalny wybór klucz–ścieżka. |
Dodatkowe właściwości są niedozwolone.
volume.secret
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
source | string | tak | |
items | object[] | nie |
Dodatkowe właściwości są niedozwolone.
volume.persistent
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
size | string | tak | Ilość K8s (np. ‘10Gi’). |
class | string | nie | StorageClassName. Opcjonalne. |
accessModes | string (enum)[] | nie | Tryby dostępu PVC. helm emituje spec.accessModes, domyślnie [ReadWriteOnce], gdy pominięto. Wolumeny compose nie mają pojęcia trybu dostępu i go pomijają. Dozwolone wartości każdego wpisu: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
Dodatkowe właściwości są niedozwolone.
volume.persistentTemplate
Szablon żądania na replikę. Wymaga form: stateful, ponieważ tylko kształt stateful daje każdej replice stabilną tożsamość, której potrzebuje żądanie na replikę. W Kubernetes staje się StatefulSet.volumeClaimTemplates. Na celu compose degraduje się do pojedynczego nazwanego wolumenu współdzielonego przez wszystkie repliki, a ostrzeżenie zgłasza tę degradację.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
size | string | tak | |
class | string | nie | |
accessModes | string (enum)[] | nie | Tryby dostępu PVC dla szablonu żądania na replikę. helm emituje spec.accessModes, domyślnie [ReadWriteOnce], gdy pominięto. compose nie ma pojęcia trybu dostępu i go pomija. Dozwolone wartości każdego wpisu: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
Dodatkowe właściwości są niedozwolone.
service
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
type | string (enum) | tak | Typ usługi: jak daleko sięgają porty wpisu. ClusterIP utrzymuje je we własnej sieci celu, osiągalne dla sąsiadów obciążenia; Headless również, a w helm renderuje K8s Service z clusterIP: None; NodePort i LoadBalancer publikują je poza tę sieć; Loopback publikuje je tylko na adresie pętli zwrotnej hosta, osiągalne z maszyny, na której działa obciążenie, i znikąd indziej. helm renderuje ClusterIP, NodePort i LoadBalancer jako typ K8s Service o tej samej nazwie i odrzuca wpis Loopback, podając go z nazwy, ponieważ K8s Service nie ma typu wiążącego się z adresem pętli zwrotnej hosta. compose nie publikuje niczego dla ClusterIP i Headless, publikuje porty NodePort i LoadBalancer na każdym interfejsie hosta jako host:container, a porty Loopback na adresie pętli zwrotnej IPv4 jako 127.0.0.1:host:container; port publikowany także przez wpis NodePort lub LoadBalancer jest publikowany na każdym interfejsie. Dozwolone wartości: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback" |
ports | mapa liczb całkowitych | tak | Mapa nazwa portu usługi → numer portu kontenera. Nazwy portów muszą odpowiadać kluczom w containers. |
Dodatkowe właściwości są niedozwolone.