Kubernetes@0 – Kubectl v0-Vorgang

Verwenden Sie diese Aufgabe, um einen Kubernetes-Cluster im Azure-Containerdienst bereitzustellen, zu konfigurieren oder zu aktualisieren, indem Sie kubectl Befehle ausführen.

Diese Version der Aufgabe ist veraltet; verwenden Sie Kubernetes@1, um die neuesten Features wie Workload Identity Federationzu nutzen.

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.

Eingänge

kubernetesServiceConnection - Kubernetes-Dienstverbindung
Eingabealias: kubernetesServiceEndpoint. string.

Wählen Sie eine Kubernetes-Dienstverbindung aus.

namespace - Namespace-
string.

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

command - Befehl
string. Zulässige Werte: apply, create, delete, exec, expose, get, logs, run, set, top.

Gibt einen auszuführenden kubectl Befehl an.

useConfigurationFile - Verwenden von Konfigurationsdateien
boolean. Standardwert: false.

Verwenden Sie die Kubernetes-Konfigurationsdatei mit dem Kubectl-Befehl. Dateiname, Verzeichnis oder URL zu 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 - Geheimschlüsseltyp
string. Erforderlich. Zulässige Werte: dockerRegistry, generic. Standardwert: dockerRegistry.

Erstellt oder aktualisiert ein generisches oder Docker-imagepullsecret. Geben Sie dockerRegistry an, um die imagepullsecret der ausgewählten Registrierung zu erstellen oder zu aktualisieren. Ein imagePullSecret ist eine Möglichkeit, einen geheimen Schlüssel zu übergeben, der ein Containerregistrierungskennwort an das Kubelet enthält, damit es ein privates Image im Namen Ihres Pods abrufen kann.

secretArguments - Argumente
string. Wahlfrei. Wird verwendet, wenn secretType = generic.

Gibt Schlüssel und Literalwerte an, die in einen geheimen Schlüssel eingefügt werden sollen. 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-Registrierung zu arbeiten. Andere Standardmäßige Containerregistrierungen werden ebenfalls unterstützt.

dockerRegistryConnection - Docker-Registrierungsdienstverbindung
Eingabealias: dockerRegistryEndpoint. string. Wahlfrei. Wird verwendet, wenn secretType = dockerRegistry && containerRegistryType = Container Registry.

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

azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Wahlfrei. Wird verwendet, wenn secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

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

Hinweis

Um eine neue Dienstverbindung zu konfigurieren, wählen Sie 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 mit den Schaltflächen Add oder Manage einrichten.

azureContainerRegistry - Azure Container Registry
string. Wahlfrei. Wird verwendet, wenn secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Gibt eine Azure-Containerregistrierung an, die zum Abrufen von Containerimages und zum Bereitstellen von Anwendungen im Kubernetes-Cluster verwendet wird. Erforderlich für Befehle, die sich bei einer Registrierung authentifizieren müssen.

secretName - Geheimer Name
string.

Der Name des geheimen Schlüssels. Sie können diesen geheimen Namen in der YaML-Konfigurationsdatei Kubernetes verwenden.

forceUpdate - geheimen Updateschlüssel erzwingen
boolean. Standardwert: true.

Löschen Sie den geheimen Schlüssel, wenn er vorhanden ist, und erstellen Sie eine neue mit aktualisierten Werten.

configMapName - ConfigMap-Name
string.

Mit ConfigMaps können Sie Konfigurationsartefakte von Bildinhalten decoupieren, um containerisierte Anwendungen portierbar zu halten.

forceUpdateConfigMap - "Updatekonfiguration erzwingen"
boolean. Standardwert: false.

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

useConfigMapFile - Datei- verwenden
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, die die configMaps enthält.

configMapArguments - Argumente
string. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, wenn versionOrLocation = version. Standardwert: false.

Sucht immer online nach der neuesten verfügbaren Version (stable.txt), die der Versionsspezifikation entspricht. Dies ist in der Regel "false", es sei denn, Sie haben ein bestimmtes Szenario, um immer den neuesten Stand zu erhalten. Dies führt dazu, dass es möglicherweise keine Downloadkosten verursacht, insbesondere bei dem gehosteten Buildpool.

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

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

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

Arbeitsverzeichnis für den Befehl Kubectl.

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

Ausgabeformat.

kubectlOutput - Ausgabevariablenname
string.

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

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Einsetzen