HelmDeploy@1 - Helm-grafieken v1-taak verpakken en implementeren

Implementeer, configureer, werk een Kubernetes-cluster bij in Azure Container Service door Helm-opdrachten uit te voeren.

Syntaxis

# 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' | 'push' | '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 || command == create. Chart Name. 
    #chartPath: # string. Required when chartType == FilePath || command == package || command == push. Chart Path. 
    #remoteRepo: # string. Required when command == push. Remote Repo. 
    #chartVersion: # string. Alias: version. Optional. Use when command == package || command == install || command == upgrade. Version. 
    #releaseName: # string. Optional. Use when command == install || command == upgrade || command == rollback || command == uninstall || command == delete. 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.

Ingangen

connectionType - verbindingstype
string. Vereist wanneer command != logout && command != package. Toegestane waarden: Azure Resource Manager, Kubernetes Service Connection, None. Standaardwaarde: Azure Resource Manager.

Selecteer Azure Resource Manager om verbinding te maken met een Azure Kubernetes Service met behulp van Azure Service Connection. Selecteer Kubernetes Service Connection om verbinding te maken met een Kubernetes-cluster met behulp van kubeconfig of serviceaccount.


azureSubscription - Azure-abonnement
Invoeralias: azureSubscriptionEndpoint. string. Vereist wanneer connectionType = Azure Resource Manager && command != logout && command != package.

Selecteer een Azure-abonnement met uw Azure Container Registry.


azureResourceGroup - resourcegroep
string. Vereist wanneer connectionType = Azure Resource Manager && command != logout && command != package.

Selecteer een Azure-resourcegroep.


kubernetesCluster - Kubernetes-cluster
string. Vereist wanneer connectionType = Azure Resource Manager && command != logout && command != package.

Selecteer een beheerd Azure-cluster.


useClusterAdmin - Referenties van clusterbeheerder gebruiken
boolean. Facultatief. Gebruiken wanneer connectionType = Azure Resource Manager && command != logout && command != package. Standaardwaarde: false.

Gebruik de referenties van de clusterbeheerder in plaats van de standaardreferenties voor clustergebruikers.


kubernetesServiceConnection - Kubernetes-serviceverbinding
Invoeralias: kubernetesServiceEndpoint. string. Vereist wanneer connectionType = Kubernetes Service Connection && command != logout && command != package.

Selecteer een Kubernetes-serviceverbinding.


namespace - naamruimte
string. Facultatief. Gebruiken wanneer command != logout && command != package.

Geef de K8-naamruimte op die u wilt gebruiken. Gebruik Tiller-naamruimte kan worden opgegeven in de geavanceerde sectie van de taak of door de optie --tiller-namespace door te geven als argument.


azureSubscriptionForACR - Azure-abonnement voor Container Registry-
Invoeralias: azureSubscriptionEndpointForACR. string. Vereist wanneer command == login || command == package || command == push.

Selecteer een Azure-abonnement met uw Azure Container Registry.


azureResourceGroupForACR - resourcegroep
string. Vereist wanneer command == login || command == package || command == push.

Selecteer een Azure-resourcegroep met uw Container Registry.


azureContainerRegistry - Azure Container Registry-
string. Vereist wanneer command == login || command == package || command == push.

Selecteer een Azure Container Registry die wordt gebruikt voor Helm-grafieken.


command - opdracht
string. Vereist. Toegestane waarden: create, delete, expose, get, init, install, login, logout, ls, push, package, rollback, upgrade, uninstall. Standaardwaarde: ls.

Selecteer een Helm-opdracht.


chartType - grafiektype
string. Vereist wanneer command == install || command == upgrade. Toegestane waarden: Name, FilePath (bestandspad). Standaardwaarde: Name.

Selecteer hoe u grafiekgegevens wilt invoeren. U kunt de naam van de grafiek of map/bestandspad naar de grafiek opgeven.


chartName - grafieknaam
string. Vereist wanneer chartType == Name || command == create.

Grafiekreferentie om te installeren. Dit kan een URL of een grafieknaam zijn. Als de grafieknaam bijvoorbeeld 'stable/mysql' is, wordt 'helm install stable/mysql' uitgevoerd.


chartPath - grafiekpad
string. Vereist wanneer chartType == FilePath || command == package || command == push.

Pad naar de grafiek die moet worden geïnstalleerd. Dit kan een pad naar een verpakte grafiek of een pad naar een uitgepakte grafiekmap zijn. Als bijvoorbeeld './redis' is opgegeven, wordt 'helm install ./redis' uitgevoerd.


remoteRepo - Externe opslagplaats
string. Vereist wanneer command == push.

De externe opslagplaats waar de grafiek wordt gepusht.


chartVersion - versie
Invoeralias: version. string. Facultatief. Gebruiken wanneer command == package || command == install || command == upgrade.

Geef de exacte grafiekversie op die moet worden geïnstalleerd. Als dit niet is opgegeven, wordt de nieuwste versie geïnstalleerd. Stel de versie in de grafiek in op deze semver-versie.


releaseName - releasenaam
string. Facultatief. Gebruiken wanneer command == install || command == upgrade || command == rollback || command == uninstall || command == delete.

Releasenaam. Als u dit niet hebt opgegeven, wordt er automatisch een voor u gegenereerd.


overrideValues - Waarden instellen
string. Facultatief. Gebruiken wanneer command == install || command == upgrade.

Waarden instellen op de opdrachtregel (kan meerdere of afzonderlijke waarden opgeven met komma's of nieuwe regels: key1=val1,key2=val2 of
sleutel1=val1
key2=val2
). De taak maakt de Helm-opdracht met behulp van deze setwaarden. Helm installeer bijvoorbeeld --set key1=val1 ./redis.


valueFile - waardebestand
string. Facultatief. Gebruiken wanneer command == install || command == upgrade.

Geef waarden op in een YAML-bestand of een URL. Als u bijvoorbeeld myvalues.yaml opgeeft, resulteert dit in 'helm install --values=myvals.yaml'.


destination - Doel-
string. Facultatief. Gebruiken wanneer command == package. Standaardwaarde: $(Build.ArtifactStagingDirectory).

Geef waarden op in een YAML-bestand of een URL.


canaryimage - Canary-installatiekopieënversie gebruiken.
boolean. Facultatief. Gebruiken wanneer command == init. Standaardwaarde: false.

Gebruik de canary Tiller-installatiekopieën, de nieuwste voorlopige versie van Tiller.


upgradetiller - Tiller- upgraden
boolean. Facultatief. Gebruiken wanneer command == init. Standaardwaarde: true.

Voer een upgrade uit als Tiller al is geïnstalleerd.


updatedependency - Afhankelijkheid bijwerken
boolean. Facultatief. Gebruiken wanneer command == install || command == package. Standaardwaarde: false.

Voer helm-afhankelijkheidsupdate uit voordat u de grafiek installeert. Werk afhankelijkheden van 'requirements.yaml' bij naar dir 'charts/' voordat ze worden verpakt.


save - opslaan
boolean. Facultatief. Gebruiken wanneer command == package. Standaardwaarde: true.

Sla de verpakte grafiek op in de lokale opslagplaats voor grafieken (standaard true).


install - installeren als de release niet aanwezig is.
boolean. Facultatief. Gebruiken wanneer command == upgrade. Standaardwaarde: true.

Als er nog geen release met deze naam bestaat, voert u een installatie uit.


recreate - Pods opnieuw maken.
boolean. Facultatief. Gebruiken wanneer command == upgrade. Standaardwaarde: false.

Voert pods opnieuw op voor de resource, indien van toepassing.


resetValues - waarden opnieuw instellen.
boolean. Facultatief. Gebruiken wanneer command == upgrade. Standaardwaarde: false.

Stel de waarden opnieuw in op de waarden die zijn ingebouwd in de grafiek.


force - Forceren
boolean. Facultatief. Gebruiken wanneer command == upgrade. Standaardwaarde: false.

Forceer het bijwerken van resources via verwijderen/opnieuw maken, indien nodig.


waitForExecution - wacht
boolean. Facultatief. Gebruiken wanneer command == init || command == install || command == upgrade. Standaardwaarde: true.

Blokkeren totdat de uitvoering van de opdracht is voltooid.


arguments - argumenten
string. Facultatief. Gebruiken wanneer command != login && command != logout.

Helm-opdrachtopties.


TLS- inschakelen
boolean. Facultatief. Gebruiken wanneer command != login && command != logout && command != package. Standaardwaarde: false.

Maakt het gebruik van SSL mogelijk tussen Helm en Tiller.


caCert - CA-certificaat
string. Vereist wanneer enableTls == true && command != login && command != logout && command != package.

CA-certificaat dat wordt gebruikt voor het uitgeven van certificaat voor tiller en helm-client.


certificate - certificaat
string. Vereist wanneer enableTls == true && command != login && command != logout && command != package.

Geef Tiller-certificaat of Helm-clientcertificaat op.


privatekey - Sleutel
string. Vereist wanneer enableTls == true && command != login && command != logout && command != package.

Geef Tiller Key of Helm-clientsleutel op.


tillernamespace - Tiller-naamruimte
string. Facultatief. Gebruiken wanneer command != login && command != logout && command != package.

Geef de K8-naamruimte van tiller op.


failOnStderr - mislukt bij standaardfout
boolean. Facultatief. Gebruiken wanneer command != login && command != logout && command != package. Standaardwaarde: false.

Als dit waar is, mislukt deze taak als er fouten naar de foutpijplijn worden geschreven of als er gegevens naar de standaardfoutstroom worden geschreven. Anders is de taak afhankelijk van de afsluitcode om de fout te bepalen.


publishPipelineMetadata - metagegevens van pijplijn publiceren
boolean. Facultatief. Gebruiken wanneer command != login && command != logout && command != package. Standaardwaarde: true.

Als dit waar is, verzamelt en publiceert de taak metagegevens van de implementatie.


chartNameForACR - grafieknaam voor Azure Container Registry-
string. Vereist wanneer command == package || command == push.

Grafieknaam waarmee de grafiek wordt opgeslagen in Azure Container Registry.


chartPathForACR - grafiekpad voor Azure Container Registry-
string. Vereist wanneer command == package || command == push.

Pad naar de grafiekmap.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

helmExitCode
afsluitcode die wordt verzonden door de uitvoering van de opgegeven Helm-opdracht

helmOutput
uitvoer die wordt verzonden door de uitvoering van de opgegeven Helm-opdracht

Opmerkingen

Een belangrijke wijziging voor HelmDeploy@1 taak is dat helm-grafiekopdrachten worden verwijderd:

  • De helm chart subopdracht is verwijderd
  • helm chart remove is verwijderd
  • helm chart save is vervangen door helm package
  • helm save is verwijderd

Eisen

Eis Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Enig
variabelen instellen Enig
Agentversie Alle ondersteunde agentversies.
Taakcategorie Implementeren