Usar o download offline no AKS no Azure Local e no Windows Server
Aplica-se a: AKS no Azure Local 22H2, AKS no Windows Server
Se você tiver conectividade não confiável com a Internet em seu local de implantação ou precisar verificar arquivos e imagens para segurança e conformidade antes da implantação, poderá usar o download offline para instalar ou atualizar de um caminho local. Há duas maneiras de usar esse recurso: no local ou fora do local. No local significa que você baixa o AKS em imagens locais do Azure no mesmo local em que você implanta. Offsite significa que você baixa o AKS em imagens locais do Azure para um local diferente (onde você pode ter melhor conectividade com a Internet), use uma ferramenta de sua escolha para transferir as imagens para o site de implantação e, em seguida, instalar ou atualizar localmente.
Em cenários locais e externos, a alteração mais recente garante que todos os arquivos zip/cab de diferentes versões sejam extraídos durante o processo de instalação/atualização. Esse processo ocupa menos espaço do que antes, o que exigia que os arquivos fossem extraídos antes da instalação/atualização e armazenados no armazenamento do cluster.
Antes de começar
Os seguintes pré-requisitos são necessários:
- A versão mais recente do módulo AKS-HCI PowerShell.
- Abra o PowerShell como administrador.
- Certifique-se de ter atendido a todos os pré-requisitos de requisitos do sistema.
Use o download offline para instalar no local
Etapa 1: Preparar sua(s) máquina(s) para implantação
Execute o comando a seguir para verificar cada nó físico para ver se todos os requisitos para instalar o AKS no Azure Local estão satisfeitos.
Initialize-AksHciNode
Etapa 2: Configurar a implantação para usar o download offline e baixar as imagens
Na etapa de configuração, use Set-AksHciConfig para habilitar o download offline com o -offlineDownload
parâmetro. Em seguida, especifique o caminho local com o -stagingShare
parâmetro. É aqui que as imagens são baixadas.
Set-AksHciConfig -offlineDownload $true -mode full -stagingShare c:\akshciimages -imageDir c:\clusterstorage\volume1\Images -workingDir c:\ClusterStorage\Volume1\ImageStore -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Observação
Este comando é um exemplo. Você deve substituir os argumentos de parâmetro por aqueles que se ajustam à sua implantação. Você também deve definir suas vnet
configurações. Consulte a etapa 2 neste guia de início rápido. Este exemplo é baixado no modo completo. Para obter mais modos de download, consulte as descrições do -mode
parâmetro em Set-AksHciConfig.
Etapa 3: verifique se o download offline está ativado e se o caminho local está correto
Você pode garantir que o download offline esteja habilitado e que o caminho local esteja correto executando o seguinte comando:
Get-AksHciConfig | ConvertTo-Json
A saída mostra que offlineDownload
está definido como true
, e o stagingShare
valor é o caminho local.
Etapa 4: Faça logon no Azure e defina as configurações de registro
Execute o seguinte comando com as informações da sua assinatura do Azure:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Etapa 5: Iniciar a nova implantação
Execute o seguinte comando para iniciar a implantação:
Install-AksHci
Use o download offline para atualizar no local
Etapa 1: Obter o AKS disponível nas atualizações de host local do Azure
Verifique se há uma atualização disponível executando o seguinte comando:
Get-AksHciUpdates
Etapa 2: ativar o download off-line
Se você ainda não tiver o download off-line ativado, execute o seguinte comando com o caminho local para o qual deseja que as imagens sejam baixadas. Você pode verificar se o download offline está definido com true
o caminho local correto executando Get-AksHciConfig | ConvertToJson
e verificando os valores. Se estiver definido como true
e o caminho local estiver correto, pule para a etapa 3.
Enable-AksHciOfflineDownload -stagingShare <your path>
Etapa 3: Baixar as imagens de atualização
Execute o comando a seguir para baixar as imagens. Este exemplo é baixado no modo completo. Para obter mais modos de download, consulte as descrições do -mode
parâmetro em Get-AksHCiRelease.
Get-AksHciRelease -mode full
Etapa 4: Iniciar o AKS na atualização de host local do Azure
Execute o seguinte comando para iniciar a atualização:
Update-AksHci
Use o download offline para instalar fora do site
Com a funcionalidade externa, você baixa as imagens para um local diferente de sua escolha. Este pode ser um local onde você tem uma conexão mais confiável e segura.
Etapa 1: definir as configurações externas
Execute o seguinte comando em seu local externo com a versão do AKS no Azure Local de que você precisa:
Set-AksHciOffsiteConfig -version <String> -stagingShare <String>
Passo 2: Baixe as imagens
Execute o comando a seguir para baixar as imagens. Este exemplo é baixado no modo completo. Para obter mais modos de download, consulte as descrições do -mode
parâmetro em Get-AksHCiRelease.
Get-AksHciRelease -mode full
Etapa 3: Transfira as imagens no local para onde você implantará
Nesta etapa, use sua ferramenta de escolha para transferir as imagens para que elas estejam disponíveis em um diretório local no local em que o AKS no Azure Local seja implantado.
Etapa 4: Configurar a implantação no local
Defina sua configuração, use o sinalizador -offlineDownload
e defina o caminho para onde o AKS no Azure Local procura as imagens durante a instalação:
Set-AksHciConfig -offlineDownload $true -offsiteTransferCompleted $true -stagingShare c:\akshciimages -imageDir c:\clusterstorage\volume1\Images -workingDir c:\ClusterStorage\Volume1\ImageStore -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Observação
Este comando é um exemplo. Substitua os argumentos de parâmetro por aqueles que se ajustam à sua implantação. Você também deve definir suas vnet
configurações. Consulte a etapa 2 neste guia de início rápido.
Etapa 5: verifique se o download offline está ativado e se o caminho local está correto
Você pode garantir que o download offline esteja habilitado e que o caminho local esteja correto executando o seguinte comando:
Get-AksHciConfig | ConvertTo-Json
A saída mostra que offlineDownload
está definido como true
, e o stagingShare
valor é o caminho local.
Etapa 6: Faça logon no Azure e defina as configurações de registro
Execute o seguinte comando com as informações da sua assinatura do Azure:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Etapa 7: Iniciar a nova implantação
Execute o seguinte comando para iniciar a implantação:
Install-AksHci
Use o download offline para atualizar fora do local
Com a funcionalidade externa, você baixa as imagens para um local diferente de sua escolha. Este pode ser um local onde você tem uma conexão mais confiável e segura.
Etapa 1: Definir a configuração externa
Execute o seguinte comando em seu local externo com a versão do AKS no Azure Local de que você precisa:
Set-AksHciOffsiteConfig -version <String> -stagingShare <String>
Passo 2: Baixe as imagens
Execute o comando a seguir com a versão de atualização necessária para baixar as imagens. Este exemplo é baixado no modo completo. Para obter mais modos de download, consulte as descrições do -mode
parâmetro em Get-AksHCiRelease.
Get-AksHciRelease -mode full
Etapa 3: Transfira as imagens no local para onde você implantará
Nesta etapa, use sua ferramenta de escolha para transferir as imagens para que elas estejam disponíveis em um diretório local no local em que o AKS no Azure Local seja implantado.
Etapa 4: ativar o download offline
Se você ainda não tiver o download offline habilitado, execute o seguinte comando para habilitar o download offline e forneça o caminho correto para onde as imagens estão localizadas:
Enable-AksHciOfflineDownload -stagingShare <your path> -offsiteTransferCompleted $true
Etapa 5: iniciar a atualização
Execute o seguinte comando abaixo para iniciar a atualização:
Update-AksHci