Kubernetes@0 – úloha Kubectl v0

Pomocí této úlohy můžete nasadit, nakonfigurovat nebo aktualizovat cluster Kubernetes ve službě Azure Container Service spuštěním kubectl příkazů.

Syntax

# Kubectl v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
  inputs:
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection. 
    #namespace: # string. Namespace. 
  # Commands
    #command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Command. 
    #useConfigurationFile: false # boolean. Use Configuration files. Default: false.
    #configuration: # string. Required when useConfigurationFile = true. Configuration file. 
    #arguments: # string. Arguments. 
  # Secrets
    secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
    #secretArguments: # string. Optional. Use when secretType = generic. Arguments. 
    containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry. 
    #secretName: # string. Secret name. 
    #forceUpdate: true # boolean. Force update secret. Default: true.
  # ConfigMaps
    #configMapName: # string. ConfigMap name. 
    #forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
    #useConfigMapFile: false # boolean. Use file. Default: false.
    #configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file. 
    #configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments. 
  # Advanced
    #versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
    #versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
    #checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
    #specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl. 
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
  # Output
    #outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
    #kubectlOutput: # string. Output variable name.

Vstupy

kubernetesServiceConnection - Připojení ke službě Kubernetes
Alias vstupu: kubernetesServiceEndpoint. string.

Vyberte připojení ke službě Kubernetes.

namespace - Obor názvů
string.

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

command - Příkaz
string. Povolené hodnoty: apply, create, , execdelete, expose, get, , logs, run, , set. top

Určuje příkaz, který kubectl se má spustit.

useConfigurationFile - Použití konfiguračních souborů
boolean. Výchozí hodnota: false.

Použijte konfigurační soubor Kubernetes s příkazem kubectl. Můžete také zadat název souboru, adresář nebo adresu URL konfiguračních souborů Kubernetes.

configuration - Konfigurační soubor
string. Vyžaduje se, když useConfigurationFile = true.

Určuje název souboru, adresář nebo adresu URL konfiguračních souborů Kubernetes, které se používají s příkazy.

arguments - Argumenty
string.

Určuje argumenty zadaného kubectl příkazu.

secretType - Typ tajného kódu
string. Povinná hodnota. 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.

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

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

containerRegistryType - Typ registru kontejneru
string. Vyžaduje se, když secretType = dockerRegistry. Povolené hodnoty: Azure Container Registry, Container Registry. Výchozí hodnota: Azure Container Registry.

Vyberte typ registru kontejneru. Úloha může použít podrobnosti o předplatném Azure pro práci s registrem kontejneru Azure. Podporují se také další standardní registry kontejnerů.

dockerRegistryConnection - Připojení ke službě Docker Registry
Alias vstupu: dockerRegistryEndpoint. string. Nepovinný parametr. Použijte, když secretType = dockerRegistry && containerRegistryType = Container Registry.

Vyberte připojení služby registru Dockeru. Vyžaduje se pro příkazy, které potřebují ověření v registru.

azureSubscription - Předplatné Azure
Alias vstupu: azureSubscriptionEndpoint. string. Nepovinný parametr. Použijte, když secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Určuje 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 Authorize. 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í Add tlačítek nebo Manage .

azureContainerRegistry - Azure Container Registry
string. Nepovinný parametr. Použijte, když secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Určuje Azure Container Registry, která se používá k načítání imagí kontejnerů a nasazování aplikací do clusteru Kubernetes. Vyžaduje se pro příkazy, které potřebují ověření v registru.

secretName - Název tajného kódu
string.

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

forceUpdate - Vynutit aktualizaci tajného kódu
boolean. Výchozí hodnota: true.

Odstraňte tajný kód, pokud existuje, a vytvořte nový s aktualizovanými hodnotami.

configMapName - Název objektu ConfigMap
string.

Objekty ConfigMap umožňují oddělit artefakty konfigurace od obsahu obrázků, aby byly kontejnerizované aplikace přenosné.

forceUpdateConfigMap - Vynutit aktualizaci mapy konfigurace
boolean. Výchozí hodnota: false.

Odstraňte mapu configmap, pokud existuje, a vytvořte novou s aktualizovanými hodnotami.

useConfigMapFile - Použít soubor
boolean. Výchozí hodnota: false.

Vytvořte objekt ConfigMap z jednotlivého souboru nebo z více souborů zadáním adresáře.

configMapFile - Soubor ConfigMap
string. Vyžaduje se, když useConfigMapFile = true.

Zadejte soubor nebo adresář, který obsahuje objekty configMap.

configMapArguments - Argumenty
string. Nepovinný parametr. Použijte, když useConfigMapFile = false.

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

versionOrLocation - Kubectl
string. Povolené hodnoty: version, location (Zadejte umístění). Výchozí hodnota: version.

kubectl je rozhraní příkazového řádku pro spouštění příkazů v clusterech Kubernetes.

versionSpec - Specifikace verze
string. Nepovinný parametr. Použijte, když versionOrLocation = version. Výchozí hodnota: 1.7.0.

Určuje specifikaci verze, která se má získat. Příklady: 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0

checkLatest - Vyhledat nejnovější verzi
boolean. Nepovinný parametr. Použijte, když versionOrLocation = version. Výchozí hodnota: false.

Vždy online zkontroluje nejnovější dostupnou verzi (stable.txt), která splňuje specifikaci verze. To je obvykle nepravda, pokud nemáte konkrétní scénář, abyste vždy získali nejnovější verzi. To způsobí, že v případě, že to není nutné, účtují se náklady na stahování, zejména u hostovaného fondu buildů.

specifyLocation - Cesta ke Kubectl
string. Vyžaduje se, když versionOrLocation = location.

Určuje úplnou cestu k kubectl.exe souboru.

workingDirectory - Pracovní adresář
Vstupní alias: cwd. string. Výchozí hodnota: $(System.DefaultWorkingDirectory).

Pracovní adresář pro příkaz Kubectl.

outputFormat - Formát výstupu
string. Povolené hodnoty: json, yaml. Výchozí hodnota: json.

Výstupní formát.

kubectlOutput - Název výstupní proměnné
string.

Název proměnné, ve které má být uložen výstup příkazu.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Nasazení