HelmDeploy@1 - Empaqueter et déployer des graphiques Helm v1
Déployez, configurez, mettez à jour un cluster Kubernetes dans Azure Container Service en exécutant des commandes Helm.
Syntaxe
# Package and deploy Helm charts v1
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running helm commands.
- task: HelmDeploy@1
inputs:
# Kubernetes Cluster
#connectionType: 'Azure Resource Manager' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout && command != package. Connection Type. Default: Azure Resource Manager.
#azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when connectionType = Azure Resource Manager && command != logout && command != package. Azure subscription.
#azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package. Resource group.
#kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package. Kubernetes cluster.
#useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout && command != package. Use cluster admin credentials. Default: false.
#kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when connectionType = Kubernetes Service Connection && command != logout && command != package. Kubernetes Service Connection.
#namespace: # string. Optional. Use when command != logout && command != package. Namespace.
# Azure Container Registry
#azureSubscriptionForACR: # string. Alias: azureSubscriptionEndpointForACR. Required when command == login || command == package. Azure subscription for Container Registry.
#azureResourceGroupForACR: # string. Required when command == login || command == package. Resource group.
#azureContainerRegistry: # string. Required when command == login || command == package. Azure Container Registry.
# Commands
command: 'ls' # 'create' | 'delete' | 'expose' | 'get' | 'init' | 'install' | 'login' | 'logout' | 'ls' | 'package' | 'rollback' | 'upgrade' | 'uninstall'. Required. Command. Default: ls.
#chartType: 'Name' # 'Name' | 'FilePath'. Required when command == install || command == upgrade. Chart Type. Default: Name.
chartName: # string. Required when chartType == Name. Chart Name.
#chartPath: # string. Required when chartType == FilePath || command == package. Chart Path.
#chartVersion: # string. Alias: version. Optional. Use when command == package || command == install || command == upgrade. Version.
#releaseName: # string. Optional. Use when command == install || command == upgrade. Release Name.
#overrideValues: # string. Optional. Use when command == install || command == upgrade. Set Values.
#valueFile: # string. Optional. Use when command == install || command == upgrade. Value File.
#destination: '$(Build.ArtifactStagingDirectory)' # string. Optional. Use when command == package. Destination. Default: $(Build.ArtifactStagingDirectory).
#canaryimage: false # boolean. Optional. Use when command == init. Use canary image version. Default: false.
#upgradetiller: true # boolean. Optional. Use when command == init. Upgrade Tiller. Default: true.
#updatedependency: false # boolean. Optional. Use when command == install || command == package. Update Dependency. Default: false.
#save: true # boolean. Optional. Use when command == package. Save. Default: true.
#install: true # boolean. Optional. Use when command == upgrade. Install if release not present. Default: true.
#recreate: false # boolean. Optional. Use when command == upgrade. Recreate Pods. Default: false.
#resetValues: false # boolean. Optional. Use when command == upgrade. Reset Values. Default: false.
#force: false # boolean. Optional. Use when command == upgrade. Force. Default: false.
#waitForExecution: true # boolean. Optional. Use when command == init || command == install || command == upgrade. Wait. Default: true.
#arguments: # string. Optional. Use when command != login && command != logout. Arguments.
#chartNameForACR: # string. Required when command == package. Chart Name For Azure Container Registry.
#chartPathForACR: # string. Required when command == package. Chart Path for Azure Container Registry.
# TLS
#enableTls: false # boolean. Optional. Use when command != login && command != logout && command != package. Enable TLS. Default: false.
#caCert: # string. Required when enableTls == true && command != login && command != logout && command != package. CA certificate.
#certificate: # string. Required when enableTls == true && command != login && command != logout && command != package. Certificate.
#privatekey: # string. Required when enableTls == true && command != login && command != logout && command != package. Key.
# Advanced
#tillernamespace: # string. Optional. Use when command != login && command != logout && command != package. Tiller namespace.
#failOnStderr: false # boolean. Optional. Use when command != login && command != logout && command != package. Fail on Standard Error. Default: false.
#publishPipelineMetadata: true # boolean. Optional. Use when command != login && command != logout && command != package. Publish pipeline metadata. Default: true.
Entrées
connectionType
-
type de connexion
string
. Obligatoire lorsque command != logout && command != package
. Valeurs autorisées : Azure Resource Manager
, Kubernetes Service Connection
, None
. Valeur par défaut : Azure Resource Manager
.
Sélectionnez « Azure Resource Manager » pour vous connecter à un service Azure Kubernetes à l’aide d’Azure Service Connection. Sélectionnez « Connexion Kubernetes Service » pour vous connecter à n’importe quel cluster Kubernetes à l’aide de kubeconfig ou d’un compte de service.
azureSubscription
-
abonnement Azure
Alias d’entrée : azureSubscriptionEndpoint
.
string
. Obligatoire lorsque connectionType = Azure Resource Manager && command != logout && command != package
.
Sélectionnez un abonnement Azure avec Azure Container Registry.
azureResourceGroup
-
groupe de ressources
string
. Obligatoire lorsque connectionType = Azure Resource Manager && command != logout && command != package
.
Sélectionnez un groupe de ressources Azure.
kubernetesCluster
-
de cluster Kubernetes
string
. Obligatoire lorsque connectionType = Azure Resource Manager && command != logout && command != package
.
Sélectionnez un cluster managé Azure.
useClusterAdmin
-
Utiliser les informations d’identification de l’administrateur de cluster
boolean
. Optionnel. Utilisez quand connectionType = Azure Resource Manager && command != logout && command != package
. Valeur par défaut : false
.
Utilisez les informations d’identification de l’administrateur de cluster au lieu des informations d’identification utilisateur de cluster par défaut.
kubernetesServiceConnection
-
de connexion Kubernetes Service
Alias d’entrée : kubernetesServiceEndpoint
.
string
. Obligatoire lorsque connectionType = Kubernetes Service Connection && command != logout && command != package
.
Sélectionnez une connexion de service Kubernetes.
namespace
-
espace de noms
string
. Optionnel. Utilisez quand command != logout && command != package
.
Spécifiez l’espace de noms K8 à utiliser. Utilisez l’espace de noms Tiller peut être spécifié dans la section avancée de la tâche ou en passant l’option --tiller-namespace en tant qu’argument.
abonnement Azure azureSubscriptionForACR
- pour Container Registry
Alias d’entrée : azureSubscriptionEndpointForACR
.
string
. Obligatoire lorsque command == login || command == package
.
Sélectionnez un abonnement Azure avec Azure Container Registry.
azureResourceGroupForACR
-
groupe de ressources
string
. Obligatoire lorsque command == login || command == package
.
Sélectionnez un groupe de ressources Azure, qui possède votre registre de conteneurs.
azureContainerRegistry
-
Azure Container Registry
string
. Obligatoire lorsque command == login || command == package
.
Sélectionnez un Registre de conteneurs Azure qui sera utilisé pour les graphiques Helm.
command
-
commande
string
. Obligatoire. Valeurs autorisées : create
, delete
, expose
, get
, init
, install
, login
, logout
, ls
, package
, rollback
, upgrade
, uninstall
. Valeur par défaut : ls
.
Sélectionnez une commande Helm.
chartType
-
type de graphique
string
. Obligatoire lorsque command == install || command == upgrade
. Valeurs autorisées : Name
, FilePath
(chemin d’accès au fichier). Valeur par défaut : Name
.
Sélectionnez la façon dont vous souhaitez entrer des informations sur le graphique. Vous pouvez fournir le nom du graphique ou du chemin d’accès au dossier/fichier du graphique.
chartName
-
nom du graphique
string
. Obligatoire lorsque chartType == Name
.
Référence de graphique à installer, il peut s’agir d’une URL ou d’un nom de graphique. Par exemple, si le nom du graphique est « stable/mysql », la tâche exécute « helm install stable/mysql ».
chartPath
-
chemin d’accès du graphique
string
. Obligatoire lorsque chartType == FilePath || command == package
.
Chemin d’accès au graphique à installer. Il peut s’agir d’un chemin d’accès à un graphique empaqueté ou d’un chemin d’accès à un répertoire de graphique décompressé. Par exemple, si « ./redis » est spécifié, la tâche exécute « helm install ./redis ».
chartVersion
-
version
Alias d’entrée : version
.
string
. Optionnel. Utilisez quand command == package || command == install || command == upgrade
.
Spécifiez la version exacte du graphique à installer. Si ce n’est pas spécifié, la dernière version est installée. Définissez la version sur le graphique sur cette version semver.
releaseName
-
nom de publication
string
. Optionnel. Utilisez quand command == install || command == upgrade
.
Nom de la mise en production. S’il n’est pas spécifié, il en génère automatiquement un pour vous.
overrideValues
-
définir des valeurs
string
. Optionnel. Utilisez quand command == install || command == upgrade
.
Définir des valeurs sur la ligne de commande (peut spécifier plusieurs valeurs ou distinctes avec des virgules ou des nouvelles lignes : key1=val1,key2=val2 ou
key1=val1
key2=val2
). La tâche construit la commande helm à l’aide de ces valeurs définies. Par exemple, helm install --set key1=val1 ./redis.
valueFile
-
fichier de valeur
string
. Optionnel. Utilisez quand command == install || command == upgrade
.
Spécifiez des valeurs dans un fichier YAML ou une URL. Par exemple, la spécification de myvalues.yaml génère « helm install --values=myvals.yaml ».
destination
-
de destination
string
. Optionnel. Utilisez quand command == package
. Valeur par défaut : $(Build.ArtifactStagingDirectory)
.
Spécifiez des valeurs dans un fichier YAML ou une URL.
canaryimage
-
Utiliser la version d’image canary.
boolean
. Optionnel. Utilisez quand command == init
. Valeur par défaut : false
.
Utilisez l’image canary Tiller, la dernière version en préversion de Tiller.
upgradetiller
-
mettre à niveau le Tiller
boolean
. Optionnel. Utilisez quand command == init
. Valeur par défaut : true
.
Mettre à niveau si Tiller est déjà installé.
updatedependency
-
mettre à jour le de dépendance
boolean
. Optionnel. Utilisez quand command == install || command == package
. Valeur par défaut : false
.
Exécutez la mise à jour des dépendances helm avant d’installer le graphique. Mettez à jour les dépendances de ' requirements.yaml' en dir 'charts/' avant l’empaquetage.
save
-
Enregistrer
boolean
. Optionnel. Utilisez quand command == package
. Valeur par défaut : true
.
Enregistrez un graphique empaqueté dans le référentiel de graphiques local (true par défaut).
install
-
Installer si la version n’est pas présente.
boolean
. Optionnel. Utilisez quand command == upgrade
. Valeur par défaut : true
.
Si une version de ce nom n’existe pas déjà, exécutez une installation.
recreate
-
recréer des pods.
boolean
. Optionnel. Utilisez quand command == upgrade
. Valeur par défaut : false
.
Effectue le redémarrage des pods pour la ressource le cas échéant.
resetValues
-
Réinitialiser les valeurs.
boolean
. Optionnel. Utilisez quand command == upgrade
. Valeur par défaut : false
.
Réinitialisez les valeurs aux valeurs intégrées au graphique.
force
-
Force
boolean
. Optionnel. Utilisez quand command == upgrade
. Valeur par défaut : false
.
Forcer la mise à jour des ressources par le biais de la suppression/recréation si nécessaire.
waitForExecution
-
d’attente
boolean
. Optionnel. Utilisez quand command == init || command == install || command == upgrade
. Valeur par défaut : true
.
Bloquer jusqu’à la fin de l’exécution de la commande.
arguments
-
arguments
string
. Optionnel. Utilisez quand command != login && command != logout
.
Options de commande Helm.
enableTls
-
activer le TLS
boolean
. Optionnel. Utilisez quand command != login && command != logout && command != package
. Valeur par défaut : false
.
Active l’utilisation de SSL entre Helm et Tiller.
caCert
-
certificat d’autorité de certification
string
. Obligatoire lorsque enableTls == true && command != login && command != logout && command != package
.
Certificat d’autorité de certification utilisé pour émettre un certificat pour le client tiller et helm.
certificate
-
certificat
string
. Obligatoire lorsque enableTls == true && command != login && command != logout && command != package
.
Spécifiez le certificat Tiller ou le certificat client Helm.
privatekey
-
clé
string
. Obligatoire lorsque enableTls == true && command != login && command != logout && command != package
.
Spécifiez la clé Tiller ou la clé client Helm.
tillernamespace
-
'espace de noms Tiller
string
. Optionnel. Utilisez quand command != login && command != logout && command != package
.
Spécifiez l’espace de noms K8 du tiller.
failOnStderr
-
Échec sur les d’erreur standard
boolean
. Optionnel. Utilisez quand command != login && command != logout && command != package
. Valeur par défaut : false
.
Si cela est vrai, cette tâche échoue si des erreurs sont écrites dans le pipeline d’erreurs ou si des données sont écrites dans le flux d’erreurs standard. Sinon, la tâche s’appuie sur le code de sortie pour déterminer l’échec.
publishPipelineMetadata
-
Publier des métadonnées de pipeline
boolean
. Optionnel. Utilisez quand command != login && command != logout && command != package
. Valeur par défaut : true
.
Si c’est le cas, la tâche collecte et publie les métadonnées de déploiement.
nom de graphique chartNameForACR
- pour azure Container Registry
string
. Obligatoire lorsque command == package
.
Nom du graphique avec lequel le graphique sera stocké dans Azure Container Registry.
chemin d’accès au graphique chartPathForACR
- d’Azure Container Registry
string
. Obligatoire lorsque command == package
.
Chemin d’accès au répertoire du graphique.
Options de contrôle de tâche
Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.
Variables de sortie
Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser en aval, les travaux et les étapes.
helmExitCode
code de sortie émis à partir de l’exécution de la commande Helm spécifiée
helmOutput
Sortie émise à partir de l’exécution de la commande Helm spécifiée
Remarques
Une modification majeure pour HelmDeploy@1
tâche est que les commandes helm chart sont supprimées :
- La sous-commande
helm chart
a été supprimée -
helm chart push
a été supprimé -
helm chart remove
a été supprimé -
helm chart save
a été remplacé parhelm package
-
helm save
a été supprimé
Exigences
Exigence | Description |
---|---|
Types de pipelines | YAML, Build Classique, Version Classique |
Exécutions sur | Agent, DeploymentGroup |
demandes | Aucun |
fonctionnalités de | Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail. |
restrictions de commande | Quelconque |
variables settables | Quelconque |
Version de l’agent | Toutes les versions de l’agent prises en charge. |
Catégorie de tâche | Déployer |