Share via


Kubernetes@0 - Kubectl v0-taak

Gebruik deze taak om een Kubernetes-cluster in Azure Container Service te implementeren, configureren of bij te werken door opdrachten uit te voeren kubectl .

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.

Invoerwaarden

kubernetesServiceConnection - Kubernetes-serviceverbinding
Invoeralias: kubernetesServiceEndpoint. string.

Selecteer een Kubernetes-serviceverbinding.


namespace - Naamruimte
string.

Hiermee geeft u de naamruimte voor de kubectl opdracht met behulp van de –namespace vlag. Als de naamruimte niet is opgegeven, worden de opdrachten uitgevoerd in de standaardnaamruimte.


command - Opdracht
string. Toegestane waarden: apply, create, delete, exec, expose, get, , logs, runset, top.

Hiermee geeft u een kubectl opdracht om uit te voeren.


command - Opdracht
string. Vereist. Toegestane waarden: apply, create, delete, exec, expose, get, , logs, runset, top. Standaardwaarde: apply.

Hiermee geeft u een kubectl opdracht om uit te voeren.


useConfigurationFile - Configuratiebestanden gebruiken
boolean. Standaardwaarde: false.

Gebruik het Kubernetes-configuratiebestand met de opdracht kubectl. Bestandsnaam, map of URL naar Kubernetes-configuratiebestanden kunnen ook worden opgegeven.


configuration - Configuratiebestand
string. Vereist wanneer useConfigurationFile = true.

Hiermee geeft u de bestandsnaam, map of URL naar kubernetes-configuratiebestanden die wordt gebruikt met de opdrachten.


arguments - Argumenten
string.

Hiermee geeft u de argumenten voor de opgegeven kubectl opdracht.


secretType - Type geheim
string. Vereist. Toegestane waarden: dockerRegistry, generic. Standaardwaarde: dockerRegistry.

Hiermee maakt of werkt u een algemene of docker imagepullsecretbij. Geef op dockerRegistry om het van het imagepullsecret geselecteerde register te maken of bij te werken. Een imagePullSecret is een manier om een geheim met een containerregisterwachtwoord door te geven aan de Kubelet, zodat deze een persoonlijke installatiekopie namens uw pod kan ophalen.


secretArguments - Argumenten
string. Optioneel. Gebruik wanneer secretType = generic.

Hiermee geeft u sleutels en letterlijke waarden in het geheim in. Bijvoorbeeld --from-literal=key1=value1 of --from-literal=key2="top secret".


containerRegistryType - Type containerregister
string. Vereist wanneer secretType = dockerRegistry. Toegestane waarden: Azure Container Registry, Container Registry. Standaardwaarde: Azure Container Registry.

Selecteer een type containerregister. De taak kan azure-abonnementsgegevens gebruiken om te werken met een Azure-containerregister. Andere standaardcontainerregisters worden ook ondersteund.


dockerRegistryConnection - Verbinding met Docker Registry-service
Invoeralias: dockerRegistryEndpoint. string. Optioneel. Gebruik wanneer secretType = dockerRegistry && containerRegistryType = Container Registry.

Selecteer een verbinding met de Docker-registerservice. Vereist voor opdrachten die moeten worden geverifieerd met een register.


azureSubscription - Azure-abonnement
Invoeralias: azureSubscriptionEndpoint. string. Optioneel. Gebruik wanneer secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Hiermee geeft u het Azure Resource Manager-abonnement op, dat Azure Container Registry bevat.

Notitie

Als u een nieuwe serviceverbinding wilt configureren, selecteert u het Azure-abonnement in de lijst en klikt u op Authorize. Als uw abonnement niet wordt vermeld of als u een bestaande service-principal wilt gebruiken, kunt u een Azure-serviceverbinding instellen met behulp van de Add knoppen of Manage .


azureContainerRegistry - Azure Container Registry
string. Optioneel. Gebruik wanneer secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Hiermee geeft u een Azure Container Registry die wordt gebruikt voor het ophalen van containerinstallatiekopieën en het implementeren van toepassingen in het Kubernetes-cluster. Vereist voor opdrachten die moeten worden geverifieerd met een register.


secretName - Geheime naam
string.

Naam van het geheim. U kunt deze geheime naam gebruiken in het Kubernetes YAML-configuratiebestand.


forceUpdate - Updategeheim forceren
boolean. Standaardwaarde: true.

Verwijder het geheim als dit bestaat en maak een nieuw geheim met bijgewerkte waarden.


configMapName - Naam van ConfigMap
string.

Met ConfigMaps kunt u configuratieartefacten loskoppelen van afbeeldingsinhoud om containertoepassingen draagbaar te houden.


forceUpdateConfigMap - Configuratiekaart voor bijwerken afdwingen
boolean. Standaardwaarde: false.

Verwijder de configmap als deze bestaat en maak een nieuwe met bijgewerkte waarden.


useConfigMapFile - Bestand gebruiken
boolean. Standaardwaarde: false.

Maak een ConfigMap op basis van een afzonderlijk bestand of van meerdere bestanden door een map op te geven.


configMapFile - ConfigMap-bestand
string. Vereist wanneer useConfigMapFile = true.

Geef een bestand of map op die de configMaps bevat.


configMapArguments - Argumenten
string. Optioneel. Gebruik wanneer useConfigMapFile = false.

Hiermee geeft u sleutels en letterlijke waarden op die moeten worden ingevoegd in configMap . Bijvoorbeeld --from-literal=key1=value1--from-literal=key2="top secret"of .


versionOrLocation - Kubectl
string. Toegestane waarden: version, location (Locatie opgeven). Standaardwaarde: version.

kubectl is een opdrachtregelinterface voor het uitvoeren van opdrachten op Kubernetes-clusters.


versionSpec - Versiespecificatie
string. Optioneel. Gebruik wanneer versionOrLocation = version. Standaardwaarde: 1.7.0.

Hiermee geeft u de versiespecificatie van de versie op te halen. Voorbeelden: 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0


checkLatest - Controleren op de nieuwste versie
boolean. Optioneel. Gebruik wanneer versionOrLocation = version. Standaardwaarde: false.

Controleer altijd online op de meest recente beschikbare versie (stable.txt) die voldoet aan de versiespecificatie. Dit is meestal onwaar, tenzij u een specifiek scenario hebt om altijd de meest recente versie te krijgen. Dit zorgt ervoor dat er downloadkosten in rekening worden gebracht wanneer dit mogelijk niet nodig is, met name met de gehoste buildgroep.


specifyLocation - Pad naar Kubectl
string. Vereist wanneer versionOrLocation = location.

Hiermee geeft u het volledige pad naar het kubectl.exe bestand.


workingDirectory - Werkmap
Invoeralias: cwd. string. Standaardwaarde: $(System.DefaultWorkingDirectory).

Werkmap voor de Kubectl-opdracht.


outputFormat - Uitvoerindeling
string. Toegestane waarden: json, yaml. Standaardwaarde: json.

Uitvoerindeling.


kubectlOutput - Naam van uitvoervariabele
string.

Naam van de variabele waarin de uitvoer van de opdracht moet worden opgeslagen.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie Alle ondersteunde agentversies.
Taakcategorie Implementeren