Monitorizar as atualizações no Azure Stack Hub com o ponto final com privilégios

Pode utilizar o ponto final privilegiado para monitorizar o progresso de uma atualização do Azure Stack Hub. Também pode utilizar o ponto final privilegiado para retomar uma atualização falhada executada a partir do último passo bem sucedido caso o portal Azure Stack Hub fique indisponível. A utilização do portal Azure Stack Hub é o método recomendado para gerir atualizações no Azure Stack Hub.

Os seguintes cmdlets PowerShell para gestão de atualizações estão incluídos na atualização de 1710 para sistemas integrados Azure Stack Hub.

Cmdlet Descrição
Get-AzureStackUpdateStatus Devolve o estado da atualização atualmente em execução, concluída ou falhada. Fornece o estado de alto nível da operação de atualização e um documento XML que descreve tanto o passo atual como o estado correspondente.
Resume-AzureStackUpdate Retoma uma atualização falhada no ponto em que falhou. Em certos cenários, poderá ter de completar os passos de mitigação antes de retomar a atualização.

Verifique se os cmdlets estão disponíveis

Como os cmdlets são novos no pacote de atualização de 1710 para o Azure Stack Hub, o processo de atualização de 1710 precisa de chegar a um determinado ponto antes da capacidade de monitorização estar disponível. Normalmente, os cmdlets estão disponíveis se o estado no portal do administrador indicar que a atualização 1710 está na etapa restart Armazenamento Hosts. Especificamente, a atualização do cmdlet ocorre durante o passo: Passo de execução 2.6 - Atualização PrivilegedEndpoint allowlist.

Também pode determinar se os cmdlets estão disponíveis programáticamente consultando a lista de comando a partir do ponto final privilegiado. Para fazer esta consulta, executar os seguintes comandos a partir do anfitrião do ciclo de vida de hardware ou de uma Estação de Trabalho de Acesso Privilegiado. Além disso, certifique-se de que o ponto final privilegiado é um hospedeiro de confiança. Para mais informações, consulte o passo 1 do Access o ponto final privilegiado.

  1. Crie uma sessão PowerShell em qualquer uma das máquinas virtuais ERCS (VMs) no ambiente Azure Stack Hub(Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03). Substitua o prefixo pelo prefixo VM específico do seu ambiente.

    $cred = Get-Credential
    
    $pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
    

    Quando solicitado para obter credenciais, use o <<> \cloudadmin account, ou uma conta que é membro do grupo CloudAdmins. Para a conta CloudAdmin, introduza a mesma palavra-passe que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.

  2. Obtenha a lista completa de comandos que estão disponíveis no ponto final privilegiado.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Determinar se o ponto final privilegiado foi atualizado.

    $updateManagementModuleName = "Microsoft.Azurestack.UpdateManagement"
     if (($commands | ? Source -eq $updateManagementModuleName)) {
    Write-Host "Privileged endpoint was updated to support update monitoring tools."
     } else {
    Write-Host "Privileged endpoint has not been updated yet. Please try again later."
     } 
    
  4. Listar os comandos específicos do módulo Microsoft.AzureStack.UpdateManagement.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Por exemplo:

    $commands | ? Source -eq $updateManagementModuleName
    
    CommandType     Name                                               Version    Source                                                  PSComputerName
     -----------     ----                                               -------    ------                                                  --------------
    Function        Get-AzureStackUpdateStatus                         0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01
    Function        Resume-AzureStackUpdate                            0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01
    

Utilize os cmdlets de gestão de atualização

Nota

Executar os seguintes comandos a partir do anfitrião do ciclo de vida do hardware ou de uma estação de trabalho de acesso privilegiado. Além disso, certifique-se de que o ponto final privilegiado é um hospedeiro de confiança. Para mais informações, consulte o passo 1 do Access o ponto final privilegiado.

Ligação ao ponto final privilegiado e atribuir variável de sessão

Executar os seguintes comandos para criar uma sessão PowerShell em qualquer um dos VMs ERCS no seu ambiente Azure Stack Hub(Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03) e atribuir uma variável de sessão.

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)

Quando solicitado para obter credenciais, use o <<> \cloudadmin account, ou uma conta que é membro do grupo CloudAdmins. Para a conta CloudAdmin, introduza a mesma palavra-passe que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.

Obtenha o estado de alto nível da corrente execução da atualização

Para obter um estado de alto nível da corrente atualização, execute os seguintes comandos:

$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }

$statusString.Value 

Valores possíveis incluem:

  • Em Execução
  • Concluído
  • Com falhas
  • Cancelado

Pode executar estes comandos repetidamente para ver o estado mais atualizado. Não precisa restabelecer uma ligação para verificar de novo.

Obtenha o estado de execução da atualização completa com detalhes

Pode obter o resumo completo da atualização como uma cadeia XML. Pode escrever o string a um ficheiro para exame, ou convertê-lo num documento XML e usar o PowerShell para analisá-lo. O seguinte comando analisa o XML para obter uma lista hierárquica dos passos atualmente em execução:

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']")

No exemplo seguinte, o passo de nível superior (Cloud Update) tem um plano para a criança atualizar e reiniciar os anfitriões de armazenamento. Mostra que o plano Restart Armazenamento Hosts está a atualizar o serviço Blob Armazenamento num dos anfitriões.

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']") 

    FullStepIndex : 2
    Index         : 2
    Name          : Cloud Update
    Description   : Perform cloud update.
    StartTimeUtc  : 2017-10-13T12:50:39.9020351Z
    Status        : InProgress
    Task          : Task
    
    FullStepIndex  : 2.9
    Index          : 9
    Name           : Restart Storage Hosts
    Description    : Restart Storage Hosts.
    EceErrorAction : Stop
    StartTimeUtc   : 2017-10-13T15:44:06.7431447Z
    Status         : InProgress
    Task           : Task
    
    FullStepIndex : 2.9.2
    Index         : 2
    Name          : PreUpdate ACS Blob Service
    Description   : Check function level, update deployment artifacts, configure Blob service settings
    StartTimeUtc  : 2017-10-13T15:44:26.0708525Z
    Status        : InProgress
    Task          : Task

Retomar uma operação de atualização falhada

Se a atualização falhar, pode retomar a atualização onde esta foi deixada.

Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate } 

Resolução de problemas

O ponto final privilegiado está disponível em todos os VMs ERCS no ambiente Azure Stack Hub. Como a ligação não é feita a um ponto final altamente disponível, pode sofrer interrupções ocasionais, mensagens de aviso ou erro. Estas mensagens podem indicar que a sessão foi desligada ou que houve um erro de comunicação com o Serviço ECE. Este comportamento é esperado. Pode voltar a tentar a operação em poucos minutos ou criar uma nova sessão de ponto final privilegiada numa das outras VMs ERCS.

Para obter mais informações sobre atualizações de resolução de problemas, consulte a resolução de problemas da Azure Stack

Passos seguintes