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.
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 a < conta <> Stack Hub\cloudadmin 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 a lista completa de comandos que estão disponíveis no ponto final privilegiado.
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command }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." }Listar os comandos específicos do módulo Microsoft.AzureStack.UpdateManagement.
$commands | ? Source -eq $updateManagementModuleNamePor 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 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 para obter credenciais, use a < conta <> Stack Hub\cloudadmin 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