Azure Container Registry gebruiken als een helm-opslag plaats voor uw toepassings grafiekenUse Azure Container Registry as a Helm repository for your application charts

Als u snel toepassingen wilt beheren en implementeren voor Kubernetes, kunt u het open-source helm-pakket beheergebruiken.To quickly manage and deploy applications for Kubernetes, you can use the open-source Helm package manager. Met helm worden toepassingen gedefinieerd als grafieken die zijn opgeslagen in een helm-grafiek opslagplaats.With Helm, applications are defined as charts that are stored in a Helm chart repository. In deze grafieken worden configuraties en afhankelijkheden gedefinieerd, en kan de versie worden gedistribueerd gedurende de levens cyclus van de toepassing.These charts define configurations and dependencies, and can be versioned throughout the application lifecycle. Azure Container Registry kunnen als host worden gebruikt voor helm-grafiek opslagplaatsen.Azure Container Registry can be used as the host for Helm chart repositories.

Met Azure Container Registry hebt u een persoonlijke, beveiligde helm-grafiek opslagplaats die kan worden geïntegreerd met Build-pijp lijnen of andere Azure-Services.With Azure Container Registry, you have a private, secure Helm chart repository, that can integrate with build pipelines or other Azure services. Helm-grafiek opslagplaatsen in Azure Container Registry functies van geo-replicatie bevatten om ervoor te zorgen dat uw grafieken dicht bij implementaties en voor redundantie worden bewaard.Helm chart repositories in Azure Container Registry include geo-replication features to keep your charts close to deployments and for redundancy. U betaalt alleen voor de opslag die wordt gebruikt door de grafieken en zijn beschikbaar in alle Azure Container Registry prijs categorieën.You only pay for the storage used by the charts, and are available across all Azure Container Registry price tiers.

In dit artikel leest u hoe u een helm-grafiek opslagplaats kunt gebruiken die is opgeslagen in Azure Container Registry.This article shows you how to use a Helm chart repository stored in Azure Container Registry.

Belangrijk

Deze functie is momenteel beschikbaar als preview-product.This feature is currently in preview. Previews worden voor u beschikbaar gesteld op voorwaarde dat u akkoord gaat met de aanvullende gebruiksvoorwaarden.Previews are made available to you on the condition that you agree to the supplemental terms of use. Sommige aspecten van deze functie worden mogelijk nog gewijzigd voordat de functie algemeen beschikbaar wordt.Some aspects of this feature may change prior to general availability (GA).

Voordat u begintBefore you begin

Als u de stappen in dit artikel wilt uitvoeren, moet aan de volgende vereisten worden voldaan:To complete the steps in this article, the following pre-requisites must be met:

  • Azure container Registry : een container register maken in uw Azure-abonnement.Azure Container Registry - Create a container registry in your Azure subscription. Gebruik bijvoorbeeld de Azure Portal of de Azure cli.For example, use the Azure portal or the Azure CLI.
  • Helm client versie 2.11.0 (geen RC-versie) of later -Voer helm version uit om uw huidige versie te vinden.Helm client version 2.11.0 (not an RC version) or later - Run helm version to find your current version. U hebt ook een helm-server (Tiller) nodig die is geïnitialiseerd in een Kubernetes-cluster.You also need a Helm server (Tiller) initialized within a Kubernetes cluster. Als dat nodig is, kunt u een Azure Kubernetes-service cluster maken.If needed, you can create an Azure Kubernetes Service cluster. Zie Installing helm(Engelstalig) voor meer informatie over het installeren en upgraden van helm.For more information on how to install and upgrade Helm, see Installing Helm.
  • Azure CLI-versie 2.0.46 of later -Voer az --version uit om de versie te vinden.Azure CLI version 2.0.46 or later - Run az --version to find the version. Zie Azure CLI installeren als u de CLI wilt installeren of een upgrade wilt uitvoeren.If you need to install or upgrade, see Install Azure CLI.

Een opslag plaats toevoegen aan de helm-clientAdd a repository to Helm client

Een helm-opslag plaats is een HTTP-server die helm-grafieken kan opslaan.A Helm repository is an HTTP server that can store Helm charts. Azure Container Registry kunt deze opslag voor helm-grafieken opgeven en de index definitie beheren wanneer u grafieken toevoegt aan of verwijdert uit de opslag plaats.Azure Container Registry can provide this storage for Helm charts, and manage the index definition as you add and remove charts to the repository.

Als u uw Azure Container Registry wilt toevoegen als een helm-grafiek opslagplaats, gebruikt u de Azure CLI.To add your Azure Container Registry as a Helm chart repository, you use the Azure CLI. Met deze methode wordt uw helm-client bijgewerkt met de URI en referenties voor de opslag plaats die wordt ondersteund door Azure Container Registry.With this approach, your Helm client is updated with the URI and credentials for the repository backed by Azure Container Registry. U hoeft deze opslagplaats gegevens niet hand matig op te geven, zodat de referenties niet worden weer gegeven in de opdracht geschiedenis.You don't need to manually specify this repository information, so the credentials aren't exposed in the command history, for example.

Als dat nodig is, meldt u zich aan bij de Azure CLI en volgt u de prompts:If needed, log in to the Azure CLI and follow the prompts:

az login

Configureer de standaard instellingen van Azure CLI met de naam van uw Azure Container Registry met behulp van de opdracht AZ configure .Configure the Azure CLI defaults with the name of your Azure Container Registry using the az configure command. Vervang <acrName> in het volgende voor beeld door de naam van uw REGI ster:In the following example, replace <acrName> with the name of your registry:

az configure --defaults acr=<acrName>

Voeg nu uw Azure Container Registry helm-grafiek opslagplaats toe aan uw helm-client met behulp van de opdracht AZ ACR helm opslag plaats add .Now add your Azure Container Registry Helm chart repository to your Helm client using the az acr helm repo add command. Met deze opdracht wordt een verificatie token opgehaald voor uw Azure container Registry dat door de helm-client wordt gebruikt.This command gets an authentication token for your Azure container registry that is used by the Helm client. Het verificatie token is 1 uur geldig.The authentication token is valid for 1 hour. Net als bij docker login, kunt u deze opdracht uitvoeren in toekomstige CLI-sessies om uw helm-client te verifiëren met uw Azure Container Registry helm-grafiek opslagplaats:Similar to docker login, you can run this command in future CLI sessions to authenticate your Helm client with your Azure Container Registry Helm chart repository:

az acr helm repo add

Een grafiek toevoegen aan de opslag plaatsAdd a chart to the repository

Voor dit artikel halen we een bestaand helm-diagram van de open bare helm stabiele opslag plaats.For this article, let's get an existing Helm chart from the public Helm stable repo. De stabiele opslag plaats is een gecuratore, open bare opslag plaats die algemene toepassings grafieken bevat.The stable repo is a curated, public repo that includes common application charts. Pakket maintainers kunnen hun grafieken verzenden naar de stabiele opslag plaats, op dezelfde manier als docker hub een openbaar REGI ster voor algemene container installatie kopieën biedt.Package maintainers can submit their charts to the stable repo, in the same way that Docker Hub provides a public registry for common container images. De grafiek die is gedownload van de open bare stabiele opslag plaats kan vervolgens worden gepusht naar uw persoonlijke Azure container Registry-opslag plaats.The chart downloaded from the public stable repo can then be pushed to your private Azure Container Registry repository. In de meeste scenario's bouwt en uploadt u uw eigen grafieken voor de toepassingen die u ontwikkelt.In most scenarios, you would build and upload your own charts for the applications you develop. Zie helm-grafieken ontwikkelenvoor meer informatie over het bouwen van uw eigen helm-grafieken.For more information on how to build your own Helm charts, see developing Helm charts.

Maak eerst een directory op ~/ACR-helmen down load vervolgens de bestaande stabiele/WordPress- grafiek:First, create a directory at ~/acr-helm, then download the existing stable/wordpress chart:

mkdir ~/acr-helm && cd ~/acr-helm
helm fetch stable/wordpress

Geef de gedownloade grafiek weer en noteer de WordPress-versie die is opgenomen in de bestands naam.List the downloaded chart, and note the Wordpress version included in the filename. De helm fetch stable/wordpress-opdracht heeft geen bepaalde versie opgegeven, waardoor de meest recente versie is opgehaald.The helm fetch stable/wordpress command didn't specify a particular version, so the latest version was fetched. Alle helm-grafieken bevatten een versie nummer in de bestands naam die volgt op de SemVer 2 -standaard.All Helm charts include a version number in the filename that follows the SemVer 2 standard. In de volgende voorbeeld uitvoer is het WordPress-diagram versie 2.1.10:In the following example output, the Wordpress chart is version 2.1.10:

$ ls

wordpress-2.1.10.tgz

Push het diagram nu naar uw helm-grafiek opslagplaats in Azure Container Registry met behulp van de Azure CLI AZ ACR helm push opdracht.Now push the chart to your Helm chart repository in Azure Container Registry using the Azure CLI az acr helm push command. Geef de naam op van uw helm-grafiek die in de vorige stap is gedownload, zoals WordPress-2.1.10. tgz:Specify the name of your Helm chart downloaded in the previous step, such as wordpress-2.1.10.tgz:

az acr helm push wordpress-2.1.10.tgz

Na enkele ogen blikken rapporteert de Azure CLI dat uw grafiek is opgeslagen, zoals wordt weer gegeven in de volgende voorbeeld uitvoer:After a few moments, the Azure CLI reports that your chart has been saved, as shown in the following example output:

$ az acr helm push wordpress-2.1.10.tgz

{
  "saved": true
}

Grafieken weer geven in de opslag plaatsList charts in the repository

De helm-client onderhoudt een lokaal in cache opgeslagen kopie van de inhoud van externe opslag plaatsen.The Helm client maintains a local cached copy of the contents of remote repositories. Wijzigingen in een externe opslag plaats worden de lijst met beschik bare grafieken die lokaal door de helm-client bekend zijn, niet automatisch bijgewerkt.Changes to a remote repository don't automatically update the list of available charts known locally by the Helm client. Wanneer u zoekt naar grafieken in opslag plaatsen, gebruikt helm de lokale index in de cache.When you search for charts across repositories, Helm uses it's local cached index. Als u de grafiek wilt gebruiken die in de vorige stap is geüpload, moet de lokale helm-opslagplaats index worden bijgewerkt.To use the chart uploaded in the previous step, the local Helm repository index must be updated. U kunt de opslag plaatsen in de helm-client opnieuw indexeren of de Azure CLI gebruiken om de opslag plaats-index bij te werken.You can reindex the repositories in the Helm client, or use the Azure CLI to update the repository index. Telkens wanneer u een grafiek aan uw opslag plaats toevoegt, moet deze stap worden voltooid:Each time you add a chart to your repository, this step must be completed:

az acr helm repo add

Als er een grafiek is opgeslagen in uw opslag plaats en de bijgewerkte index lokaal beschikbaar is, kunt u de reguliere helm-client opdrachten gebruiken om te zoeken of te installeren.With a chart stored in your repository and the updated index available locally, you can use the regular Helm client commands to search or install. Als u alle grafieken in uw opslag plaats wilt weer geven, gebruikt u helm search <acrName>.To see all the charts in your repository, use helm search <acrName>. Geef uw eigen Azure Container Registry naam op:Provide your own Azure Container Registry name:

helm search <acrName>

Het WordPress-diagram dat in de vorige stap is gepusht, wordt weer gegeven, zoals wordt weer gegeven in de volgende voorbeeld uitvoer:The Wordpress chart pushed in the previous step is listed, as shown in the following example output:

$ helm search myacrhelm

NAME                CHART VERSION   APP VERSION DESCRIPTION
helmdocs/wordpress  2.1.10          4.9.8       Web publishing platform for building blogs and websites.

U kunt de grafieken ook weer geven met de Azure CLI met behulp van AZ ACR helm List:You can also list the charts with the Azure CLI, using az acr helm list:

az acr helm list

Informatie voor een helm-grafiek weer gevenShow information for a Helm chart

Als u informatie wilt weer geven voor een specifieke grafiek in de opslag plaats, kunt u de gewone helm-client opnieuw gebruiken.To view information for a specific chart in the repo, you can again use the regular Helm client. Gebruik helm inspectom informatie weer te geven voor de grafiek met de naam WordPress.To see information for the chart named wordpress, use helm inspect.

helm inspect <acrName>/wordpress

Wanneer er geen versie nummer wordt gegeven, wordt de meest recente versie gebruikt.When no version number is provided, the latest version is used. Helm retourneert gedetailleerde informatie over uw grafiek, zoals wordt weer gegeven in de volgende verkorte voorbeeld uitvoer:Helm returns detailed information about your chart, as shown in the following condensed example output:

$ helm inspect myacrhelm/wordpress

appVersion: 4.9.8
description: Web publishing platform for building blogs and websites.
engine: gotpl
home: https://www.wordpress.com/
icon: https://bitnami.com/assets/stacks/wordpress/img/wordpress-stack-220x234.png
keywords:
- wordpress
- cms
- blog
- http
- web
- application
- php
maintainers:
- email: containers@bitnami.com
  name: bitnami-bot
name: wordpress
sources:
- https://github.com/bitnami/bitnami-docker-wordpress
version: 2.1.10
[...]

U kunt ook de informatie voor een grafiek weer geven met de Azure CLI AZ ACR helm show -opdracht.You can also show the information for a chart with the Azure CLI az acr helm show command. De meest recente versie van een grafiek wordt standaard geretourneerd.Again, the latest version of a chart is returned by default. U kunt --version toevoegen om een specifieke versie van een grafiek weer te geven, zoals 2.1.10:You can append --version to list a specific version of a chart, such as 2.1.10:

az acr helm show wordpress

Een helm-grafiek installeren vanuit de opslag plaatsInstall a Helm chart from the repository

Het helm-diagram in uw opslag plaats wordt geïnstalleerd door de naam van de opslag plaats en de naam van de grafiek op te geven.The Helm chart in your repository is installed by specifying the repository name and then chart name. Gebruik de helm-client om het WordPress-diagram te installeren:Use the Helm client to install the Wordpress chart:

helm install <acrName>/wordpress

Tip

Als u naar uw Azure Container Registry helm-grafiek opslagplaats pusht en later terugkeert in een nieuwe CLI-sessie, moet uw lokale helm-client een bijgewerkt verificatie token hebben.If you push to your Azure Container Registry Helm chart repository and later return in a new CLI session, your local Helm client needs an updated authentication token. Als u een nieuw verificatie token wilt verkrijgen, gebruikt u de opdracht AZ ACR helm opslag plaats add .To obtain a new authentication token, use the az acr helm repo add command.

De volgende stappen zijn voltooid tijdens het installatie proces:The following steps are completed during the install process:

  • De helm-client zoekt in de index van de lokale opslag plaats.The Helm client searches the local repository index.
  • De bijbehorende grafiek wordt gedownload uit de Azure Container Registry opslag plaats.The corresponding chart is downloaded from the Azure Container Registry repository.
  • De grafiek wordt geïmplementeerd met behulp van de Tiller in uw Kubernetes-cluster.The chart is deployed using the Tiller in your Kubernetes cluster.

In de volgende gecomprimeerde voorbeeld uitvoer ziet u de Kubernetes-resources die zijn geïmplementeerd via de helm-grafiek:The following condensed example output shows the Kubernetes resources deployed through the Helm chart:

$ helm install myacrhelm/wordpress

NAME:   irreverent-jaguar
LAST DEPLOYED: Thu Sep 13 21:44:20 2018
NAMESPACE: default
STATUS: DEPLOYED

RESOURCES:
==> v1/Pod(related)
NAME                                          READY  STATUS   RESTARTS  AGE
irreverent-jaguar-wordpress-7ff46d9b8c-b7v6m  0/1    Pending  0         1s
irreverent-jaguar-mariadb-0                   0/1    Pending  0         1s
[...]

Een helm-grafiek verwijderen uit de opslag plaatsDelete a Helm chart from the repository

Als u een grafiek uit de opslag plaats wilt verwijderen, gebruikt u de opdracht AZ ACR helm delete .To delete a chart from the repository, use the az acr helm delete command. Geef de naam op van de grafiek, zoals WordPress, en de versie die u wilt verwijderen, zoals 2.1.10.Specify the name of the chart, such as wordpress, and the version to delete, such as 2.1.10.

az acr helm delete wordpress --version 2.1.10

Als u alle versies van het genoemde diagram wilt verwijderen, moet u de para meter --version weglaten.If you wish to delete all versions of the named chart, leave out the --version parameter.

De grafiek blijft in helm search <acrName>worden geretourneerd.The chart continues to be returned in helm search <acrName>. De helm-client werkt de lijst met beschik bare grafieken in een opslag plaats niet automatisch bij.Again, the Helm client doesn't automatically update the list of available charts in a repository. Als u de helm-client opslag plaats-index wilt bijwerken, gebruikt u de opdracht AZ ACR helm opslag plaats add opnieuw:To update the Helm client repo index, use the az acr helm repo add command again:

az acr helm repo add

Volgende stappenNext steps

In dit artikel wordt een bestaand helm-diagram gebruikt uit de open bare stabiele opslag plaats.This article used an existing Helm chart from the public stable repository. Zie helm-grafieken ontwikkelenvoor meer informatie over het maken en implementeren van helm-grafieken.For more information on how to create and deploy Helm charts, see Developing Helm charts.

Helm-grafieken kunnen worden gebruikt als onderdeel van het bouw proces van de container.Helm charts can be used as part of the container build process. Zie Azure container Registry-taken gebruikenvoor meer informatie.For more information, see use Azure Container Registry Tasks.

Zie de Best practicesvoor meer informatie over het gebruik en beheer van Azure container Registry.For more information on how to use and manage Azure Container Registry, see the best practices.