Entender as fases de atualização do Azure Local

Aplica-se a: implantações hiperconvergadas de Azure Local

Este artigo descreve as fases de preparação e instalação do fluxo de trabalho de atualização Azure Local, incluindo como as atualizações são baixadas, validadas, verificadas e instaladas. Ele também explica como o progresso da atualização é relatado em vários estágios.

Para obter informações mais detalhadas sobre relatórios de progresso, consulte Use Gerenciador de Atualizações do Azure para atualizar Azure Local e Update Azure Local via PowerShell.

Visão geral

Azure Local atualizações seguem um fluxo de trabalho de duas fases:

1. Preparação: baixe o conteúdo, valide e extraia pacotes e execute verificações de integridade para confirmar se o cluster está pronto.
2. Instalação: aplique a atualização em todo o cluster por meio de um plano de ação orquestrado.

Cada estágio produz um UpdateRun recurso que registra o progresso passo a passo, o tempo e todos os erros encontrados. Você pode consultar os detalhes dessa execução na página Update Progress em Gerenciador de Atualizações do Azure ou usando o cmdlet Get-SolutionUpdateRun no PowerShell.

Fase de preparação

1. Atender aos pré-requisitos

   Antes da preparação, a atualização pode estar no estado AdditionalContentRequired. Esse estado indica que o pacote de atualização requer conteúdo do fornecedor de hardware. Esse requisito se aplica às atualizações do SBE (Solution Builder Extension) e às atualizações combinadas de Solução e SBE. O pacote SBE instalado do fornecedor de hardware não dá suporte ao download automático desse conteúdo.

   Se a atualização estiver no AdditionalContentRequired estado, você deverá importar o conteúdo antes de começar a preparação ou instalação. Para obter mais informações, consulte Atualizar por meio do PowerShell.

2. Atualização de gatilho (opcional)

   A fase de preparação é disparada como parte do início de cada atualização; no entanto, você tem a opção de executar a preparação de forma independente sem também disparar a fase de instalação. Para obter mais informações, consulte a fase de instalação.

   • Para executar apenas a Fase de Preparação, inicie a atualização executando Start-SolutionUpdate -PrepareOnly. Esta etapa baixa e valida o conteúdo da atualização e executa verificações de integridade sem iniciar a instalação. Use-o para preparar atualizações ou validar a prontidão do cluster antes de uma janela de manutenção.
   • Para executar a fase de preparação e a fase de instalação, inicie a atualização executando Start-SolutionUpdate.

3. Executar fases de preparação

   O fluxo de trabalho de preparação passa pelas fases a seguir em ordem.

Download

A fase de download recupera o pacote de atualização da fonte de atualização configurada.

• Download padrão: o Serviço de Atualização baixa o pacote de atualização da solução principal (pacotes NuGet) diretamente do catálogo de atualizações.
• Acompanhamento do andamento: o campo ProgressPercentage na propriedade UpdateStateProperties na atualização informa o andamento do download como um valor de 0 a 100.

Durante essa fase, o objeto Update faz a transição para o Downloading estado. Em caso de falha, o estado se torna DownloadFailed.

Conector de download do SBE (se aplicável)

Qualquer atualização que inclua uma atualização do SBE requer conteúdo extra do fornecedor de hardware. Se o SBE fornecer um conector de download, o Serviço de Atualização o usará para lidar com parte do download:

• O Serviço de Atualização verifica se o SBE instalado dá suporte a um conector de download.
• Se houver suporte, um plano de ação do Orchestrator invocará a ação de download do SBE para recuperar pacotes de fornecedores de hardware, como firmware e drivers.
• O fornecedor de hardware normalmente inclui uma verificação de integridade de conectividade de download que deve ser passada antes do início do download.

Se o download falhar ao usar o conector de download do SBE, o estado de atualização se tornará DownloadFailed. Para ver a mensagem de falha detalhada, examine os detalhes de preparação em Gerenciador de Atualizações do Azure no portal ou usando o objeto UpdateRun de Get-SolutionUpdateRun.

Validar e extrair

Depois que todo o conteúdo é baixado, o Serviço de Atualização valida a integridade do arquivo e extrai os arquivos de atualização.

Se a validação ou extração falhar, o UpdateRun erro será gravado e o estado de atualização se tornará PreparationFailed.

Verificação de saúde

Antes da instalação, o cluster executa verificações de integridade pré-atualização. Essas verificações validam se o cluster está em um estado íntegro. Eles também identificam quaisquer problemas que possam interferir em uma instalação bem-sucedida.

Cada verificação de integridade tem um nível de severidade atribuído:

Severidade	Efeito
Crítico	Bloqueia a atualização. Você deve corrigir esses problemas antes que a instalação possa continuar.
Aviso	Bloqueia a atualização por padrão. Você pode superar esses problemas usando Start-SolutionUpdate -IgnoreWarnings.
Informational	Somente consultoria. Não bloqueia a instalação.

Se você iniciar a atualização no -PrepareOnly modo, a Atualização mudará para o ReadyToInstall estado quando as verificações de integridade forem aprovadas. Se as verificações de integridade encontrarem problemas críticos ou de aviso (e você não especificar -IgnoreWarnings), o status será HealthCheckFailed.

Você pode inspecionar os resultados da verificação de integridade no objeto de atualização usando:

# View health check results
(Get-SolutionUpdate).HealthCheckResult |
Where-Object { ($_.Status -ne "Success") -and ($_.Severity -ne "Informational") } |
Format-List Title, Status, Severity, Description, Remediation

Por padrão, uma atualização no estado ReadyToInstall passa para o estado HealthCheckExpired após três dias. Se uma instalação de atualização for disparada nesse estado, a verificação de integridade será repetida antes de iniciar o plano de ação de instalação.

Para obter ajuda com a solução de problemas de falhas de verificação de integridade, consulte Solucionar problemas de atualizações.

Monitorar a fase de preparação

Monitore a fase de preparação usando o Get-SolutionUpdateRun cmdlet.

Cada vez que você executa Start-SolutionUpdate, com ou sem -PrepareOnly, cria um UpdateRun recurso. Para recuperar os detalhes da etapa de preparação, use:

# Get the most recent update run for an update
Get-SolutionUpdate -Id <UpdateResourceId> | Get-SolutionUpdateRun | % Progress | % Steps

Quando uma execução de preparação falha, a propriedade UpdateRunState é definida como Failed, e a árvore de etapas de Progresso contém detalhes de erro na etapa que encontrou o problema.

Fase de instalação

A atualização é capaz de entrar na fase de instalação quando você executa Start-SolutionUpdate sem o -PrepareOnly parâmetro.

Quando você inicia a atualização dessa forma, a instalação começa:

• Imediatamente - se você executou recentemente a fase de preparação e a atualização já estava no ReadyToInstall estado.
• Após a conclusão da preparação – se a atualização ainda não estava preparada e estiver somente no estado Ready.

Iniciar a instalação

Para iniciar uma atualização completa que inclua preparação e instalação, use:

# Start a full update (preparation + installation)
Get-SolutionUpdate -Id <UpdateResourceId> | Start-SolutionUpdate

Quando a instalação começa, o estado Atualizar muda para Instalação e um novo UpdateRun é criado. Isso UpdateRun representa o progresso da instalação e substitui o UpdateRun que representava a preparação anteriormente.

Progresso da instalação

Durante a instalação, a UpdateRunProgress propriedade contém a árvore de execução completa do plano de ação. Essa propriedade é uma estrutura hierárquica de Step objetos em que cada etapa representa um estágio, uma função ou uma tarefa individual na atualização.

Cada etapa na árvore de progresso expõe as seguintes propriedades:

Propriedade	Tipo	Descrição
Nome	cadeia	Nome da etapa ou tarefa
Descrição	cadeia	Descrição legível por humanos
Situação	cadeia	InProgress, Success ou Error
HoraDeInícioUtc	Data e hora	Quando a etapa começou a ser executada
EndTimeUtc	Data e hora	Quando a etapa foi concluída ou falhou
Mensagem de Erro	cadeia	Detalhes do erro caso o passo falhe
TempoEsperadoDeExecução	TimeSpan	Duração estimada para cálculo de progresso
Steps	Etapa[]	Etapas filho formando a árvore de execução

Monitorar o progresso da instalação

Como o objeto UpdateRun tem uma estrutura complexa, recomendamos monitorar o status de instalação da atualização por meio do portal Azure.

Para monitorar a atualização no PowerShell, monitore o estado do plano de ação subjacente diretamente.

Observação

Use o Start-MonitoringActionplanInstanceToComplete cmdlet somente depois que o sistema instalar a atualização 2503. Antes de 2503, usar esse cmdlet para monitorar o progresso da atualização pode causar falhas na orquestração.

# Get the action plan instance ID from the update run, then monitor
$run = Get-SolutionUpdate | where State -eq "Installing" | Get-SolutionUpdateRun | where State -eq "InProgress"
$id = ($run.ResourceId -split '/')[-1]
Start-MonitoringActionplanInstanceToComplete -actionPlanInstanceID $id

Esse comando fornece a saída do console em tempo real que é atualizada automaticamente. Pressione Ctrl+C para sair do monitor sem interromper a atualização.

Alterações de estado de instalação

A atualização passa por esses estados durante a instalação:

State	Meaning
Instalar	A instalação está em execução ativamente.
Instalado	A atualização terminou de ser instalada com êxito.
Falha na instalação	Uma ou mais etapas falharam.

Solucionar problemas de falhas de instalação

Quando a instalação falhar, examine os detalhes da falha no portal do Azure ou usando o cmdlet Get-SolutionUpdateRun. Para obter diretrizes de solução de problemas, consulte Solucionar problemas de atualizações.

Depois de examinar e atenuar a falha ou determinar que ela é transitória, retome a atualização do portal Azure ou usando o cmdlet Start-SolutionUpdate:

Get-SolutionUpdate | where State -eq "InstallationFailed" | Start-SolutionUpdate

Depois de executar esse cmdlet, o estado de atualização muda de InstallationFailed para Installing.

Próximas Etapas 

Saiba mais sobre como solucionar problemas de atualizações.