Kubernetes@0 – Kubectl v0-Aufgabe

Verwenden Sie diese Aufgabe, um einen Kubernetes-Cluster in Azure Container Service bereitzustellen, zu konfigurieren oder zu aktualisieren, indem Sie Befehle ausführen 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.

Eingaben

kubernetesServiceConnection - Kubernetes-Dienstverbindung
Eingabealias: kubernetesServiceEndpoint. string.

Wählen Sie eine Kubernetes-Dienstverbindung aus.

namespace - Namespace
string.

Gibt den Namespace für den kubectl Befehl mithilfe des Flags –namespace an. Wenn der Namespace nicht bereitgestellt wird, werden die Befehle im Standardnamespace ausgeführt.

command - Befehl
string. Zulässige Werte: apply, create, delete, exposeexec, , logsget, runset, top.

Gibt einen kubectl auszuführenden Befehl an.

useConfigurationFile - Verwenden von Konfigurationsdateien
boolean. Standardwert. false.

Verwenden Sie die Kubernetes-Konfigurationsdatei mit dem Befehl kubectl. Dateiname, Verzeichnis oder URL für Kubernetes-Konfigurationsdateien können ebenfalls bereitgestellt werden.

configuration - Konfigurationsdatei
string. Erforderlich, wenn useConfigurationFile = true.

Gibt den Dateinamen, das Verzeichnis oder die URL für kubernetes-Konfigurationsdateien an, die mit den Befehlen verwendet werden.

arguments - Argumente
string.

Gibt die Argumente für den angegebenen kubectl Befehl an.

secretType - Typ des Geheimnisses
string. Erforderlich. Zulässige Werte: dockerRegistry, generic. Standardwert. dockerRegistry.

Erstellt oder aktualisiert ein generisches oder docker imagepullsecret. Geben Sie an dockerRegistry , um die imagepullsecret der ausgewählten Registrierung zu erstellen oder zu aktualisieren. Ein imagePullSecret ist eine Möglichkeit, ein Geheimnis, das ein Containerregistrierungskennwort enthält, an das Kubelet zu übergeben, damit ein privates Image im Namen Ihres Pods abgerufen werden kann.

secretArguments - Argumente
string. Optional. Verwenden Sie , wenn secretType = generic.

Gibt Schlüssel und Literalwerte an, die im Geheimnis eingefügt werden sollen. Zum Beispiel: --from-literal=key1=value1 oder --from-literal=key2="top secret".

containerRegistryType - Containerregistrierungstyp
string. Erforderlich, wenn secretType = dockerRegistry. Zulässige Werte: Azure Container Registry, Container Registry. Standardwert. Azure Container Registry.

Wählen Sie einen Containerregistrierungstyp aus. Die Aufgabe kann Azure-Abonnementdetails verwenden, um mit einer Azure Container Registry-Instanz zu arbeiten. Andere Standardmäßige Containerregistrierungen werden ebenfalls unterstützt.

dockerRegistryConnection - Docker-Registrierungsdienstverbindung
Eingabealias: dockerRegistryEndpoint. string. Optional. Verwenden Sie , wenn secretType = dockerRegistry && containerRegistryType = Container Registry.

Wählen Sie eine Docker-Registrierungsdienstverbindung aus. Erforderlich für Befehle, die bei einer Registrierung authentifiziert werden müssen.

azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Optional. Verwenden Sie , wenn secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Gibt das Azure Resource Manager-Abonnement an, das Azure Container Registry enthält.

Hinweis

Wählen Sie zum Konfigurieren einer neuen Dienstverbindung das Azure-Abonnement aus der Liste aus, und klicken Sie auf Authorize. Wenn Ihr Abonnement nicht aufgeführt ist oder Sie einen vorhandenen Dienstprinzipal verwenden möchten, können Sie eine Azure-Dienstverbindung über die Add Schaltflächen oder Manage einrichten.

azureContainerRegistry - Azure Container Registry
string. Optional. Verwenden Sie , wenn secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Gibt einen Azure Container Registry an, der zum Pullen von Containerimages und bereitstellen von Anwendungen im Kubernetes-Cluster verwendet wird. Erforderlich für Befehle, die bei einer Registrierung authentifiziert werden müssen.

secretName - Geheimnisname
string.

Name des Geheimnisses. Sie können diesen Geheimnisnamen in der Kubernetes-YAML-Konfigurationsdatei verwenden.

forceUpdate - Erzwingen des Geheimen Geheimniss
boolean. Standardwert. true.

Löschen Sie das Geheimnis, falls vorhanden, und erstellen Sie ein neues Geheimnis mit aktualisierten Werten.

configMapName - ConfigMap-Name
string.

Mit ConfigMaps können Sie Konfigurationsartefakte vom Imageinhalt entkoppeln, um containerisierte Anwendungen portierbar zu halten.

forceUpdateConfigMap - Erzwingen der Updatekonfigurationszuordnung
boolean. Standardwert. false.

Löschen Sie die Configmap, sofern vorhanden, und erstellen Sie eine neue mit aktualisierten Werten.

useConfigMapFile - Verwenden der Datei
boolean. Standardwert. false.

Erstellen Sie eine ConfigMap aus einer einzelnen Datei oder aus mehreren Dateien, indem Sie ein Verzeichnis angeben.

configMapFile - ConfigMap-Datei
string. Erforderlich, wenn useConfigMapFile = true.

Geben Sie eine Datei oder ein Verzeichnis an, das die configMaps enthält.

configMapArguments - Argumente
string. Optional. Verwenden Sie , wenn useConfigMapFile = false.

Gibt Schlüssel und Literalwerte an, die in configMap eingefügt werden sollen. Beispiel: --from-literal=key1=value1 oder --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Zulässige Werte: version, location (Speicherort angeben). Standardwert. version.

kubectl ist eine Befehlszeilenschnittstelle zum Ausführen von Befehlen für Kubernetes-Cluster.

versionSpec - Versionsspezifikation
string. Optional. Verwenden Sie , wenn versionOrLocation = version. Standardwert. 1.7.0.

Gibt die Versionsspezifikation der abzurufenden Version an. Beispiele: 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0

checkLatest - Überprüfen der neuesten Version
boolean. Optional. Verwenden Sie , wenn versionOrLocation = version. Standardwert. false.

Sucht immer online nach der neuesten verfügbaren Version (stable.txt), die die Versionsspezifikation erfüllt. Dies ist in der Regel false, es sei denn, Sie haben ein bestimmtes Szenario, um immer den neuesten Stand zu erhalten. Dies führt zu Downloadkosten, wenn es möglicherweise nicht erforderlich ist, insbesondere beim gehosteten Buildpool.

specifyLocation - Pfad zu Kubectl
string. Erforderlich, wenn versionOrLocation = location.

Gibt den vollständigen Pfad zur Datei an kubectl.exe .

workingDirectory - Arbeitsverzeichnis
Eingabealias: cwd. string. Standardwert. $(System.DefaultWorkingDirectory).

Arbeitsverzeichnis für den Kubectl-Befehl.

outputFormat - Ausgabeformat
string. Zulässige Werte: json, yaml. Standardwert. json.

Ausgabeformat.

kubectlOutput - Name der Ausgabevariablen
string.

Name der Variablen, in der die Ausgabe des Befehls gespeichert werden soll.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Bereitstellen