Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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: } zgodnie z ujednoliconym słownikiem importu plików). Docelowy dostawca tłumaczy encję Workload na natywne manifesty dostawcy (K8s Deployment/StatefulSet/Services/PVCs dla helm; usługi compose + wolumeny + sieci dla compose; itd.). Encja Workload nie ma własnych metadanych — żadnej nazwy, żadnych etykiet, żadnych adnotacji. Tożsamość i etykiety pochodzą z instancji komponentu, która ją deklaruje: docelowy dostawca wyprowadza nazwę każdego renderowanego zasobu z tej instancji i oznacza zasób kluczami pochodzenia aggrega.ai/* dla tego węzła. Rodzaj Workload NIE jest encją katalogu — ten opublikowany plik jest kanonicznym schematem JSON Schema encji Workload, a kompilator waliduje encję Workload względem niego.

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śćTypWymaganaOpis
apiVersionconst “aggrega.ai/v1beta1”takStała: "aggrega.ai/v1beta1"
kindconst “Workload”takStała: "Workload"
formstring (enum)nieAbstrakcyjna 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"
endpointstringnieZewnę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.
portintegernieOpcjonalny port punktu końcowego reference (form: reference). helm emituje go jako port w Service typu ExternalName. Minimum: 1. Maksimum: 65535.
schedulestringnieHarmonogram 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.
suspendlogicznanieWstrzymuje 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 —from=cronjob/. suspend: false renderuje się dokładnie tak samo jak brak suspend. Ma znaczenie tylko przy form: scheduled. helm emituje go jako spec.suspend obiektu CronJob. compose nie ma kształtu harmonogramu i zatrzymuje się na obciążeniu z form: scheduled niezależnie od tego, czy jest wstrzymane. Domyślnie: false
replicasintegernieLiczba 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
initContainerscontainer[]nieUporządkowana lista kontenerów, które działają do zakończenia przed uruchomieniem kontenerów głównych.
containersmapa containernieUporządkowana mapa nazwa kontenera → specyfikacja kontenera. Wymagany jest co najmniej jeden wpis. Kolejność nadana przez autora jest zachowywana. Co najmniej 1 wpis.
volumesmapa volumenieUporządkowana mapa nazwa woluminu → specyfikacja woluminu. Każda specyfikacja woluminu deklaruje dokładnie jedno z: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmapa servicenieUporzą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.
schedulingobjectnieNatywne 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.
podSecurityContextobjectnie
serviceAccountstringnieNazwa 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.
imagePullSecretsstring[]nieNazwy 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.
priorityClassNamestringnieNazwa 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.
runtimeClassNamestringnieNazwa 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.
terminationGracePeriodSecondsintegernieLiczba sekund między SIGTERM a SIGKILL podczas zamykania. helm emituje pod.terminationGracePeriodSeconds; compose emituje stop_grace_period. Minimum: 0.
dnsPolicystring (enum)niePolityka 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"
dnsConfigobjectnieNiestandardowa 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.
hostAliasesobject[]nieStatyczne 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).
hostNetworklogicznanieUruchamia 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..ports. helm emituje pod.hostNetwork. compose emituje network_mode: host we własnej usłudze obciążenia; usługa compose w tym trybie nie jest podłączona do sieci granicznej, więc jej sąsiedzi osiągają ją pod adresami węzła, a nie po nazwie usługi, a usługa każdego kontenera init dołącza do sieci granicznej samodzielnie. Tylko dla obciążeń obliczeniowych: niedozwolone w obciążeniu reference.

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śćTypWymaganaOpis
nodeSelectormapa stringnie
affinityobjectnie
tolerationsobject[]nie
topologySpreadConstraintsobject[]nie

Dodatkowe właściwości są niedozwolone.

workload.podSecurityContext

WłaściwośćTypWymaganaOpis
runAsUserintegernie
runAsGroupintegernie
fsGroupintegernie
supplementalGroupsinteger[]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śćTypWymaganaOpis
nameserversstring[]nie
searchesstring[]nie
optionsobject[]nie

Dodatkowe właściwości są niedozwolone.

workload.hostAliases[]

WłaściwośćTypWymaganaOpis
ipstringtak
hostnamesstring[]tak

Dodatkowe właściwości są niedozwolone.

Definicje

container

WłaściwośćTypWymaganaOpis
namestringnieOpcjonalna nazwa kontenera. Dla pozycyjnego wpisu initContainers ustawia nazwę emitowanego kontenera; gdy zostanie pominięta, używana jest wygenerowana nazwa init- (pozycja wpisu na liście). Dla wpisu mapy containers nazwą kontenera jest klucz mapy, a to pole jest ignorowane.
imagestringtakOdwołanie do obrazu kontenera (np. ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)nieZasada 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"
commandstring[]nieNadpisuje entrypoint obrazu. K8s: .command. Compose: entrypoint.
argsstring[]nieArgumenty przekazywane do command (lub do entrypointu obrazu, jeśli command nie występuje). K8s: .args. Compose: command.
variablesmapa stringnieZmienne środowiskowe jako pary klucz-wartość typu string. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmapa containerAttachmentnieUporzą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ć.
envFromobject[]nieZbiorcze 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.
portsmapa liczb całkowitych lub obiektównieNazwane 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.
resourcesobjectnie
healthobjectnieSondy 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.
volumeMountsobject[]nie
restartPolicystring (enum)nieDozwolone wartości: "Always", "OnFailure", "Never"
lifecycleobjectnieHooki 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.
securityContextobjectnie

Dodatkowe właściwości są niedozwolone.

container.envFrom[]

WłaściwośćTypWymaganaOpis
configMapstringnieNazwa źródła ConfigMap emitowanego przez wejście artifacts tej encji Recipe lub przez dołączoną encję Feature.
secretstringnieNazwa 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.
connectionstringnieAlias 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.
prefixstringnieOpcjonalny prefiks dodawany na początku nazwy każdej importowanej zmiennej środowiskowej.

Dodatkowe właściwości są niedozwolone.

container.resources

WłaściwośćTypWymaganaOpis
requestsresourceListnie
limitsresourceListnie

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śćTypWymaganaOpis
readyprobenie
liveprobenie
startupprobenie

Dodatkowe właściwości są niedozwolone.

container.volumeMounts[]

WłaściwośćTypWymaganaOpis
namestringtakMusi odpowiadać kluczowi w mapie volumes: najwyższego poziomu.
pathstringtakPunkt montowania wewnątrz kontenera.
subPathstringnieMontuje pojedynczy plik lub podkatalog z woluminu w path, bez przesłaniania innych plików w katalogu docelowym.
readonlylogicznanieDomyś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śćTypWymaganaOpis
postStartlifecycleHooknie
preStoplifecycleHooknie

Dodatkowe właściwości są niedozwolone.

container.securityContext

WłaściwośćTypWymaganaOpis
runAsUserintegernie
runAsGroupintegernie
runAsNonRootlogicznanie
readOnlyRootFilesystemlogicznanie
allowPrivilegeEscalationlogicznanie
capabilitiesobjectnie

Dodatkowe właściwości są niedozwolone.

container.securityContext.capabilities
WłaściwośćTypWymaganaOpis
addstring[]nie
dropstring[]nie

Dodatkowe właściwości są niedozwolone.

containerAttachment

WłaściwośćTypWymaganaOpis
fromstringtakNazwa slotu zadeklarowanego w featuresSchema encji Component — lub, gdy ustawiono connection, slotu deklarowanego przez gniazdo, przez które poprowadzono to połączenie.
connectionstringnieAlias 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..featuresSchema), a wpis dostarcza to, co opublikowało przyłączenie niesione przez to połączenie w tym slocie, dzięki czemu komponent sięgający do kilku celów przedstawia każdemu z nich własne poświadczenie. Lista dozwolonych inject: slotu określa as dokładnie tak, jak dla slotu deklarowanego przez encję Component. Połączenie, z którego komponent nie korzysta, lub slot, którego jego gniazdo nie deklaruje, jest odrzucane z podaniem obu nazw.
asstring (enum)takMechanizm dostarczania. Musi znajdować się na liście dozwolonych w tablicy inject: slotu. Dozwolone wartości: "env", "file"
keystringnieDla 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.
pathstringnieŚcieżka pliku wewnątrz kontenera (wymagana, gdy as: file).

Dodatkowe właściwości są niedozwolone.

resourceList

WłaściwośćTypWymaganaOpis
cpustringnieIlość 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ść.
memorystringnieIlość 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ą ’/’ (na przykład ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). Segment domeny zawiera co najmniej jedną kropkę, co odróżnia klucz rozszerzony od samych ilości cpu/memory. Kompilator przekazuje ilość dosłownie; device plugin klastra rozwiązuje ją i przydziela w czasie szeregowania. helm emituje ją pod resources.{requests,limits}.. compose rezerwuje liczbę ‘nvidia.com/gpu’ jako rezerwację urządzenia NVIDIA w usłudze kontenera — liczbę z limitu, gdy limit jest zapisany, w przeciwnym razie z żądania, i żadnej rezerwacji dla liczby 0 — oraz zatrzymuje kompilację przy liczbie niebędącej całkowitą liczbą urządzeń albo gdy żądanie i limit podają różne liczby. compose nie ma odpowiednika dla żadnego innego klucza rozszerzonego i pomija go, ostrzegając raz dla każdego odrębnego klucza rozszerzonego i podając ten klucz, dzięki czemu pominięcie jest zgłaszane, a nie ciche. Wzorzec: ^[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śćTypWymaganaOpis
httpstringnieSonda HTTP GET: ścieżka jest sprawdzana na tym porcie kontenera, którego nazwa jest pierwsza w kolejności alfabetycznej.
tcpintegernieSonda gniazda TCP na podanym numerze portu kontenera. Minimum: 1. Maksimum: 65535.
execstring[]nieSonda exec — polecenie do uruchomienia wewnątrz kontenera. Co najmniej 1 wpis.
timeoutSecondsintegernieMinimum: 1.
initialDelaySecondsintegernieMinimum: 0.
periodSecondsintegernieMinimum: 1.
failureThresholdintegernieMinimum: 1.
successThresholdintegernieMinimum: 1.

Dodatkowe właściwości są niedozwolone.

lifecycleHook

WłaściwośćTypWymaganaOpis
execstring[]nieCo najmniej 1 wpis.
httpGetobjectnieNatywny 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śćTypWymaganaOpis
ephemeralobjectnie
configmapobjectnie
secretobjectnie
persistentobjectnie
persistentTemplateobjectnieSzablon żą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śćTypWymaganaOpis
sizeLimitstringnieIlość 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śćTypWymaganaOpis
sourcestringtakNazwa ConfigMap emitowanej przez ten Recipe przez artifacts: albo przez dołączony Feature; ConfigMap emitowana przez inną encję Recipe nie jest tu przywoływana.
itemsobject[]nieOpcjonalny wybór klucz–ścieżka.

Dodatkowe właściwości są niedozwolone.

volume.secret

WłaściwośćTypWymaganaOpis
sourcestringtak
itemsobject[]nie

Dodatkowe właściwości są niedozwolone.

volume.persistent

WłaściwośćTypWymaganaOpis
sizestringtakIlość K8s (np. ‘10Gi’).
classstringnieStorageClassName. Opcjonalne.
accessModesstring (enum)[]nieTryby 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śćTypWymaganaOpis
sizestringtak
classstringnie
accessModesstring (enum)[]nieTryby 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śćTypWymaganaOpis
typestring (enum)takTyp 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"
portsmapa liczb całkowitychtakMapa nazwa portu usługi → numer portu kontenera. Nazwy portów muszą odpowiadać kluczom w containers..ports. Port usługi nie ma własnego protokołu transportowego: przejmuje transport portu kontenera, do którego rozwiązuje się jego nazwa, więc transport portu deklaruje się raz, na porcie kontenera, a ekspozycja usługi nie może być sprzeczna z tym, co otworzył kontener.

Dodatkowe właściwości są niedozwolone.