Kubernetes@0 - Tâche Kubectl v0

Article
07/02/2024

Utilisez cette tâche pour déployer, configurer ou mettre à jour un cluster Kubernetes dans Azure Container Service en exécutant kubectl des commandes.

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.

Entrées

kubernetesServiceConnection - Connexion au service Kubernetes
Alias d’entrée : kubernetesServiceEndpoint. string.

Sélectionnez une connexion de service Kubernetes.

namespace - Noms
string.

Spécifie l’espace de noms de la commande à l’aide kubectl de l’indicateur –namespace . Si l’espace de noms n’est pas fourni, les commandes s’exécutent dans l’espace de noms par défaut.

command - Commande
string. Valeurs autorisées : apply, create, delete, exposeexec, get, logs, run, , set, . top

Spécifie une kubectl commande à exécuter.

command - Commande
string. Obligatoire. Valeurs autorisées : apply, create, delete, exposeexec, get, logs, run, , set, . top Valeur par défaut : apply.

Spécifie une kubectl commande à exécuter.

useConfigurationFile - Utiliser les fichiers de configuration
boolean. Valeur par défaut : false.

Utilisez le fichier de configuration Kubernetes avec la commande kubectl. Le nom de fichier, le répertoire ou l’URL des fichiers de configuration Kubernetes peut également être fourni.

configuration - Fichier de configuration
string. Nécessaire lorsque useConfigurationFile = true.

Spécifie le nom de fichier, le répertoire ou l’URL des fichiers de configuration Kubernetes utilisés avec les commandes.

arguments - Arguments
string.

Spécifie les arguments de la commande spécifiée kubectl .

secretType - Type de secret
string. Obligatoire. Valeurs autorisées : dockerRegistry, generic. Valeur par défaut : dockerRegistry.

Crée ou met à jour un générique ou docker imagepullsecret. Spécifiez dockerRegistry pour créer ou mettre à jour le imagepullsecret du registre sélectionné. Un imagePullSecret est un moyen de transmettre un secret qui contient un mot de passe de registre de conteneurs au Kubelet, afin qu’il puisse extraire une image privée pour le compte de votre pod.

secretArguments - Arguments
string. facultatif. Utilisez quand secretType = generic.

Spécifie les clés et les valeurs littérales à insérer dans le secret. Par exemple, --from-literal=key1=value1 ou --from-literal=key2="top secret".

containerRegistryType - Type de registre de conteneurs
string. Nécessaire lorsque secretType = dockerRegistry. Valeurs autorisées : Azure Container Registry, Container Registry. Valeur par défaut : Azure Container Registry.

Sélectionnez un type de registre de conteneurs. La tâche peut utiliser les détails de l’abonnement Azure pour utiliser un registre de conteneurs Azure. D’autres registres de conteneurs standard sont également pris en charge.

dockerRegistryConnection - Connexion au service Docker Registry
Alias d’entrée : dockerRegistryEndpoint. string. facultatif. Utilisez quand secretType = dockerRegistry && containerRegistryType = Container Registry.

Sélectionnez une connexion au service De Registre Docker. Obligatoire pour les commandes qui doivent s’authentifier sur un registre.

azureSubscription - Abonnement Azure
Alias d’entrée : azureSubscriptionEndpoint. string. facultatif. Utilisez quand secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Spécifie l’abonnement Azure Resource Manager, qui contient Azure Container Registry.

Notes

Pour configurer une nouvelle connexion de service, sélectionnez l’abonnement Azure dans la liste, puis cliquez sur Authorize. Si votre abonnement n’est pas répertorié ou si vous souhaitez utiliser un principal de service existant, vous pouvez configurer une connexion de service Azure à l’aide des Add boutons ou Manage .

azureContainerRegistry - Azure Container Registry
string. facultatif. Utilisez quand secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Spécifie un Azure Container Registry utilisé pour extraire des images conteneur et déployer des applications sur le cluster Kubernetes. Obligatoire pour les commandes qui doivent s’authentifier sur un registre.

secretName - Nom du secret
string.

Nom du secret. Vous pouvez utiliser ce nom secret dans le fichier de configuration Kubernetes YAML.

forceUpdate - Forcer le secret de mise à jour
boolean. Valeur par défaut : true.

Supprimez le secret s’il existe et créez-en un avec des valeurs mises à jour.

configMapName - Nom configMap
string.

ConfigMaps vous permet de dissocier les artefacts de configuration du contenu de l’image pour garder les applications conteneurisées portables.

forceUpdateConfigMap - Forcer la mise à jour du configmap
boolean. Valeur par défaut : false.

Supprimez le configmap s’il existe et créez-en un avec des valeurs mises à jour.

useConfigMapFile - Utiliser le fichier
boolean. Valeur par défaut : false.

Créez un ConfigMap à partir d’un fichier individuel ou de plusieurs fichiers en spécifiant un répertoire.

configMapFile - Fichier ConfigMap
string. Nécessaire lorsque useConfigMapFile = true.

Spécifiez un fichier ou un répertoire qui contient les configMaps.

configMapArguments - Arguments
string. facultatif. Utilisez quand useConfigMapFile = false.

Spécifie les clés et les valeurs littérales à insérer dans configMap . Par exemple, --from-literal=key1=value1 ou --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Valeurs autorisées : version, location (Spécifiez l’emplacement). Valeur par défaut : version.

kubectl est une interface de ligne de commande permettant d’exécuter des commandes sur des clusters Kubernetes.

versionSpec - Spécification de version
string. facultatif. Utilisez quand versionOrLocation = version. Valeur par défaut : 1.7.0.

Spécifie la spécification de version de la version à obtenir. Exemples : 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0

checkLatest - Rechercher la dernière version
boolean. facultatif. Utilisez quand versionOrLocation = version. Valeur par défaut : false.

Recherche toujours en ligne la dernière version disponible (stable.txt) qui répond aux spécifications de version. Ceci est généralement faux, sauf si vous avez un scénario spécifique pour toujours obtenir les dernières informations. Cela entraîne des coûts de téléchargement lorsqu’il n’est potentiellement pas nécessaire, en particulier avec le pool de builds hébergé.

specifyLocation - Chemin d’accès à Kubectl
string. Nécessaire lorsque versionOrLocation = location.

Spécifie le chemin d’accès complet au kubectl.exe fichier.

workingDirectory - Répertoire de travail
Alias d’entrée : cwd. string. Valeur par défaut : $(System.DefaultWorkingDirectory).

Répertoire de travail de la commande Kubectl.

outputFormat - Format de sortie
string. Valeurs autorisées : json, yaml. Valeur par défaut : json.

Format de sortie.

kubectlOutput - Nom de la variable de sortie
string.

Nom de la variable dans laquelle la sortie de la commande doit être enregistrée.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Déployer

Partager via