KubernetesManifest@1 – Nasazení do úlohy Kubernetes v1

Soubory manifestu Kubernetes můžete použít k nasazení do clusterů nebo dokonce k pečení souborů manifestu, které se mají použít pro nasazení pomocí chartů Helm.

# Deploy to Kubernetes v1
# Use Kubernetes manifest files to deploy to clusters or even bake the manifest files to be used for deployments using Helm charts.
- task: KubernetesManifest@1
  inputs:
    #action: 'deploy' # 'bake' | 'createSecret' | 'delete' | 'deploy' | 'patch' | 'promote' | 'scale' | 'reject'. Action. Default: deploy.
    #connectionType: 'kubernetesServiceConnection' # 'azureResourceManager' | 'kubernetesServiceConnection'. Required when action != bake. Service connection type. Default: kubernetesServiceConnection.
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when action != bake && connectionType = kubernetesServiceConnection. Kubernetes service connection. 
    #azureSubscriptionConnection: # string. Alias: azureSubscriptionEndpoint. Required when action != bake && connectionType = azureResourceManager. Azure subscription. 
    #azureResourceGroup: # string. Required when action != bake && connectionType = azureResourceManager. Resource group. 
    #kubernetesCluster: # string. Required when action != bake && connectionType = azureResourceManager. Kubernetes cluster. 
    #useClusterAdmin: false # boolean. Optional. Use when connectionType = azureResourceManager. Use cluster admin credentials. Default: false.
    #namespace: # string. Namespace. 
    #strategy: 'none' # 'canary' | 'none'. Optional. Use when action = deploy || action = promote || action = reject. Strategy. Default: none.
    #trafficSplitMethod: 'pod' # 'pod' | 'smi'. Optional. Use when strategy = canary. Traffic split method. Default: pod.
    #percentage: '0' # string. Required when strategy = Canary && action = deploy. Percentage. Default: 0.
    #baselineAndCanaryReplicas: '1' # string. Required when strategy = Canary && action = deploy && trafficSplitMethod = SMI. Baseline and canary replicas. Default: 1.
    #manifests: # string. Required when action = deploy || action = promote || action = reject. Manifests. 
    #containers: # string. Optional. Use when action = deploy || action = promote || action = bake. Containers. 
    #imagePullSecrets: # string. Optional. Use when action = deploy || action = promote. ImagePullSecrets. 
    #renderType: 'helm' # 'helm' | 'kompose' | 'kustomize'. Optional. Use when action = bake. Render Engine. Default: helm.
    #dockerComposeFile: # string. Required when action = bake && renderType = kompose. Path to docker compose file. 
    #helmChart: # string. Required when action = bake && renderType = helm. Helm Chart. 
    #releaseName: # string. Optional. Use when action = bake && renderType = helm. Helm Release Name. 
    #overrideFiles: # string. Optional. Use when action = bake && renderType = helm. Override Files. 
    #overrides: # string. Optional. Use when action = bake && renderType = helm. Overrides. 
    #kustomizationPath: # string. Optional. Use when action = bake && renderType = kustomize. Kustomization Path. 
    #resourceToPatch: 'file' # 'file' | 'name'. Required when action = patch. Resource to patch. Default: file.
    #resourceFileToPatch: # string. Required when action = patch && resourceToPatch = file. File path. 
    #kind: # 'deployment' | 'replicaset' | 'statefulset'. Required when action = scale || resourceToPatch = name. Kind. 
    #name: # string. Required when action = scale || resourceToPatch = name. Name. 
    #replicas: # string. Required when action = scale. Replica count. 
    #mergeStrategy: 'strategic' # 'json' | 'merge' | 'strategic'. Required when action = patch. Merge Strategy. Default: strategic.
    #arguments: # string. Optional. Use when action = delete. Arguments. 
    #patch: # string. Required when action = patch. Patch. 
    #secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when action = createSecret. Type of secret. Default: dockerRegistry.
    #secretName: # string. Optional. Use when action = createSecret. Secret name. 
    #secretArguments: # string. Optional. Use when action = createSecret && secretType = generic. Arguments. 
    #dockerRegistryEndpoint: # string. Optional. Use when action = createSecret && secretType = dockerRegistry. Docker registry service connection. 
    #rolloutStatusTimeout: '0' # string. Optional. Use when action = deploy || action = patch || action = scale || action = promote. Timeout for rollout status. Default: 0.

action - Akce
string. Povolené hodnoty: bake, createSecret (vytvoření tajného klíče), delete, deploy, , patch, promote, scale. reject Výchozí hodnota: deploy.

Určuje akci, která se má provést.

connectionType - Typ připojení služby
string. Vyžaduje se, když action != bake. Povolené hodnoty: azureResourceManager (Azure Resource Manager) kubernetesServiceConnection (Připojení ke službě Kubernetes Service). Výchozí hodnota: kubernetesServiceConnection.

Vyberte typ připojení služby Kubernetes.

• kubernetesServiceConnection (Připojení ke službě Kubernetes Service) – Umožňuje zadat soubor KubeConfig, zadat účet služby nebo importovat instanci AKS s možností Předplatné Azure . Import instance AKS s možností předplatného Azure vyžaduje přístup ke clusteru Kubernetes v době konfigurace připojení služby.
• azureResourceManager(Azure Resource Manager) – Umožňuje vybrat instanci AKS. Nemá přístup ke clusteru Kubernetes v době konfigurace připojení služby.

Další informace najdete v tématu Poznámky.

kubernetesServiceConnection - Připojení ke službě Kubernetes
Alias vstupu: kubernetesServiceEndpoint. string. Vyžaduje se, když action != bake && connectionType = kubernetesServiceConnection.

Určuje připojení služby Kubernetes.

azureSubscriptionConnection - Předplatné Azure
Alias vstupu: azureSubscriptionEndpoint. string. Vyžaduje se, když action != bake && connectionType = azureResourceManager.

Vyberte předplatné Azure Resource Manager, které obsahuje Azure Container Registry. Poznámka: Pokud chcete nakonfigurovat nové připojení služby, vyberte ze seznamu předplatné Azure a klikněte na Autorizovat. Pokud vaše předplatné není uvedené nebo pokud chcete použít existující instanční objekt, můžete nastavit připojení služby Azure pomocí tlačítka Přidat nebo Spravovat.

azureResourceGroup - Skupina prostředků
string. Vyžaduje se, když action != bake && connectionType = azureResourceManager.

Vyberte skupinu prostředků Azure.

kubernetesCluster - Cluster Kubernetes
string. Vyžaduje se, když action != bake && connectionType = azureResourceManager.

Vyberte spravovaný cluster Azure.

useClusterAdmin - Použití přihlašovacích údajů správce clusteru
boolean. Nepovinný parametr. Použijte, když connectionType = azureResourceManager. Výchozí hodnota: false.

Místo výchozích přihlašovacích údajů uživatele clusteru použijte přihlašovací údaje správce clusteru.

namespace - Obor názvů
string.

Určuje obor názvů pro příkazy pomocí příznaku –namespace . Pokud obor názvů není zadaný, příkazy se spustí ve výchozím oboru názvů.

strategy - Strategie
string. Nepovinný parametr. Použijte, když action = deploy || action = promote || action = reject. Povolené hodnoty: canary, none. Výchozí hodnota: none.

Určuje strategii nasazení použitou v deploy akci před promote akcí nebo reject akcí. canary V současné době je jedinou přijatelnou strategií nasazení.

trafficSplitMethod - Metoda rozdělení provozu
string. Nepovinný parametr. Použijte, když strategy = canary. Povolené hodnoty: pod, smi. Výchozí hodnota: pod.

V případě hodnoty smise procento rozdělení provozu provádí na úrovni požadavku pomocí sítě služeb. Síť služeb musí nastavit správce clusteru. Tato úloha zpracovává orchestraci objektů SMI TrafficSplit .

Pro hodnotu podnení možné procento rozdělení na úrovni požadavku, pokud chybí síť služeb. Místo toho se procentuální vstup používá k výpočtu replik pro směrný plán a kanárky. Výpočet je procento replik zadaných ve vstupních manifestech pro stabilní variantu.

percentage - Procento
string. Vyžaduje se, když strategy = Canary && action = deploy. Výchozí hodnota: 0.

Procento, které se použije k výpočtu počtu replik standardních a kanárových variant úloh obsažených v souborech manifestu.

Pro zadaný procentuální vstup vypočítejte:

(procento × počet replik) / 100

Pokud výsledek není celé číslo, použije se při vytváření standardních a kanárových variant matematická podlaha výsledku.

Předpokládejme například, že nasazení hello-world je ve vstupním souboru manifestu a že následující řádky jsou ve vstupu úkolu:

replicas: 4
strategy: canary
percentage: 25

V tomto případě se nasazení hello-world-baseline a hello-world-canary vytvoří s jednou replikou. Základní varianta se vytvoří se stejnou imagí a značkou jako stabilní verze, což je varianta se čtyřmi replikami před nasazením. Vytvoří se kanárová varianta s imagí a značkou, které odpovídají nově nasazeným změnám.

baselineAndCanaryReplicas - Repliky standardních hodnot a repliky kanárů
string. Vyžaduje se, když strategy = Canary && action = deploy && trafficSplitMethod = SMI. Výchozí hodnota: 1.

Když nastavíte trafficSplitMethod na smi, procento rozdělení provozu se řídí v rovině sítě služby. Skutečný počet replik pro kanárové a standardní varianty můžete řídit nezávisle na rozdělení provozu.

Předpokládejme například, že vstupní manifest nasazení určuje 30 replik pro stabilní variantu. Také předpokládejme, že pro úkol zadáte následující vstup:

strategy: canary
trafficSplitMethod: smi
percentage: 20
baselineAndCanaryReplicas: 1

V tomto případě stabilní varianta přijímá 80 % provozu, zatímco základní a kanárské varianty obdrží polovinu ze zadaných 20 %. Standardní a kanárové varianty nedostávají po každé tři repliky. Místo toho obdrží zadaný počet replik, což znamená, že každá z nich obdrží jednu repliku.

manifests - Manifesty
string. Vyžaduje se, když action = deploy || action = promote || action = reject.

Určuje cestu k souborům manifestu, které se mají použít k nasazení. Každý řádek představuje jednu cestu. Vzor porovnávání souborů je přijatelná hodnota pro každý řádek.

containers - Kontejnery
string. Nepovinný parametr. Použijte, když action = deploy || action = promote || action = bake.

Určuje plně kvalifikovanou adresu URL prostředku obrázku, která se má použít k nahrazení souborů manifestu. Příkladem je adresa URL contosodemo.azurecr.io/helloworld:test .

imagePullSecrets - ImagePullSecrets
string. Nepovinný parametr. Použijte, když action = deploy || action = promote.

Určuje víceřádkový vstup, kde každý řádek obsahuje název tajného klíče registru Dockeru, který už byl v clusteru nastavený. Každý název tajného kódu se přidá pod imagePullSecrets pro úlohy, které se nacházejí ve vstupních souborech manifestu.

renderType - Vykreslovací modul
string. Nepovinný parametr. Použijte, když action = bake. Povolené hodnoty: helm, kompose, kustomize. Výchozí hodnota: helm.

Určuje typ vykreslování použitý k vytvoření souborů manifestu.

dockerComposeFile - Cesta k souboru docker compose
string. Vyžaduje se, když action = bake && renderType = kompose.

Určuje cestu k souboru docker-compose.

helmChart - Helm Chart
string. Vyžaduje se, když action = bake && renderType = helm.

Určuje cestu chartu Helm, která se má upéct.

releaseName - Název verze Helm
string. Nepovinný parametr. Použijte, když action = bake && renderType = helm.

Určuje název verze Helm, který se má použít.

overrideFiles - Přepsat soubory
string. Nepovinný parametr. Použijte, když action = bake && renderType = helm.

Určuje víceřádkový vstup, který přijímá cestu k souborům přepsání. Soubory se používají při pečení souborů manifestu z chartů Helm.

overrides - Přepisuje
string. Nepovinný parametr. Použijte, když action = bake && renderType = helm.

Určuje hodnoty přepsání, které se mají nastavit.

kustomizationPath - Cesta kustomizace
string. Nepovinný parametr. Použijte, když action = bake && renderType = kustomize.

Určuje argument, který musí být cesta k adresáři obsahujícímu soubor, nebo adresa URL úložiště Git s příponou cesty určenou same s ohledem na kořen úložiště.

resourceToPatch - Prostředek k opravě
string. Vyžaduje se, když action = patch. Povolené hodnoty: file, name. Výchozí hodnota: file.

Označuje jednu z následujících metod opravy:

• Soubor manifestu identifikuje objekty, které mají být opraveny.
• Jednotlivé objekty jsou identifikované podle druhu a názvu jako cíl opravy.

Přijatelné hodnoty jsou soubor a název.

resourceFileToPatch - Cesta k souboru
string. Vyžaduje se, když action = patch && resourceToPatch = file.

Určuje cestu k souboru použitému pro opravu.

kind - Druhu
string. Vyžaduje se, když action = scale || resourceToPatch = name. Povolené hodnoty: deployment, replicaset, statefulset.

Určuje typ objektu K8s, například deployment, replicaSet a další.

name - Jméno
string. Vyžaduje se, když action = scale || resourceToPatch = name.

Určuje název objektu K8s.

replicas - Počet replik
string. Vyžaduje se, když action = scale.

Určuje počet replik, na které se má škálovat.

replicas - Počet replik
string. Vyžaduje se, když action = scale.

Určuje název objektu K8s.

mergeStrategy - Strategie sloučení
string. Vyžaduje se, když action = patch. Povolené hodnoty: json, merge, strategic. Výchozí hodnota: strategic.

Určuje typ poskytované opravy.

arguments - Argumenty
string. Nepovinný parametr. Použijte, když action = delete.

Určuje argumenty příkazu kubectl delete . Příklad: arguments: deployment hello-world foo-bar

patch - Oprava
string. Vyžaduje se, když action = patch.

Určuje obsah opravy.

secretType - Typ tajného kódu
string. Vyžaduje se, když action = createSecret. Povolené hodnoty: dockerRegistry, generic. Výchozí hodnota: dockerRegistry.

Vytvoří nebo aktualizuje obecný nebo docker imagepullsecret. Zadejte dockerRegistry pro vytvoření nebo aktualizaci imagepullsecret vybraného registru. Je imagePullSecret způsob, jak kubeletu předat tajný klíč, který obsahuje heslo registru kontejneru, aby mohl jménem vašeho podu vyžádat soukromou image.

secretName - Název tajného kódu
string. Nepovinný parametr. Použijte, když action = createSecret.

Určuje název tajného kódu. Tento název tajného kódu můžete použít v konfiguračním souboru Kubernetes YAML.

secretArguments - Argumenty
string. Nepovinný parametr. Použijte, když action = createSecret && secretType = generic.

Určuje klíče a hodnoty literálů, které se mají vložit do tajného klíče. Příklad --from-literal=key1=value1--from-literal=key2="top secret": .

dockerRegistryEndpoint - Připojení služby registru Dockeru
string. Nepovinný parametr. Použijte, když action = createSecret && secretType = dockerRegistry.

Určuje přihlašovací údaje zadaného připojení služby, které se použijí k vytvoření tajného klíče registru Dockeru v clusteru. Soubory manifestu pod polem imagePullSecrets pak můžou odkazovat na název tohoto tajného kódu.

rolloutStatusTimeout - Vypršení časového limitu stavu uvedení
string. Nepovinný parametr. Použijte, když action = deploy || action = patch || action = scale || action = promote. Výchozí hodnota: 0.

Určuje dobu čekání (v sekundách) před ukončením watch on rollout stavu.

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

manifestsBundle
Umístění balíčků manifestů vytvořených akcí bake