HelmDeploy@0 – Helm-diagramok v0-feladatának csomagolása és üzembe helyezése

Ezzel a feladattal üzembe helyezhet, konfigurálhat vagy frissíthet egy Kubernetes-fürtöt az Azure Container Service-ben Helm-parancsok futtatásával.

Syntax

# Package and deploy Helm charts v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running helm commands.
- task: HelmDeploy@0
  inputs:
  # Kubernetes Cluster
    #connectionType: 'Azure Resource Manager' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout && command != package && command != save. Connection Type. Default: Azure Resource Manager.
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Azure subscription. 
    #azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Resource group. 
    #kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Kubernetes cluster. 
    #useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Use cluster admin credentials. Default: false.
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when connectionType = Kubernetes Service Connection && command != logout && command != package && command != save. Kubernetes Service Connection. 
    #namespace: # string. Optional. Use when command != logout && command != package && command != save. Namespace. 
  # Azure Container Registry
    #azureSubscriptionForACR: # string. Alias: azureSubscriptionEndpointForACR. Required when command == save. Azure subscription for Container Registry. 
    #azureResourceGroupForACR: # string. Required when command == save. Resource group. 
    #azureContainerRegistry: # string. Required when command == save. Azure Container Registry. 
  # Commands
    command: 'ls' # 'create' | 'delete' | 'expose' | 'get' | 'init' | 'install' | 'login' | 'logout' | 'ls' | 'package' | 'rollback' | 'save' | '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 == save. Chart Name For Azure Container Registry. 
    #chartPathForACR: # string. Required when command == save. Chart Path for Azure Container Registry. 
  # TLS
    #enableTls: false # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Enable TLS. Default: false.
    #caCert: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. CA certificate. 
    #certificate: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. Certificate. 
    #privatekey: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. Key. 
  # Advanced
    #tillernamespace: # string. Optional. Use when command != login && command != logout && command != package && command != save. Tiller namespace. 
    #failOnStderr: false # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Fail on Standard Error. Default: false.
    #publishPipelineMetadata: true # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Publish pipeline metadata. Default: true.

Bevitelek

connectionType - Kapcsolat típusa
string. Akkor szükséges, ha command != logout && command != package && command != save. Engedélyezett értékek: Azure Resource Manager, Kubernetes Service Connection, None. Alapértelmezett érték: Azure Resource Manager.

Megadja a kapcsolat típusát.

• Kubernetes Service Connection – Adja meg Kubernetes Service Connection , hogy bármely Kubernetes-fürthöz az vagy az Azure-szolgáltatásfiók használatával kubeconfig csatlakozik-e. Lehetővé teszi KubeConfig-fájl megadását, szolgáltatásfiók megadását vagy AKS-példány importálását az Azure-előfizetés lehetőséggel. Egy AKS-példány Azure-előfizetési lehetőséggel történő importálásához Kubernetes-fürthozzáféréshez van szükség a Szolgáltatáskapcsolat konfigurálásakor.
• Azure Resource Manager– Itt adhatja megAzure Resource Manager, hogy az Azure Service Connection használatával szeretne-e csatlakozni egy Azure Kubernetes Service. Nem fér hozzá a Kubernetes-fürthöz a Szolgáltatáskapcsolat konfigurálásakor.
• None – Használjon helyileg tárolt, előre létrehozott Kubernetes-konfigurációt.

További információ: Szolgáltatáskapcsolat a következő Megjegyzések szakaszban.

azureSubscription - Azure-előfizetés
Bemeneti alias: azureSubscriptionEndpoint. string. Akkor szükséges, ha connectionType = Azure Resource Manager && command != logout && command != package && command != save.

Az Azure-szolgáltatáskapcsolat neve. Adjon meg egy Azure-előfizetést, amely a tárolóregisztrációs adatbázist tartalmazza.

azureResourceGroup - Erőforráscsoport
string. Akkor szükséges, ha connectionType = Azure Resource Manager && command != logout && command != package && command != save.

Az előfizetésen belüli erőforráscsoport neve. Adjon meg egy Azure-erőforráscsoportot.

kubernetesCluster - Kubernetes-fürt
string. Akkor szükséges, ha connectionType = Azure Resource Manager && command != logout && command != package && command != save.

Az AKS-fürt neve. Adjon meg egy Felügyelt Azure-fürtöt.

useClusterAdmin - Fürt rendszergazdai hitelesítő adatainak használata
boolean. Választható. Használja a következőt: connectionType = Azure Resource Manager && command != logout && command != package && command != save. Alapértelmezett érték: false.

Fürtadminisztrátori hitelesítő adatokat használ az alapértelmezett fürtfelhasználói hitelesítő adatok helyett.

kubernetesServiceConnection - Kubernetes-szolgáltatáskapcsolat
Bemeneti alias: kubernetesServiceEndpoint. string. Akkor szükséges, ha connectionType = Kubernetes Service Connection && command != logout && command != package && command != save.

Kubernetes-szolgáltatáskapcsolatot ad meg.

namespace - Névtér
string. Választható. Használja a következőt: command != logout && command != package && command != save.

A névtér, amelyen futtatja a kubectl parancsokat. Ha nincs megadva, a tevékenység az alapértelmezett névteret használja. Adja meg a használni kívánt Kubernetes-névteret. Megadhatja a Tiller névteret a feladat speciális szakaszában, vagy megadhatja a --tiller-namespace beállítást argumentumként.

azureSubscriptionForACR - Azure-előfizetés a Container Registryhez
Bemeneti alias: azureSubscriptionEndpointForACR. string. Akkor szükséges, ha command == save.

A Azure Container Registry rendelkező Azure-előfizetést adja meg.

azureResourceGroupForACR - Erőforráscsoport
string. Akkor szükséges, ha command == save.

Egy Azure-erőforráscsoportot ad meg, amely rendelkezik a Container Registry-adatbázissal.

azureContainerRegistry - Azure Container Registry
string. Akkor szükséges, ha command == save.

Megadja a Helm-diagramok leküldéséhez használandó Azure Container Registry.

command - Parancs
string. Kötelező. Engedélyezett értékek: create, delete, expose, get, init, install, login, logout, ls, package, rollback, save, , upgrade. uninstall Alapértelmezett érték: ls.

Helm-parancsot ad meg.

chartType - Diagramtípus
string. Akkor szükséges, ha command == install || command == upgrade. Engedélyezett értékek: Name, FilePath (Fájl elérési útja). Alapértelmezett érték: Name.

Itt adhatja meg, hogyan szeretné megadni a diagram adatait. Megadhatja a diagram nevét, illetve a diagram mappa-/fájlelérési útját.

chartName - Diagram neve
string. Akkor szükséges, ha chartType == Name.

A telepítendő diagramhivatkozás neve. Ez lehet URL-cím vagy diagramnév. Ha például a diagram neve stable/mysql, a tevékenység fut helm install stable/mysql.

chartPath - Diagram elérési útja
string. Akkor szükséges, ha chartType == FilePath || command == package.

A telepítendő diagram elérési útja. Ez lehet egy csomagolt diagram elérési útja vagy egy kicsomagolt diagramkönyvtár elérési útja. Ha például a értéket adja meg./redis, a feladat fut.helm install ./redis Ha összetevőként közzétett diagramot használ, az elérési út a következő lesz $(System.DefaultWorkingDirectory)/ARTIFACT-NAME/Charts/CHART-NAME: .

chartVersion - Változat
Bemeneti alias: version. string. Választható. Használja a következőt: command == package || command == install || command == upgrade.

Megadja a telepítendő diagramverziót. Ha nem adja meg a diagram verzióját, a feladat a legújabb verziót telepíti. Állítsa a diagramon szereplő verziót erre a szemver-verzióra.

releaseName - Kiadás neve
string. Választható. Használja a következőt: command == install || command == upgrade.

A kiadás neve. Ha nem adja meg a kiadás nevét, a feladat automatikusan létrehoz egyet. A releaseName bemenet csak és parancsokra installupgrade érvényes.

overrideValues - Értékek beállítása
string. Választható. Használja a következőt: command == install || command == upgrade.

Értékeket ad meg a parancssorban. Ez a bemenet több vagy különálló értéket is megadhat vesszővel: key1=val1,key2=val2.

Több értéket is megadhat, ha új sorba rendezi őket, az alábbiak szerint:

• key1=val1
• key2=val2

Ha új sorokat tartalmazó értékkel rendelkezik, használja a valueFile lehetőséget. Ellenkező esetben a tevékenység elválasztóként kezeli az új sort. A feladat ezekkel a készletértékekkel hozza létre a Helm-parancsot. Az értéket például a következőhöz hasonló paranccsal állíthatja be: helm install --set key1=val1 ./redis.

valueFile - Értékfájl
string. Választható. Használja a következőt: command == install || command == upgrade.

YaML-fájlban vagy URL-címben megadott értékeket ad meg. Például az eredmények megadása myvalues.yaml a következőben helm install --values=myvals.yaml: .

destination - Cél
string. Választható. Használja a következőt: command == package. Alapértelmezett érték: $(Build.ArtifactStagingDirectory).

YaML-fájlban vagy URL-címben megadott értékeket ad meg.

canaryimage - Használjon kanári-lemezképverziót.
boolean. Választható. Használja a következőt: command == init. Alapértelmezett érték: false.

Megadja a kanári Tiller rendszerképét. Használja a Tiller legújabb előzetes verzióját.

upgradetiller - A Tiller frissítése
boolean. Választható. Használja a következőt: command == init. Alapértelmezett érték: true.

Ha true, akkor ez a bemenet frissíti a Tillert, ha a Tiller már telepítve van.

updatedependency - Függőség frissítése
boolean. Választható. Használja a következőt: command == install || command == package. Alapértelmezett érték: false.

Ha truea bemenet a diagram telepítése előtt frissíti a Helm-függőség frissítését. Frissítések függőségeket a könyvtárba requirements.yaml a charts/ csomagolás előtt.

save - Menteni
boolean. Választható. Használja a következőt: command == package. Alapértelmezett érték: true.

Menti a csomagolt diagramot a helyi diagramtárba, ha a true​értéke .

install - Telepítse, ha a kiadás nem jelenik meg.
boolean. Választható. Használja a következőt: command == upgrade. Alapértelmezett érték: true.

Ha egy ilyen nevű kiadás még nem létezik, ez a bemenet futtat egy telepítést.

recreate - Hozza létre újra a podokat.
boolean. Választható. Használja a következőt: command == upgrade. Alapértelmezett érték: false.

Szükség esetén podok újraindítását hajtja végre az erőforráshoz.

resetValues - Értékek alaphelyzetbe állítása.
boolean. Választható. Használja a következőt: command == upgrade. Alapértelmezett érték: false.

Alaphelyzetbe állítja az értékeket a diagramba épített értékekre.

force - Erő
boolean. Választható. Használja a következőt: command == upgrade. Alapértelmezett érték: false.

Szükség esetén kényszeríti az erőforrás frissítését egy törlési vagy újbóli műveleten keresztül.

waitForExecution - Várj
boolean. Választható. Használja a következőt: command == init || command == install || command == upgrade. Alapértelmezett érték: true.

Letiltja a műveletet, amíg a parancs végrehajtása befejeződik.

arguments - Érvek
string. Választható. Használja a következőt: command != login && command != logout.

A Helm parancs beállításai.

enableTls - TLS engedélyezése
boolean. Választható. Használja a következőt: command != login && command != logout && command != package && command != save. Alapértelmezett érték: false.

Engedélyezi az SSL használatát a Helm és a Tiller között.

caCert - Hitelesítésszolgáltatói tanúsítvány
string. Akkor szükséges, ha enableTls == true && command != login && command != logout && command != package && command != save.

A Tiller- és Helm-ügyfél tanúsítványának kiállításához használt hitelesítésszolgáltatói tanúsítvány.

certificate - Tanúsítvány
string. Akkor szükséges, ha enableTls == true && command != login && command != logout && command != package && command != save.

Adja meg a Tiller-tanúsítványt vagy a Helm-ügyféltanúsítványt.

privatekey - Kulcs
string. Akkor szükséges, ha enableTls == true && command != login && command != logout && command != package && command != save.

Adja meg a Tiller vagy a Helm ügyfélkulcsot.

tillernamespace - Tiller-névtér
string. Választható. Használja a következőt: command != login && command != logout && command != package && command != save.

Adja meg Tiller Kubernetes-névterét.

failOnStderr - Hiba standard hiba miatt
boolean. Választható. Használja a következőt: command != login && command != logout && command != package && command != save. Alapértelmezett érték: false.

Ha ez a bemenet , trueez a feladat meghiúsul, ha a hibafolyamatba bármilyen hiba van beírva, vagy ha bármilyen adat a Standard hibafolyamba van írva. Ellenkező esetben a feladat a kilépési kódra támaszkodik a hiba meghatározásához.

publishPipelineMetadata - Folyamat metaadatainak közzététele
boolean. Választható. Használja a következőt: command != login && command != logout && command != package && command != save. Alapértelmezett érték: true.

Ha ez a bemenet, truea feladat összegyűjti és közzéteszi az üzembehelyezési metaadatokat.

chartNameForACR - Diagram neve Azure Container Registry
string. Akkor szükséges, ha command == save.

A diagram neve a Azure Container Registry.

chartPathForACR - Diagram elérési útja Azure Container Registry
string. Akkor szükséges, ha command == save.

A diagram könyvtárának elérési útja a Azure Container Registry.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

helmExitCode
A megadott Helm-parancs végrehajtásából kibocsátott kilépési kód.

helmOutput
A megadott Helm-parancs végrehajtásából kibocsátott kimenet.

Megjegyzések

A Helm-parancsok futtatásával a HelmDeploy@0 használatával helyezhet üzembe, konfigurálhat vagy frissíthet Kubernetes-fürtöt az Azure Container Service-ben. A Helm egy olyan eszköz, amely leegyszerűsíti a Kubernetes-alkalmazások üzembe helyezését és kezelését a diagramok nevű csomagolási formátum használatával.

A Helm használatával meghatározhatja, verziószámozhatja, megoszthatja, telepítheti és frissítheti még a legösszetettebb Kubernetes-alkalmazást is.

• A Helm segítségével több Kubernetes-jegyzékfájlt (yaml) kombinálhat, például a szolgáltatást, az üzembe helyezéseket, a konfigurációtérképeket és egyebeket egyetlen egységben, Helm-diagramok néven. Nem kell tokenizálást vagy templatáló eszközt létrehoznia vagy használnia.
• A Helm-diagramok segítségével kezelheti az alkalmazásfüggőségeket és üzembe helyezheti azokat, valamint egységként visszaállíthatja azokat. Emellett egyszerűen létrehozható, verziószámozhat, közzétehet és megosztható más partnercsapatokkal.

Az Azure Pipelines beépített támogatást nyújt a Helm-diagramokhoz:

• A Helm-eszköz telepítőfeladatával telepítheti a Helm megfelelő verzióját az ügynökökre.
• A Helm-csomag és az üzembe helyezés feladat használható az alkalmazás csomagolására és kubernetes-fürtön való üzembe helyezésére. A feladattal telepítheti vagy frissítheti a Tillert egy Kubernetes-névtérre, biztonságosan csatlakozhat a Tillerhez TLS-en keresztül a diagramok üzembe helyezéséhez, vagy futtathat bármilyen Helm-parancsot, például a lintet.
• A Helm-feladat azure-szolgáltatáskapcsolattal támogatja a Azure Kubernetes Service való csatlakozást. Bármely Kubernetes-fürthöz csatlakozhat a kubeconfig vagy egy szolgáltatásfiók használatával.
• A Helm-üzemelő példányok a Kubectl-feladattal kiegészíthetők; például létrehozás/frissítés, imagepullsecret és egyebek.

Szolgáltatáskapcsolat

HelmDeploy@0 két szolgáltatáskapcsolattípussal működik: az Azure Resource Manager és a Kubernetes Service Connection szolgáltatással. Példák a két kapcsolattípus konfigurálására.

Megjegyzés

Nincs szükség szolgáltatáskapcsolatra, ha egy Kubernetes-fürtre hivatkozó környezeti erőforrás már meg van adva a folyamat szakaszában.

Kubernetes-szolgáltatáskapcsolati szempontok az AKS elérésekor

Kubernetes-szolgáltatáskapcsolatot az alábbi lehetőségek bármelyikével hozhat létre.

• KubeConfig
• Szolgáltatásfiók
• Azure-előfizetés

Az Azure-előfizetés lehetőség kiválasztásakor a Kubernetesnek elérhetőnek kell lennie az Azure DevOps számára a szolgáltatáskapcsolat konfigurálásakor. Előfordulhat, hogy a szolgáltatáskapcsolat nem hozható létre, például privát fürtöt hozott létre , vagy a fürt helyi fiókjai le vannak tiltva. Ezekben az esetekben az Azure DevOps nem tud csatlakozni a fürthöz a szolgáltatáskapcsolat konfigurálásakor, és elakadt a Névterek betöltése képernyő.

A Kubernetes 1.24-től kezdve a hosszú élettartamú tokenek alapértelmezés szerint nem jönnek létre. A Kubernetes a hosszú élettartamú tokenek használatát javasolja. Ennek eredményeképpen az Azure-előfizetés beállítással létrehozott Kubernetes-szolgáltatáskapcsolatot használó feladatok nem rendelkeznek hozzáféréssel a hitelesítéshez szükséges állandó jogkivonathoz, és nem férhetnek hozzá a Kubernetes-fürthöz. Ez a névterek befagyasztott betöltése párbeszédpanelt is eredményezi.

Az Azure Resource Manager Service Connection használata az AKS eléréséhez

Az AKS-ügyfelek számára az Azure Resource Manager szolgáltatás kapcsolattípusa biztosítja a legjobb módszert egy privát fürthöz vagy egy olyan fürthöz való csatlakozáshoz, amelynél a helyi fiókok le vannak tiltva. Ez a módszer nem függ a fürtkapcsolattól a szolgáltatáskapcsolat létrehozásakor. Az AKS-hez való hozzáférést a rendszer a folyamat futtatókörnyezetére halasztja, ami az alábbi előnyökkel jár:

• A (privát) AKS-fürthöz való hozzáférés egy saját üzemeltetésű vagy méretezésicsoport-ügynökből, a fürt felé látóvonallal végezhető el.
• Minden olyan feladathoz létrejön egy jogkivonat, amely Azure Resource Manager szolgáltatáskapcsolatot használ. Ez biztosítja, hogy rövid élettartamú jogkivonattal csatlakozzon a Kuberneteshez, amely a Kubernetes-javaslat.
• Az AKS akkor is elérhető, ha a helyi fiókok le vannak tiltva.

Szolgáltatáskapcsolat – gyakori kérdések

A következő hibaüzenetet kapom: Nem található a szolgáltatásfiókhoz társított titkos kód. Mi történik?

A Kubernetes-szolgáltatás és az Azure-előfizetés közötti kapcsolatot használja. Ezt a módszert hosszú élettartamú tokenek létrehozásához frissítjük. Ez várhatóan május közepén lesz elérhető. Javasoljuk azonban, hogy kezdje el használni az Azure-szolgáltatás kapcsolattípusát, és ne használjon hosszú élettartamú jogkivonatokat a Kubernetes útmutatójának megfelelően.

AKS-t használok, és nem szeretnék módosítani semmit, használhatok-e továbbra is feladatokat a Kubernetes-szolgáltatáskapcsolattal?

Ezt a módszert hosszú élettartamú tokenek létrehozásához frissítjük. Ez várhatóan május közepén lesz elérhető. Vegye figyelembe azonban, hogy ez a megközelítés nem ellenezi a Kubernetes útmutatását.

A Kubernetes-feladatokat és a Kubernetes-szolgáltatáskapcsolatot használom, de az AKS-t nem. Aggódnom kell?

A tevékenységek a korábbiakhoz hasonlóan fognak működni.

Eltávolítja a Kubernetes-szolgáltatás kapcsolattípusát?

A Kubernetes-feladatok bármely Kubernetes-fürttel működnek, függetlenül attól, hogy hol futnak. A Kubernetes-szolgáltatáskapcsolat továbbra is fennáll.

AKS-ügyfél vagyok, és minden rendben van, cselekednem kell?

Semmit sem kell megváltoztatni. Ha a Kubernetes-szolgáltatáskapcsolatot használja, és a létrehozás során az Azure-előfizetést választotta, ismernie kell a Hosszú élettartamú tokenek használatára vonatkozó Kubernetes-útmutatót.

Kubernetes-környezetet hozok létre, és nincs lehetőségem szolgáltatáskapcsolatok használatára

Ha nem fér hozzá az AKS-hez a környezet létrehozása során, üres környezetet használhat, és beállíthatja a connectionType bemenetet egy Azure Resource Manager szolgáltatáskapcsolatra.

Az AKS az Azure Active Directory RBAC-vel van konfigurálva, és a folyamatom nem működik. Ezek a frissítések megoldják ezt?

A Kubernetes elérése, ha az AAD RBAC engedélyezve van, nem kapcsolódik a jogkivonatok létrehozásához. Az interaktív kérések elkerülése érdekében egy későbbi frissítésben támogatni fogjuk a kubelogint .

Parancsértékek

A parancs bemenete a következő Helm-parancsok egyikét fogadja el: create/delete/expose/get/init/install/login/logout/ls/package/rollback/upgrade. A példákat a Példák szakaszban találja.

Minden parancsbevitel feladatbemenetek készletére van leképezve. A tevékenységbemenetre leképezett parancsok a YAML-szintaxisblokkban és a tevékenységbeviteli táblázatban vannak kijelölve

Hibaelhárítás

A HelmDeploy-feladat "ismeretlen jelző: --wait" hibát jelez, miközben a Helm 3.0.2-es verzióján futtatja a "helm init --wait --client-only" parancsot.

A Helm 2 és a Helm 3 között van néhány kompatibilitástörő változás. Ezek egyike a tiller eltávolítását is magában foglalja, ezért helm init a parancs már nem támogatott. A Helm 3.0-snál újabb verzióinak használata esetén távolítsa el az init parancsot.

A Helm 3 használatakor, ha a System.debug értéke igaz, és a Helm-frissítés a használt parancs, a folyamat akkor is meghiúsul, ha a frissítés sikeres volt.

Ez a Helm 3 ismert problémája, mivel a program naplókat ír az stderrbe. Ha találhatók naplók az stderrben, illetve a kilépési kód nem nulla értékű, a rendszer sikertelennek jelzi a Helm üzembehelyezési feladatát. Az stderrbe írt naplók figyelmen kívül hagyásához állítsa a feladat bemenetét failOnStderr: false (hamis) értékre.

Példák

Azure Resource Manager

Ez a YAML-példa bemutatja, hogyan használja az Azure Resource Manager a Kubernetes-fürtre való hivatkozáshoz. Ez a helm-parancsok egyikével és a parancshoz szükséges megfelelő értékekkel használható:

variables:
  azureSubscriptionEndpoint: Contoso
  azureContainerRegistry: contoso.azurecr.io
  azureResourceGroup: Contoso
  kubernetesCluster: Contoso

- task: HelmDeploy@0
  displayName: Helm deploy
  inputs:
    connectionType: Azure Resource Manager
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)

Kubernetes-szolgáltatáskapcsolat

Ez a YAML-példa bemutatja, hogyan használható a Kubernetes-szolgáltatáskapcsolat a Kubernetes-fürtre való hivatkozáshoz. Ez a helm-parancsok egyikével és a parancshoz szükséges megfelelő értékekkel használható:

- task: HelmDeploy@0
  displayName: Helm deploy
  inputs:
    connectionType: Kubernetes Service Connection
    kubernetesServiceEndpoint: Contoso

Parancsok

A parancs bemenete a következő Helm-parancsok egyikét fogadja el: create/delete/expose/get/init/install/login/logout/ls/package/rollback/upgrade.

Ez a YAML-példa az ls parancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm list
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: ls
    arguments: --all

init parancs

Ez a YAML-példa az init parancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm init
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: init
    upgradetiller: true
    waitForExecution: true
    arguments: --client-only

install parancs

Ez a YAML-példa a telepítési parancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm install
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: install
    chartType: FilePath
    chartPath: Application/charts/sampleapp

package command

Ez a YAML-példa a csomagparancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm package
  inputs:
    command: package
    chartPath: Application/charts/sampleapp
    destination: $(Build.ArtifactStagingDirectory)

upgrade parancs

Ez a YAML-példa a frissítési parancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm upgrade
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: upgrade
    chartType: filepath
    chartPath: $(Build.ArtifactStagingDirectory)/sampleapp-v0.2.0.tgz
    releaseName: azuredevopsdemo
    install: true
    waitForExecution: false

save parancs

Ez a YAML-példa a save parancsot mutatja be:

- task: HelmDeploy@0
  displayName: Helm save
  inputs:
    command: save
    chartNameForACR: mycontainerregistry.azurecr.io/helm/hello-world:v1
    chartPathForACR: Application/charts/sampleapp
    azureSubscriptionEndpointForACR: $(azureSubscriptionEndpointForACR)
    azureResourceGroupForACR: $(azureResourceGroupForACR)
    azureContainerRegistry: $(azureContainerRegistry)

Helm-diagramok csomagolása és aláírása

Ebben a szakaszban megtudhatja, hogyan csomagolhat és írhat alá Helm-diagramokat egy folyamatban.

Privát-nyilvános kulcspár létrehozása a helm-diagram GPG használatával történő aláírásához

1. Töltse le a GPG-t.

2. Indítsa el a parancssort rendszergazdai módban. Futtassa a következő parancsot egy privát-nyilvános kulcspár létrehozásához a helm-diagram gpg használatával történő aláírásához. A kulcs létrehozásakor a rendszer kérni fogja a felhasználónevet és az e-mail-címet. A "név e-mail-cím" később a létrehozott privát-nyilvános kulcspár elnevezésére szolgál.

   gpg --full-generate-key
   

   

3. A rendszer kérni fogja a jelszót. Adja meg az értéket, és kattintson az OK gombra.

   

4. A kulcs létrehozása után az alábbi paranccsal láthatja a titkos és a nyilvános kulcsokat tartalmazó kulcsok listáját.

   • A titkos kulcsok listájának megtekintése

     gpg --list-secret-keys
     

     

   • A nyilvános kulcsok listájának megtekintése

     gpg --list-keys
     

     

5. A privát és a nyilvános kulcsokat 2 különböző fájlban tárolja a gpg kiterjesztéssel az alábbiak szerint.

   • Titkos kulcs esetén

   gpg --export-secret-key 94325E18E53EDD99DD8339C3CFD9DAF0707CB788 contoso@microsoft.com > C:/somepath/privatekeys.gpg
   

   A fent említett elérési útra exportált privatekeys.gpg fájl látható.

   • Nyilvános kulcs esetén

   gpg --export-key 94325E18E53EDD99DD8339C3CFD9DAF0707CB788 contoso@microsoft.com > C:/somepath/publickey.gpg
   

   Ekkor megjelenik a publickey.gpg fájl exportálva a fent említett elérési útra.

Az Azure DevOpsban mentse a privatekey.gpg fájlt a tár biztonságos fájljai szakaszban.

Példa

pool:
  name: Hosted Ubuntu 1604

variables:
  # The below variable should be secure
  HelmKeyPassphrase: contoso@123
  keyName: contoso contoso@microsoft.com
  azureSubscriptionEndpoint: contoso
  azureResourceGroup: contoso
  kubernetesCluster: contoso

steps:
- task: DownloadSecureFile@1
  displayName: Download Secure file
  inputs:
    secureFile: privatekey.gpg
  name: privateKeyRing

- task: HelmInstaller@0
  displayName: Install Helm 2.12.0
  inputs:
    helmVersion: 2.12.0

- task: HelmDeploy@0
  displayName: helm init
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: init
    arguments: --client-only

- task: HelmDeploy@0
  displayName: helm package
  inputs:
    command: package
    chartPath: Application/charts/sampleapp
    arguments: --sign --key "$(keyName)" --keyring $(privateKeyRing.secureFilePath)
  env:
    HelmKeyPassphrase: $(HelmKeyPassphrase)

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	Minden támogatott ügynökverzió.
Feladatkategória	Üzembe helyezés