Atualizar o registro de contêiner no Hub de Azure StackUpdate the container registry in Azure Stack Hub

Os usuários do hub de Azure Stack podem atualizar sua implantação de registro de contêiner para uma SKU de imagem de base AKS mais recente usando as instruções abaixo.Azure Stack Hub users can update their container registry deployment to a more recent AKS Base Image SKU using the instructions below. A VM do modelo do registro de contêiner e o serviço são sem estado, pois todas as imagens de contêiner e de estado são armazenadas no armazenamento de BLOBs.The container registry template VM and service are stateless as all the state and container images are stored in blob storage. Uma atualização é tão simples quanto implantar o modelo de registro de contêiner com uma versão mais recente do VHD de imagem de base AKS e Reapontar o DNS para a nova VM.An update is as simple as deploying the Container registry template with a more recent version of the AKS Base Image VHD and repointing DNS to the new VM. A ação de atualizar o valor DNS para as novas VMs de modelo de registro de contêiner antigo e novo resultará em uma pequena janela de conectividade de registro intermitente enquanto os valores se propagam.The action of updating the DNS value for the old and new Container registry template VMs will result in small window of intermittent registry connectivity while the values propagate.

Pré-requisitosPrerequisites

OperadorOperator

  • Sindicar a imagem base AKS mais recente do Azure Stack Marketplace.Syndicate the latest AKS Base Image from the Azure Stack Marketplace. A imagem base AKS é atualizada em uma cadência mensal.The AKS Base Image is updated on a monthly cadence.

    Imagem base do AKS

UsuárioUser

  1. Verifique o SKU da imagem base AKS que foi usada para implantar o modelo de registro de contêiner navegando até o registro de implantação no grupo de recursos e selecione entradas.Check the SKU of the AKS Base Image that was used to deploy the container registry template by browsing to the deployment record in the resource group and select Inputs.

    Entradas

  2. Determine se há SKUs mais recentes da imagem base AKS disponível usando a função Get-VMImageSku , exigida Import-Module .\pre-reqs.ps1 dos scripts de modelo de registro de contêiner.Determine if there are newer SKUs of the AKS Base Image available using the Get-VMImageSku function, requires Import-Module .\pre-reqs.ps1 from the container registry template scripts.

    PS C:\azurestack-galler-master\registry\Scripts> Get-VMImageSku -Location Shanghai
    
    Skus                  
    ----                  
    aks-ubuntu-1604-201909
    aks-ubuntu-1604-201910 
    

Parâmetros necessáriosParameters required

ParâmetroParameter DetalhesDetails
Nome de UsuárioUsername Forneça o nome de usuário para fazer logon na VM.Provide the username for logging into the VM.
Chave pública SSHSSH Public Key Forneça a chave pública SSH usada para autenticar com a VM usando o protocolo SSH.Provide the SSH Public key used to authenticate with the VM using SSH protocol.
TamanhoSize Selecione o tamanho da VM a ser implantada.Select the size of the VM to deploy.
Endereço IP públicoPublic IP Address Especifique o nome e o tipo de endereço IP (dinâmico/estático) para essa VM.Specify the name and type of IP address (Dynamic / Static) for this VM.
Rótulo do nome de domínioDomain name label Especifique o prefixo DNS para o registro.Specify the DNS prefix for your registry. Esse FQDN inteiro deve corresponder ao valor CN para o certificado PFX criado para o registro.This entire FQDN should match the CN value for the PFX certificate created for the registry.
RéplicasReplicas Especifique o número de réplicas de contêiner a serem iniciadas.Specify the number of container replicas to start.
SKU de imagemImage SKU Especifique a SKU da imagem a ser usada para a implantação.Specify the Image SKU to be used for the deployment. Os SKUs disponíveis para a imagem de base AKS são listados pelo cmdlet do PowerShell Get-VMImageSku .The available SKUs for the AKS Base Image are listed by Get-VMImageSku PowerShell cmdlet.
ID do cliente da entidade de serviçoService Principal Client ID Especifique a ID do aplicativo SPN (entidade de serviço) como usada na implantação anterior.Specify the service principal (SPN) App ID as used in the previous deployment.
Senha da entidade de serviço/Confirmar senhaService Principal Password / Confirm Password Especifique o segredo da ID do aplicativo SPN como usado na implantação anterior.Specify the SPN App ID Secret as used in the previous deployment.
ID de recurso da conta de armazenamento estendida existenteExisting extended storage Account resource ID Especifique a ID de recurso da conta de armazenamento como usada na implantação anterior.Specify the storage account resource ID as used in the previous deployment.
Contêiner de blob de back-end existenteExisting backend blob container Especifique o nome do contêiner de BLOBs como usado na implantação anterior.Specify the blob container name as used in the previous deployment.
ID de recurso de Key Vault de certificado PFXPFX Certificate Key Vault Resource ID Especifique o Microsoft Azure Key Vault ID de recurso conforme usado na implantação anterior.Specify the Microsoft Azure Key Vault resource ID as used in the previous deployment.
URL de segredo de Key Vault de certificado PFXPFX Certificate Key Vault Secret URL Especifique a URL do certificado como usada na implantação anterior.Specify the certificate URL as used in the previous deployment.
Impressão digital do certificado PFXPFX Certificate Thumbprint Especifique a impressão digital do certificado como usada na implantação anterior.Specify the certificate thumbprint as used in the previous deployment.

InstalaçãoInstallation

  1. Instale uma nova instância do modelo de registro de contêiner para um novo grupo de recursos.Install a new instance of the Container registry template to a new resource group.

    Instalar novo modelo de registro de contêiner

  2. Especifique a última saída de SKU do Get-VMImage script e use um parâmetro DnsName exclusivo da instalação inicial na configuração da máquina virtual, use a mesma entidade de serviço e segredo que a instalação inicial.Specify the latest SKU output from the Get-VMImage script and use a unique dnsname parameter from the initial install in the virtual machine configuration, use the same service principal and secret as the initial install.

    Especificar SKU

  3. Use os mesmos parâmetros de armazenamento e Key Vault como a instalação inicial para o armazenamento e a configuração de Key Vault.Use the same storage and Key Vault parameters as the initial install for the storage and Key Vault configuration.

    Adicionar armazenamento

  4. Depois que o novo modelo de registro de contêiner tiver sido implantado, navegue até o grupo de recursos inicial e selecione o recurso de endereço IP público.Once the new container registry template has been deployed, navigate to the initial resource group and select the public IP address resource.

    Selecionar IP

  5. No recurso de endereço IP público, navegue até configuração e modifique o rótulo de nome DNS para que ele possa ser usado para o recurso de implantação nova.In the public IP address resource navigate to Configuration and modify the DNS Name label so it can be used for the newly deploy resource. Observe que, depois que você modificar o rótulo de nome DNS e selecionar salvar chamadas para o registro de contêiner, começará a falhar.Note once you modify the DNS Name label and select Save calls to the Container Registry will begin to fail.

    Alterar rótulo DNS

    Salvar alteração

  6. Navegue até o novo grupo de recursos usado para implantar a nova instância do modelo de registro de contêiner, selecione o recurso IP público, configuração e atualize o rótulo de nome DNS para o nome correto usado na implantação original, neste exemplo myreg , e selecione salvar.Navigate to the new resource group used to deploy the new instance of the container registry template, select the public IP resource, configuration, and update the DNS name label to the correct name used in the original deployment, in this example myreg, and select Save.

    Selecionar configuração

    Salvar configuração

  7. Nos próximos 30 minutos haverá acesso intermitente ao registro de contêiner, pois o registro DNS é propagado.For the next 30 minutes there will be intermittent access to the container registry as the DNS record is propagated. Valide a conexão fazendo logon no registro do Docker e retirando/enviando uma imagem.Validate connection by logging into the Docker registry and pulling / pushing an image.

Próximas etapasNext steps

Visão geral do Azure Stack MarketplaceAzure Stack Marketplace overview