Quickstart: Een verbonden register maken met behulp van de Azure Portal
In deze quickstart gebruikt u de Azure Portal om een verbonden registerresource te maken in Azure. Met de verbonden registerfunctie van Azure Container Registry kunt u een register op afstand of on-premises implementeren en afbeeldingen en andere artefacten synchroniseren met het cloudregister.
Hier maakt u twee verbonden registerbronnen voor een cloudregister: één verbonden register staat lees- en schrijffunctionaliteit (artefact pull en push) toe en één voor alleen-lezen functionaliteit.
Nadat u een verbonden register hebt gemaakt, kunt u andere handleidingen volgen om het te implementeren en te gebruiken in uw on-premises of externe infrastructuur.
Vereisten
- Azure Container Registry: als u nog geen containerregister hebt, maakt u er een (Premium laag vereist) in een regio die verbonden registers ondersteunt.
Als u afbeeldingen wilt importeren in het containerregister, gebruikt u de Azure CLI: - Gebruik de bash-omgeving in Azure Cloud shell.
- Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij de Azure CLI voor aanvullende aanmeldingsopties.- Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
- Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
Het toegewezen gegevens-eindpunt voor het cloudregister inschakelen
Schakel het toegewezen gegevens-eindpunt in voor het Azure-containerregister in de cloud. Deze stap is nodig om een verbonden register te laten communiceren met het cloudregister.
- Navigeer in Azure Portalnaar uw containerregister.
- Selecteer Netwerktoegang > openbare toegang. Schakel het selectievakje Toegewezen gegevens-eindpunt inschakelen in.
- Selecteer Opslaan.
Afbeeldingen importeren in uw cloudregister
Importeer de volgende containerafbeeldingen in uw cloudregister met behulp van de opdracht az acr import. Sla deze stap over als u deze afbeeldingen al hebt geïmporteerd.
Verbonden registerafbeelding
Ter ondersteuning van geneste IoT Edge scenario's, moet de container-afbeelding voor de verbonden registerruntime beschikbaar zijn in uw persoonlijke Azure-containerregister. Gebruik de opdracht az acr import om de verbonden registerafbeelding in uw persoonlijke register te importeren.
# Use the REGISTRY_NAME variable in the following Azure CLI commands to identify the registry
REGISTRY_NAME=<container-registry-name>
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/acr/connected-registry:0.5.0
IoT Edge en API-proxy-afbeeldingen
Als u het verbonden register wilt ondersteunen op geneste IoT Edge, moet u modules implementeren voor de IoT Edge api-proxy. Importeer deze afbeeldingen in uw privéregister.
Met IoT Edge API-proxymodule kan een IoT Edge-apparaat meerdere services beschikbaar maken met behulp van het HTTPS-protocol op dezelfde poort, zoals 443.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-agent:1.2.4
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-hub:1.2.4
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-api-proxy:1.1.2
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/azureiotedge-diagnostics:1.2.4
Hallo wereld-afbeelding
Importeer de -afbeelding om het verbonden register te hello-world testen. Deze opslagplaats wordt gesynchroniseerd met het verbonden register en wordt door de verbonden register-clients binnengehaald.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Een verbonden registerresource maken voor lees- en schrijffunctionaliteit
Met de volgende stappen maakt u een verbonden register in de modus LezenSchrijven dat is gekoppeld aan het cloudregister.
- Navigeer in Azure Portalnaar uw containerregister.
- Selecteer Verbonden registers (preview) > + Maken.
- Voer de waarden in of selecteer deze in de volgende tabel en selecteer Opslaan.
| Item | Beschrijving |
|---|---|
| Bovenliggend | Selecteer Geen bovenliggend register voor een verbonden register dat is gekoppeld aan het cloudregister. |
| Modus | Selecteer LezenSchrijven. |
| Name | De verbonden registernaam moet beginnen met een letter en mag alleen alfanumerieke tekens bevatten. Deze moet 5 tot 40 tekens lang zijn en uniek zijn in de hiërarchie voor dit Azure-containerregister. |
| Eigenschappen voor logboekregistratie | Accepteer de standaardinstellingen. |
| Synchronisatie-eigenschappen | Accepteer de standaardinstellingen. Omdat er standaard geen synchronisatieplanning is gedefinieerd, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het cloudregister en het verbonden register. |
| Opslagplaatsen | Selecteer of voer de namen in van de opslagplaatsen die u in de vorige stap hebt geïmporteerd. De opgegeven opslagplaatsen worden gesynchroniseerd tussen het cloudregister en het verbonden register zodra het is geïmplementeerd. |
Belangrijk
Als u geneste scenario's wilt ondersteunen waarbij lagere lagen geen toegang tot internet hebben, moet u altijd synchronisatie van de opslagplaats acr/connected-registry toestaan. Deze opslagplaats bevat de -afbeelding voor de verbonden registerruntime.
Een verbonden registerresource maken voor alleen-lezenfunctionaliteit
Met de volgende stappen maakt u een verbonden register in de modus LezenOnly, waarvan het bovenliggende register het verbonden register is dat u in de vorige sectie hebt gemaakt. Dit verbonden register schakelt de functionaliteit alleen-lezen (artefact pull) in nadat deze is geïmplementeerd.
- Navigeer in Azure Portalnaar uw containerregister.
- Selecteer Verbonden registers (preview) > + Maken.
- Voer de waarden in of selecteer deze in de volgende tabel en selecteer Opslaan.
| Item | Beschrijving |
|---|---|
| Bovenliggend | Selecteer het verbonden register dat u eerder hebt gemaakt. |
| Modus | Selecteer LezenOnly. |
| Name | De verbonden registernaam moet beginnen met een letter en mag alleen alfanumerieke tekens bevatten. Deze moet 5 tot 40 tekens lang zijn en uniek zijn in de hiërarchie voor dit Azure-containerregister. |
| Eigenschappen voor logboekregistratie | Accepteer de standaardinstellingen. |
| Synchronisatie-eigenschappen | Accepteer de standaardinstellingen. Omdat er standaard geen synchronisatieplanning is gedefinieerd, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het cloudregister en het verbonden register. |
| Opslagplaatsen | Selecteer of voer de namen in van de opslagplaatsen die u in de vorige stap hebt geïmporteerd. De opgegeven opslagplaatsen worden gesynchroniseerd tussen het bovenliggende register en het verbonden register zodra het is geïmplementeerd. |
Verbonden registereigenschappen weergeven
Selecteer een verbonden register in de portal om de eigenschappen ervan weer te geven, zoals de verbindingsstatus (Offline, Online of Niet in orde) en of het is geactiveerd (on-premises geïmplementeerd). In het volgende voorbeeld wordt het verbonden register niet geïmplementeerd. De verbindingstoestand 'Offline' geeft aan dat deze momenteel is losgekoppeld van de cloud.
In deze weergave kunt u ook een wachtwoord genereren connection string optioneel wachtwoorden voor het synchronisatie-token genereren. Een connection string bevat configuratie-instellingen die worden gebruikt voor het implementeren van een verbonden register en het synchroniseren van inhoud met een bovenliggend register.
Volgende stappen
In deze quickstart hebt u de Azure Portal om twee verbonden registerresources te maken in Azure. Deze nieuwe verbonden registerbronnen zijn gekoppeld aan uw cloudregister en maken synchronisatie van artefacten met het cloudregister mogelijk.
Ga verder met de handleidingen voor de implementatie van verbonden registers voor meer informatie over het implementeren en gebruiken van een verbonden register in IoT Edge infrastructuur.