Dela via

HelmDeploy@1 – Paketera och distribuera Helm-diagram v1-uppgift

  • Artikel

Distribuera, konfigurera och uppdatera ett Kubernetes-kluster i Azure Container Service genom att köra helm-kommandon.

Syntax

# 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 || command == push. Azure subscription for Container Registry. 
    #azureResourceGroupForACR: # string. Required when command == login || command == package || command == push. Resource group. 
    #azureContainerRegistry: # string. Required when command == login || command == package || command == push. 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 || command == push. Chart Name For Azure Container Registry. 
    #chartPathForACR: # string. Required when command == package || command == push. 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.

Ingångar

connectionType - anslutningstyp
string. Krävs när command != logout && command != package. Tillåtna värden: Azure Resource Manager, Kubernetes Service Connection, None. Standardvärde: Azure Resource Manager.

Välj Azure Resource Manager för att ansluta till en Azure Kubernetes-tjänst med hjälp av Azure-tjänstanslutning. Välj Kubernetes-tjänstanslutning för att ansluta till kubernetes-kluster med kubeconfig eller tjänstkonto.


azureSubscription - Azure-prenumeration
Indataalias: azureSubscriptionEndpoint. string. Krävs när connectionType = Azure Resource Manager && command != logout && command != package.

Välj en Azure-prenumeration som har ditt Azure Container Registry.


azureResourceGroup - resursgrupp
string. Krävs när connectionType = Azure Resource Manager && command != logout && command != package.

Välj en Azure-resursgrupp.


kubernetesCluster - Kubernetes-kluster
string. Krävs när connectionType = Azure Resource Manager && command != logout && command != package.

Välj ett Azure-hanterat kluster.


useClusterAdmin - Använd autentiseringsuppgifter för klusteradministratör
boolean. Valfri. Använd när connectionType = Azure Resource Manager && command != logout && command != package. Standardvärde: false.

Använd autentiseringsuppgifter för klusteradministratör i stället för standardautentiseringsuppgifter för klusteranvändare.


kubernetesServiceConnection - Kubernetes-tjänstanslutning
Indataalias: kubernetesServiceEndpoint. string. Krävs när connectionType = Kubernetes Service Connection && command != logout && command != package.

Välj en Kubernetes-tjänstanslutning.


namespace - namnområde
string. Valfri. Använd när command != logout && command != package.

Ange det K8-namnområde som ska användas. Använd Tiller-namnområdet kan anges i det avancerade avsnittet i aktiviteten eller genom att skicka alternativet --tiller-namespace som argument.


azureSubscriptionForACR - Azure-prenumeration för Container Registry
Indataalias: azureSubscriptionEndpointForACR. string. Krävs när command == login || command == package || command == push.

Välj en Azure-prenumeration som har ditt Azure Container Registry.


azureResourceGroupForACR - resursgrupp
string. Krävs när command == login || command == package || command == push.

Välj en Azure-resursgrupp som har containerregistret.


azureContainerRegistry - Azure Container Registry
string. Krävs när command == login || command == package || command == push.

Välj ett Azure Container Registry som ska användas för helm-diagram.


command - kommando
string. Krävs. Tillåtna värden: create, delete, expose, get, init, install, login, logout, ls, package, rollback, upgrade, uninstall. Standardvärde: ls.

Välj ett helm-kommando.


chartType - diagramtyp
string. Krävs när command == install || command == upgrade. Tillåtna värden: Name, FilePath (filsökväg). Standardvärde: Name.

Välj hur du vill ange diagraminformation. Du kan antingen ange namnet på diagrammet eller mapp-/filsökvägen till diagrammet.


chartName - diagramnamn
string. Krävs när chartType == Name.

Diagramreferens som ska installeras, detta kan vara en URL eller ett diagramnamn. Om diagramnamnet till exempel är "stable/mysql" körs uppgiften "helm install stable/mysql".


chartPath - diagramsökväg
string. Krävs när chartType == FilePath || command == package.

Sökväg till diagrammet som ska installeras. Det kan vara en sökväg till ett paketerat diagram eller en sökväg till en uppackad diagramkatalog. Om till exempel "./redis" har angetts körs uppgiften "helm install ./redis".


chartVersion - version
Indataalias: version. string. Valfri. Använd när command == package || command == install || command == upgrade.

Ange den exakta diagramversion som ska installeras. Om detta inte anges installeras den senaste versionen. Ange versionen i diagrammet till den här semverversionen.


releaseName - versionsnamn
string. Valfri. Använd när command == install || command == upgrade.

Versionsnamn. Om den är ospecificerad genereras en automatiskt åt dig.


overrideValues - ange värden
string. Valfri. Använd när command == install || command == upgrade.

Ange värden på kommandoraden (kan ange flera eller separata värden med kommatecken eller nya rader: key1=val1,key2=val2 eller
key1=val1
key2=val2
). Uppgiften konstruerar helm-kommandot med hjälp av dessa uppsättningsvärden. Till exempel helm install --set key1=val1 ./redis.


valueFile - värdefil
string. Valfri. Använd när command == install || command == upgrade.

Ange värden i en YAML-fil eller en URL. Om du till exempel anger myvalues.yaml resulterar det i "helm install --values=myvals.yaml".


destination - mål
string. Valfri. Använd när command == package. Standardvärde: $(Build.ArtifactStagingDirectory).

Ange värden i en YAML-fil eller en URL.


canaryimage - Använd kanariebildversion.
boolean. Valfri. Använd när command == init. Standardvärde: false.

Använd canary Tiller-avbildningen, den senaste förhandsversionen av Tiller.


upgradetiller - Upgrade Tiller
boolean. Valfri. Använd när command == init. Standardvärde: true.

Uppgradera om Tiller redan är installerat.


updatedependency - Uppdatera beroende
boolean. Valfri. Använd när command == install || command == package. Standardvärde: false.

Kör helm-beroendeuppdatering innan du installerar diagrammet. Uppdatera beroenden från "requirements.yaml" till dir "charts/" före paketering.


save - Spara
boolean. Valfri. Använd när command == package. Standardvärde: true.

Spara paketerat diagram till lagringsplatsen för det lokala diagrammet (standard sant).


install - Installera om versionen inte finns.
boolean. Valfri. Använd när command == upgrade. Standardvärde: true.

Om det inte redan finns en version med det här namnet kör du en installation.


recreate - Återskapa poddar.
boolean. Valfri. Använd när command == upgrade. Standardvärde: false.

Utför omstart av poddar för resursen om det är tillämpligt.


resetValues - Återställ värden.
boolean. Valfri. Använd när command == upgrade. Standardvärde: false.

Återställ värdena till de som är inbyggda i diagrammet.


force - Framtvinga
boolean. Valfri. Använd när command == upgrade. Standardvärde: false.

Framtvinga resursuppdatering via ta bort/återskapa om det behövs.


waitForExecution - Vänta
boolean. Valfri. Använd när command == init || command == install || command == upgrade. Standardvärde: true.

Blockera tills kommandokörningen har slutförts.


arguments - argument
string. Valfri. Använd när command != login && command != logout.

Helm-kommandoalternativ.


enableTls - Aktivera TLS-
boolean. Valfri. Använd när command != login && command != logout && command != package. Standardvärde: false.

Aktiverar användning av SSL mellan Helm och Tiller.


caCert - CA-certifikat
string. Krävs när enableTls == true && command != login && command != logout && command != package.

CA-certifikat som används för att utfärda certifikat för tiller- och helm-klienten.


certificate - certifikat
string. Krävs när enableTls == true && command != login && command != logout && command != package.

Ange Tiller-certifikat eller Helm-klientcertifikat.


privatekey - nyckel
string. Krävs när enableTls == true && command != login && command != logout && command != package.

Ange Tiller-nyckel eller Helm-klientnyckel.


tillernamespace - Tiller-namnområde
string. Valfri. Använd när command != login && command != logout && command != package.

Ange K8-namnrymd för tiller.


failOnStderr - fel vid standardfel
boolean. Valfri. Använd när command != login && command != logout && command != package. Standardvärde: false.

Om detta är sant misslyckas den här uppgiften om några fel skrivs till felpipelinen eller om några data skrivs till standardfelströmmen. Annars förlitar sig uppgiften på slutkoden för att fastställa felet.


publishPipelineMetadata - Publicera pipelinemetadata
boolean. Valfri. Använd när command != login && command != logout && command != package. Standardvärde: true.

Om detta är sant samlar uppgiften in och publicerar distributionsmetadata.


chartNameForACR - diagramnamn för Azure Container Registry
string. Krävs när command == package || command == push.

Diagramnamn som diagrammet ska lagras med i Azure Container Registry.


chartPathForACR - diagramsökväg för Azure Container Registry
string. Krävs när command == package || command == push.

Sökväg till diagramkatalogen.


Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

helmExitCode
slutkod som genereras från körningen av det angivna Helm-kommandot

helmOutput
utdata som genereras från körningen av det angivna Helm-kommandot

Anmärkningar

En viktig ändring för HelmDeploy@1 uppgift är att helm-diagramkommandon tas bort:

  • Underkommandot helm chart har tagits bort
  • helm chart push har tagits bort
  • helm chart remove har tagits bort
  • helm chart save har ersatts med helm package
  • helm save har tagits bort

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Någon
variabler som kan Någon
Agentversion Alla agentversioner som stöds.
Aktivitetskategori Gruppera