Installera Azure Container Registry på Azure Stack Hub

Du kan installera Azure Container Registry på Azure Stack Hub och göra det tillgängligt för dina användare så att de kan vara värdar för containrar i din miljö. Om du vill installera Azure Container Registry måste du generera och verifiera ett certifikat och sedan installera Azure Container Registry. Du kan installera via Azure Stack Hub-administratörsportalen.

Viktigt!

När azure containerregistret har installerats på Azure Stack Hub betraktas det som en grundläggande RP och kan inte avinstalleras. Operatörer kan fortfarande begränsa användaråtkomsten till Container Registry-tjänsten via erbjudanden, planer och kvoter.

Förutsättningar

  • Azure Stack Hub-version
    Du kan bara aktivera Microsoft Azure Container i ett integrerat Azure Stack Hub-system som kör 2108-uppdateringen och senare versioner. Installera Azure Stack Hub-uppdateringen innan du slutför stegen i den här artikeln. Azure Container Registry-tjänsten stöds inte i Distributioner av Azure Stack Developer Kit (ASDK).

  • Certifikatkrav
    Konfigurationen av Azure Container Registry i ditt Azure Stack Hub-system lägger till en ny datasökväg som kräver ett certifikat. Certifikatet måste uppfylla samma krav som de andra certifikat som krävs för att installera och använda Azure Stack Hub.

    URI:n för det nya certifikatet bör ha följande format:

    *.azsacr.<region>.<fqdn>

    Till exempel:

    *.azsacr.azurestack.contoso.com

  • Azure Stack Hub-tillstånd
    Du bör bara installera Azure Container Registry när du har verifierat att Azure Stack Hub är felfri. Du kan göra det genom att följa stegen i Verifiera Azure Stack Hub-systemtillstånd.

Generera certifikatet

Du kan använda följande steg för att generera ett Azure Container Registry-certifikat med hjälp av verktyget Azure Stack Hub Readiness Checker. Du måste ange versionen av modulen Microsoft.AzureStack.ReadinessChecker för att stegen ska fungera.

  1. Öppna PowerShell med en upphöjd fråga.

  2. Kör följande cmdletar:

    Install-Module -Name Microsoft.AzureStack.ReadinessChecker 
    New-Item -ItemType Directory "$ENV:USERPROFILE\Documents\AzsCertRequests"
        $certificateRequestParams = @{
            'regionName' = 'azurestack'
            'externalFQDN' = 'contoso.com'
            'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"
            'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" }
    New-AzsHubAzureContainerRegistryCertificateSigningRequest @certificateRequestParams
    
  3. När modulen ReadinessChecker skapar .req-filen underordnas filen till certifikatutfärdaren (CA) (antingen intern eller offentlig). Utdatakatalogen för New-AzsCertificateSigningRequest innehåller de CSR:er som krävs för att skicka till en certifikatutfärdare. Som referens innehåller katalogen även en underordnad katalog som innehåller DE INF-filer som användes vid generering av certifikatbegäran.

Verifiera Azure Container Registry-certifikatet

Kontrollera att Azure Container Registry-certifikatet följer Kraven för Azure Stack Hub.

  1. Kopiera resulterande certifikatfil (.cer) signerad av certifikatutfärdare (tillägg som stöds .cer, .cert, .srt, .pfx) till $ENV:USERPROFILE\Documents\AzureStack.

  2. Kör följande PowerShell-cmdletar från en upphöjd prompt:

    Install-Module -Name Microsoft.AzureStack.ReadinessChecker 
    $Path = "$ENV:USERPROFILE\Documents\AzureStack"
    $pfxPassword = Read-Host -AsSecureString -Prompt "PFX Password"
    ConvertTo-AzsPFX -Path $Path -pfxPassword $pfxPassword -ExportPath $Path
    

Installationssteg

Du kan använda de här stegen för att installera Azure Container Registry-tjänsten på Azure Stack Hub.

Portalen

Du kan använda Azure Stack Hub-administratörsportalen för att importera certifikatet och installera tjänsten.

  1. Logga in på Azure Stack Hub-administratörsportalen.

  2. Gå till Alla tjänstcontainerregister>. Hämta Azure Stack Hub-containerregistret.

  3. Ange den fullständiga sökvägen till SSL-certifikatet.

  4. Ange lösenordet för certifikatet.

  5. Välj distribuera.
    Installationen av Azure Container Registry-tjänsten kan ta upp till en timme.

    Azure Stack Hub-containerregistret är installerat.

  6. När installationen har slutförts i Azure Stack Hub-administratörsportalen stänger och öppnar du bladet Container Registries igen.

När installationen är klar kan du granska eller uppdatera din kvotkapacitet i Azure Stack Hub-administratörsportalen.

Nästa steg

Översikt över Azure Container Registries på Azure Stack Hub