Atualize o registo de contentores no Azure Stack HubUpdate the container registry in Azure Stack Hub

Os utilizadores do Azure Stack Hub podem atualizar a sua implementação de registo de contentores para um SKU de imagem base AKS mais recente, utilizando 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. O modelo de registo do contentor VM e o serviço são apátridas, uma vez que todas as imagens de estado e contentores são armazenadas no armazenamento de bolhas.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 como a implementação do modelo de registo de contentores com uma versão mais recente do VHD de imagem base AKS e a repontamento de DNS para o novo 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 atualização do valor DNS para os VMs do antigo e novo modelo de registo do contentor resultará numa pequena janela de conectividade intermitente de registo 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

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

    Imagem base AKS

UtilizadorUser

  1. Verifique o SKU da Imagem Base AKS que foi utilizado para implantar o modelo de registo de contentores navegando para o registo 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 existem SKUs mais recentes da Imagem Base AKS disponíveis usando a função Get-VMImageSku, requer Import-Module .\pre-reqs.ps1 a partir dos scripts do modelo de registo do contentor.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 utilizadorUsername Forneça o nome de utilizador para iniciar sessão no VM.Provide the username for logging into the VM.
Chave pública SSHSSH Public Key Forneça a chave SSH Public usada para autenticar com o VM utilizando o protocolo SSH.Provide the SSH Public key used to authenticate with the VM using SSH protocol.
TamanhoSize Selecione o tamanho do VM para implementar.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 este VM.Specify the name and type of IP address (Dynamic / Static) for this VM.
Etiqueta de nome de domínioDomain name label Especifique o prefixo DNS para o seu registo.Specify the DNS prefix for your registry. Toda esta FQDN deve corresponder ao valor CN do certificado PFX criado para o registo.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 contentores para iniciar.Specify the number of container replicas to start.
Imagem SKUImage SKU Especifique o SKU de imagem a ser utilizado para a implantação.Specify the Image SKU to be used for the deployment. Os SKUs disponíveis para a imagem base AKS estão listados pela Get-VMImageSku PowerShell cmdlet.The available SKUs for the AKS Base Image are listed by Get-VMImageSku PowerShell cmdlet.
ID do cliente principal de serviçoService Principal Client ID Especifique o ID da aplicação principal de serviço (SPN) como usado na implementação anterior.Specify the service principal (SPN) App ID as used in the previous deployment.
Senha principal do serviço / Confirmar SenhaService Principal Password / Confirm Password Especifique o Ficheiro ID da aplicação SPN como utilizado na implementação anterior.Specify the SPN App ID Secret as used in the previous deployment.
ID de recursos de conta de armazenamento alargado existenteExisting extended storage Account resource ID Especifique o ID do recurso de armazenamento utilizado na implementação anterior.Specify the storage account resource ID as used in the previous deployment.
Recipiente de bolha de backend existenteExisting backend blob container Especifique o nome do recipiente blob como utilizado na colocação anterior.Specify the blob container name as used in the previous deployment.
ID de recurso de cofre chave de certificado PFXPFX Certificate Key Vault Resource ID Especifique o ID de recurso do Cofre da Chave Azure da Microsoft como utilizado na implementação anterior.Specify the Microsoft Azure Key Vault resource ID as used in the previous deployment.
PFX Certificado Chave Cofre Secreto URLPFX Certificate Key Vault Secret URL Especifique o URL do certificado utilizado na implantação anterior.Specify the certificate URL as used in the previous deployment.
Impressão em polegar de certificado PFXPFX Certificate Thumbprint Especifique a impressão digital do certificado como utilizada 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 registo do Contentor num novo grupo de recursos.Install a new instance of the Container registry template to a new resource group.

    Instale novo modelo de registo de contentores

  2. Especifique a saída mais recente do SKU a partir do Get-VMImage script e use um parâmetro de adn único a partir da instalação inicial na configuração da máquina virtual, use o mesmo principal 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. Utilize os mesmos parâmetros de armazenamento e cofre de chaves que a instalação inicial para a configuração do cofre de chaves e armazenamento.Use the same storage and Key Vault parameters as the initial install for the storage and Key Vault configuration.

    Adicionar armazenamento

  4. Uma vez implementado o novo modelo de registo de contentores, navegue para o grupo de recursos iniciais 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.

    Selecione IP

  5. No recurso de endereço IP público navegue para Configuração e modifique a etiqueta DNS Name para que possa ser usada para o recurso recém-implantado.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. Note uma vez que modificar a etiqueta NOME DNS e selecione Guardar as chamadas para o Registo de Contentores 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 a mudança

  6. Navegue para o novo grupo de recursos utilizado para implementar a nova instância do modelo de registo de contentores, selecione o recurso IP público, configuração e atualize a etiqueta de nome DNS para o nome correto utilizado na implementação original, neste exemplo myreg , e selecione Save.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.

    Selecione configuração

    Guardar configuração

  7. Durante os próximos 30 minutos haverá acesso intermitente ao registo do contentor à medida que o registo de DNS é propagado.For the next 30 minutes there will be intermittent access to the container registry as the DNS record is propagated. Validar a ligação iniciando sessão no registo do Docker e puxando/empurrando uma imagem.Validate connection by logging into the Docker registry and pulling / pushing an image.

Passos seguintesNext steps

Visão geral do Mercado Azure StackAzure Stack Marketplace overview