Kubernetes@0 – Kubectl v0-uppgift

Artikel
07/02/2024

Använd den här uppgiften för att distribuera, konfigurera eller uppdatera ett Kubernetes-kluster i Azure Container Service genom att köra kubectl kommandon.

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.

# Deploy to Kubernetes 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.

# Deploy to Kubernetes v0
# Deploy, configure, update your 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' # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Required. Command. Default: apply.
    #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.

Indata

kubernetesServiceConnection - Kubernetes-tjänstanslutning
Indataalias: kubernetesServiceEndpoint. string.

Välj en Kubernetes-tjänstanslutning.

namespace - Namnområde
string.

Anger namnområdet för kubectl kommandot med hjälp –namespace av flaggan . Om namnområdet inte anges körs kommandona i standardnamnområdet.

command - Kommandot
string. Tillåtna värden: apply, create, delete, exec, expose, get, runlogs, , topset.

Anger ett kubectl kommando som ska köras.

command - Kommandot
string. Krävs. Tillåtna värden: apply, create, delete, exec, expose, get, runlogs, , topset. Standardvärde: apply.

Anger ett kubectl kommando som ska köras.

useConfigurationFile - Använda konfigurationsfiler
boolean. Standardvärde: false.

Använd Kubernetes-konfigurationsfilen med kommandot kubectl. Filnamn, katalog eller URL till Kubernetes-konfigurationsfiler kan också anges.

configuration - Konfigurationsfil
string. Krävs när useConfigurationFile = true.

Anger filnamn, katalog eller URL till kubernetes-konfigurationsfiler som används med kommandona.

arguments - Argument
string.

Anger argumenten för det angivna kubectl kommandot.

secretType - Typ av hemlighet
string. Krävs. Tillåtna värden: dockerRegistry, generic. Standardvärde: dockerRegistry.

Skapar eller uppdaterar en allmän eller docker imagepullsecret. Ange dockerRegistry för att skapa eller uppdatera det imagepullsecret valda registret. Ett imagePullSecret är ett sätt att skicka en hemlighet som innehåller ett containerregisterlösenord till Kubelet, så att den kan hämta en privat avbildning för poddens räkning.

secretArguments - Argument
string. Valfritt. Använd när secretType = generic.

Anger nycklar och literalvärden som ska infogas i hemlighet. Exempel: --from-literal=key1=value1 eller --from-literal=key2="top secret".

containerRegistryType - Typ av containerregister
string. Krävs när secretType = dockerRegistry. Tillåtna värden: Azure Container Registry, Container Registry. Standardvärde: Azure Container Registry.

Välj en containerregistertyp. Uppgiften kan använda Azure-prenumerationsinformation för att arbeta med ett Azure Container-register. Andra standardregister för containrar stöds också.

dockerRegistryConnection - Docker Registry-tjänstanslutning
Indataalias: dockerRegistryEndpoint. string. Valfritt. Använd när secretType = dockerRegistry && containerRegistryType = Container Registry.

Välj en Docker-registertjänstanslutning. Krävs för kommandon som behöver autentiseras med ett register.

azureSubscription - Azure-prenumeration
Indataalias: azureSubscriptionEndpoint. string. Valfritt. Använd när secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Anger Azure Resource Manager-prenumerationen, som innehåller Azure Container Registry.

Anteckning

Om du vill konfigurera en ny tjänstanslutning väljer du Azure-prenumerationen i listan och klickar på Authorize. Om din prenumeration inte visas eller om du vill använda ett befintligt tjänsthuvudnamn kan du konfigurera en Azure-tjänstanslutning med hjälp av knapparna Add eller Manage .

azureContainerRegistry - Azure Container Registry
string. Valfritt. Använd när secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Anger en Azure Container Registry som används för att hämta containeravbildningar och distribuera program till Kubernetes-klustret. Krävs för kommandon som behöver autentiseras med ett register.

secretName - Hemligt namn
string.

Namnet på hemligheten. Du kan använda det här hemliga namnet i Kubernetes YAML-konfigurationsfilen.

forceUpdate - Framtvinga uppdateringshemlighet
boolean. Standardvärde: true.

Ta bort hemligheten om den finns och skapa en ny med uppdaterade värden.

configMapName - ConfigMap-namn
string.

Med ConfigMaps kan du frikoppla konfigurationsartefakter från bildinnehåll för att hålla containerbaserade program portabla.

forceUpdateConfigMap - Framtvinga uppdateringskonfiguration
boolean. Standardvärde: false.

Ta bort konfigurationskartan om den finns och skapa en ny med uppdaterade värden.

useConfigMapFile - Använd fil
boolean. Standardvärde: false.

Skapa en ConfigMap från en enskild fil eller från flera filer genom att ange en katalog.

configMapFile - ConfigMap-fil
string. Krävs när useConfigMapFile = true.

Ange en fil eller katalog som innehåller configMaps.

configMapArguments - Argument
string. Valfritt. Använd när useConfigMapFile = false.

Anger nycklar och literalvärden som ska infogas i configMap . Till exempel eller --from-literal=key1=value1--from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Tillåtna värden: version, location (Ange plats). Standardvärde: version.

kubectl är ett kommandoradsgränssnitt för att köra kommandon mot Kubernetes-kluster.

versionSpec - Versionsspecifikation
string. Valfritt. Använd när versionOrLocation = version. Standardvärde: 1.7.0.

Anger versionsspecifikationen för den version som ska hämtas. Exempel: 1.7.0, 1.x.0, 4.x.0, 6.10.0, >=6.10.0.

checkLatest - Sök efter den senaste versionen
boolean. Valfritt. Använd när versionOrLocation = version. Standardvärde: false.

Söker alltid online efter den senaste tillgängliga versionen (stable.txt) som uppfyller versionsspecifikationen. Detta är vanligtvis falskt om du inte har ett specifikt scenario för att alltid få den senaste. Detta medför nedladdningskostnader när det eventuellt inte är nödvändigt, särskilt med den värdbaserade byggpoolen.

specifyLocation - Sökväg till Kubectl
string. Krävs när versionOrLocation = location.

Anger den fullständiga sökvägen till kubectl.exe filen.

workingDirectory - Arbetskatalog
Indataalias: cwd. string. Standardvärde: $(System.DefaultWorkingDirectory).

Arbetskatalog för Kubectl-kommandot.

outputFormat - Utdataformat
string. Tillåtna värden: json, yaml. Standardvärde: json.

Utdataformat.

kubectlOutput - Namn på utdatavariabel
string.

Namnet på variabeln där kommandots utdata ska sparas.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Distribuera

Dela via