Monitorar as atualizações no Azure Stack Hub usando o ponto de extremidade com privilégios

Você pode usar o ponto de extremidade privilegiado para monitorar o progresso de uma Azure Stack Hub de atualização. Você também pode usar o ponto de extremidade privilegiado para retomar uma atualização com falha da última etapa bem-sucedida se o portal Azure Stack Hub ficar indisponível. O uso do Azure Stack Hub portal é o método recomendado para gerenciar atualizações no Azure Stack Hub.

Os novos cmdlets do PowerShell a seguir para gerenciamento de atualizações estão incluídos na atualização 1710 para Azure Stack Hub integrados.

Cmdlet Descrição
Get-AzureStackUpdateStatus Retorna o status da atualização em execução, concluída ou com falha no momento. Fornece o status de alto nível da operação de atualização e um documento XML que descreve a etapa atual e o estado correspondente.
Resume-AzureStackUpdate Retoma uma atualização com falha no ponto em que ela falhou. Em determinados cenários, talvez seja necessário concluir as etapas 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 1710 para Azure Stack Hub, o processo de atualização 1710 precisa chegar a um determinado ponto antes que a funcionalidade de monitoramento fique disponível. Normalmente, os cmdlets estarão disponíveis se o status no portal do administrador indicar que a atualização 1710 está na etapa Reiniciar Armazenamento Hosts. Especificamente, a atualização do cmdlet ocorre durante a Etapa: Executando a etapa 2.6 – Atualizar a listade permitir privilegedEndpoint .

Você também pode determinar se os cmdlets estão disponíveis programaticamente consultando a lista de comandos do ponto de extremidade privilegiado. Para fazer essa consulta, execute os comandos a seguir do host do ciclo de vida de hardware ou de uma Estação de Trabalho do Privileged Access. Além disso, certifique-se de que o ponto de extremidade privilegiado seja um host confiável. Para obter mais informações, consulte a etapa 1 de Acessar o ponto de extremidade privilegiado.

  1. Crie uma sessão do PowerShell em qualquer uma das VMs (máquinas virtuais) do ERCS em seu ambiente do Azure Stack Hub (Prefixo-ERCS01, Prefixo-ERCS02 ou Prefixo-ERCS03). Substitua Prefixo pela cadeia de caracteres de prefixo da VM específica ao 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 a solicitar credenciais, use o domínio Azure Stack Hub \cloudadmin account ou uma conta que seja membro do grupo <<> CloudAdmins. Para a conta CloudAdmin, insira a mesma senha que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.

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

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Determine se o ponto de extremidade 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. Liste os comandos específicos para o 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
    

Usar os cmdlets de gerenciamento de atualizações

Observação

Execute os comandos a seguir no host do ciclo de vida de hardware ou em uma Estação de Trabalho do Privileged Access. Além disso, certifique-se de que o ponto de extremidade privilegiado seja um host confiável. Para obter mais informações, consulte a etapa 1 de Acessar o ponto de extremidade privilegiado.

Conexão ao ponto de extremidade privilegiado e atribuir variável de sessão

Execute os comandos a seguir para criar uma sessão do PowerShell em qualquer uma das VMs ERCS em seu ambiente do Azure Stack Hub (Prefixo-ERCS01, Prefixo-ERCS02 ou Prefixo-ERCS03) e para 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 a solicitar credenciais, use o domínio Azure Stack Hub \cloudadmin account ou uma conta que seja membro do grupo <<> CloudAdmins. Para a conta CloudAdmin, insira a mesma senha que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.

Obter o status de alto nível da atualização atual

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

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

$statusString.Value 

Os valores possíveis incluem:

  • Executando
  • Concluído
  • Com falha
  • Canceled

Você pode executar esses comandos repetidamente para ver o status mais atualizado. Você não precisa restabelecer uma conexão para verificar novamente.

Obter o status completo da atualização com detalhes

Você pode obter o resumo completo da atualização como uma cadeia de caracteres XML. Você pode gravar a cadeia de caracteres em um arquivo para exame ou convertê-la em um documento XML e usar o PowerShell para analisar. O comando a seguir analisará o XML para obter uma lista hierárquica das etapas em execução no momento:

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

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

No exemplo a seguir, a etapa de nível superior (Atualização de Nuvem) tem um plano filho para atualizar e reiniciar os hosts de armazenamento. Ele mostra que o plano Reiniciar Armazenamento Hosts está atualizando o serviço Armazenamento blob em um dos hosts.

[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 com falha

Se a atualização falhar, você poderá retomar a atualização de onde ela foi deixada.

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

Solucionar problemas

O ponto de extremidade privilegiado está disponível em todas as VMs ERCS no Azure Stack Hub ambiente. Como a conexão não é feita a um ponto de extremidade altamente disponível, você pode experimentar interrupções ocasionais, avisos ou mensagens de erro. Essas mensagens podem indicar que a sessão foi desconectada ou que houve um erro ao se comunicar com o Serviço ECE. O comportamento é esperado. Você pode repetir a operação em alguns minutos ou criar uma nova sessão de ponto de extremidade com privilégios em uma das outras VMs ERCS.

Para obter mais informações sobre como solucionar problemas de atualizações, consulte Azure Stack solução de problemas

Próximas etapas