Gerenciar seu cache

A página de visão geral do cache no portal do Azure mostra detalhes do projeto, status do cache e estatísticas básicas para o cache. Ele também tem controles para parar ou iniciar o cache, excluir o cache, liberar dados para o armazenamento de longo prazo e atualizar o software.

Este artigo também explica como fazer essas tarefas básicas com a CLI do Azure.

Para abrir a página de visão geral, selecione o recurso de cache no portal do Azure. Por exemplo, carregue a página Todos os recursos e clique no nome do cache.

captura de tela da página Visão Geral da instância Cache HPC do Azure

Os botões na parte superior da página podem ajudá-lo a gerenciar o cache:

Iniciar e parar – retoma ou suspende a operação de cache
Descarregar – Escreve dados modificados em destinos de armazenamento
Atualização – Atualiza o software de cache
Coletar diagnósticos – Enviar informações de depuração
Atualizar – recarrega a página de visão geral
Excluir – destrói permanentemente o cache

Parar o cache

Você pode parar o cache para reduzir os custos durante um período inativo. Você não é cobrado por tempo de atividade enquanto o cache está desativado, mas você é cobrado pelo espaço em disco alocado do cache. (Consulte a página de preços para obter detalhes.)

Um cache parado não responde às solicitações do cliente. Você deve desativar clientes antes de parar o cache.

Portal
Azure CLI

O botão Parar suspende um cache ativo. O botão Parar está disponível quando o status de um cache está íntegro ou degradado.

captura de tela dos botões superiores com Parar realçado e uma mensagem pop-up descrevendo a ação parar e perguntando 'você deseja continuar?' com botões Sim (padrão) e Não

Depois de clicar em Sim para confirmar a interrupção do cache, o cache libera automaticamente seu conteúdo para os destinos de armazenamento. Esse processo pode levar algum tempo, mas garante a consistência dos dados. Por fim, o status do cache é alterado para Parado.

Para reativar um cache parado, clique no botão Iniciar . Nenhuma confirmação é necessária.

captura de tela dos botões superiores com Iniciar realçado

Configurar a CLI do Azure para o Azure HPC Cache.

Suspenda temporariamente um cache com o comando az hpc-cache stop . Essa ação só é válida quando o status de um cache é íntegro ou degradado.

O cache libera automaticamente seu conteúdo para os destinos de armazenamento antes de parar. Esse processo pode levar algum tempo, mas garante a consistência dos dados.

Quando a ação for concluída, o status do cache será alterado para Parado.

Reativar um cache parado com az hpc-cache start.

Quando você emite o comando iniciar ou parar, a linha de comando mostra uma mensagem de status "Em execução" até que a operação seja concluída.

$ az hpc-cache start --name doc-cache0629
 - Running ..

Ao concluir, a mensagem é atualizada para "Concluído" e mostra códigos de retorno e outras informações.

$ az hpc-cache start --name doc-cache0629
{- Finished ..
  "endTime": "2020-07-01T18:46:43.6862478+00:00",
  "name": "c48d320f-f5f5-40ab-8b25-0ac065984f62",
  "properties": {
    "output": "success"
  },
  "startTime": "2020-07-01T18:40:28.5468983+00:00",
  "status": "Succeeded"
}

Liberar dados armazenados em cache

O botão Limpar na página de visão geral ordena ao cache que grave imediatamente todos os dados alterados armazenados no cache nos alvos de armazenamento de back-end. O cache salva dados rotineiramente nos destinos de armazenamento, portanto, não é necessário fazer isso manualmente, a menos que você queira garantir que o sistema de armazenamento de back-end esteja atualizado. Por exemplo, você pode usar Flush antes de tirar um instantâneo de armazenamento ou verificar o tamanho do conjunto de dados.

Note

Durante o processo de liberação, o cache não pode atender às solicitações do cliente. O acesso ao cache é suspenso e é retomado após a conclusão da operação.

Quando você inicia a operação de limpeza de cache, o cache para de aceitar solicitações de clientes e o status do cache na página de visão geral muda para Limpeza.

Os dados no cache são salvos nos destinos de armazenamento apropriados. Dependendo da quantidade de dados que precisa ser liberada, o processo pode levar alguns minutos ou mais de uma hora.

Depois que todos os dados são salvos em destinos de armazenamento, o cache começa automaticamente a receber solicitações do cliente novamente. O status do cache retorna para Íntegro.

Portal
Azure CLI

Para liberar o cache, clique no botão Liberar e clique em Sim para confirmar a ação.

captura de tela dos botões superiores com Flush realçado e uma mensagem pop-up descrevendo a ação de liberação e perguntando 'você deseja continuar?' com botões Sim (padrão) e Não

Configurar a CLI do Azure para o Azure HPC Cache.

Use az hpc-cache flush para forçar o cache a escrever todos os dados alterados nos destinos de armazenamento.

Exemplo:

$ az hpc-cache flush --name doc-cache0629 --resource-group doc-rg
 - Running ..

Quando a liberação for concluída, uma mensagem de êxito será retornada.

{- Finished ..
  "endTime": "2020-07-09T17:26:13.9371983+00:00",
  "name": "c22f8e12-fcf0-49e5-b897-6a6e579b6489",
  "properties": {
    "output": "success"
  },
  "startTime": "2020-07-09T17:25:21.4278297+00:00",
  "status": "Succeeded"
}
$

Dica

Se você precisar gravar arquivos individuais específicos de volta em um destino de armazenamento sem gravar todo o conteúdo do cache, considere usar o script flush_file.py contido na distribuição da biblioteca de clientes NFSv3 do Cache do PC. Saiba mais em Personalizar a gravação de retorno de arquivo no Cache do Azure HPC.

Atualizar software de cache

Se uma nova versão de software estiver disponível, o botão Atualizar ficará ativo. Você também deve ver uma mensagem na parte superior da página sobre como atualizar o software.

O acesso ao cliente não é interrompido durante uma atualização de software, mas o desempenho do cache diminui. Planeje atualizar o software durante horas de uso não pico ou em um período de manutenção planejado.

A atualização de software pode levar várias horas. Os caches configurados com maior taxa de transferência levam mais tempo para serem atualizados do que os caches com valores de taxa de transferência de pico menores. O status do cache é alterado para Atualização até que a operação seja concluída.

Quando uma atualização de software estiver disponível, você terá uma semana ou mais para aplicá-la manualmente. A data de término está listada na mensagem de atualização. Se você não atualizar durante esse período, o Azure aplicará automaticamente o novo software ao cache.

Você pode usar o portal do Azure para agendar um momento mais conveniente para a atualização. Siga as instruções na guia Portal abaixo.

Se o cache for interrompido quando a data de término passar, o cache atualizará automaticamente seu software na próxima vez que for iniciado. (A atualização pode não ser iniciada imediatamente, mas será iniciada na primeira hora.)

Portal
Azure CLI

Clique no botão Atualizar para configurar a atualização de software. Você tem a opção de atualizar o software imediatamente ou agendar a atualização para uma data e hora específicas.

Captura de tela do painel Agendar atualização de software mostrando botões de seleção com

Para atualizar imediatamente, selecione Atualizar agora e clique no botão Salvar .

Para agendar uma hora de atualização diferente, selecione Agendar mais tarde e selecione uma nova data e hora.

A data e a hora são mostradas no fuso horário local do navegador.
Você não pode escolher uma hora posterior à data limite na mensagem original.

Quando você salvar a data personalizada, a mensagem de faixa será alterada para mostrar a data escolhida.

Se você quiser revisar a data de atualização agendada, clique no botão Atualizar novamente. Clique no link Redefinir data . Isso remove imediatamente a data agendada.

Captura de tela do painel de agendamento de atualização de software com uma data personalizada selecionada. Um link de texto aparece à esquerda da data, rotulado como

Depois de redefinir o valor agendado anteriormente, o seletor de data será redefinido para a data e hora disponíveis mais recentes. Você pode escolher uma nova data e salvá-la ou clicar em Descartar para manter a data mais recente.

Você não poderá alterar a agenda se houver menos de 15 minutos restantes antes da atualização.

Configurar a CLI do Azure para o Azure HPC Cache.

Na CLI do Azure, novas informações de software são incluídas no final do relatório de status do cache. (Use az hpc-cache show para verificar.) Procure pela string "upgradeStatus" na mensagem.

Use az hpc-cache upgrade-firmware para aplicar a atualização de software, se houver algum.

Se nenhuma atualização estiver disponível, essa operação não terá efeito.

Este exemplo mostra o status do cache (nenhuma atualização está disponível) e os resultados do comando upgrade-firmware.

$ az hpc-cache show --name doc-cache0629
{
  "cacheSizeGb": 3072,
  "health": {
    "state": "Healthy",
    "statusDescription": "The cache is in Running state"
  },

<...>

  "tags": null,
  "type": "Microsoft.StorageCache/caches",
  "upgradeStatus": {
    "currentFirmwareVersion": "5.3.61",
    "firmwareUpdateDeadline": "0001-01-01T00:00:00+00:00",
    "firmwareUpdateStatus": "unavailable",
    "lastFirmwareUpdate": "2020-06-29T22:18:32.004822+00:00",
    "pendingFirmwareVersion": null
  }
}
$ az hpc-cache upgrade-firmware --name doc-cache0629
$

Coletar o diagnóstico

O botão Coletar diagnósticos inicia manualmente o processo para coletar informações do sistema e carregá-los no Serviço Microsoft e suporte para solução de problemas. Seu cache coleta e carrega automaticamente as mesmas informações de diagnóstico se ocorrer um problema sério de cache.

Use esse controle se o Serviço e o Suporte da Microsoft solicitarem.

Depois de clicar no botão, clique em Sim para confirmar o upload.

captura de tela da mensagem de confirmação pop-up 'Iniciar coleção de diagnósticos'. O botão padrão 'sim' está realçado.

Excluir o cache

O botão Excluir destrói o cache. Quando você exclui um cache, todos os seus recursos são destruídos e não incorrem mais em encargos de conta.

Os volumes de armazenamento de back-end usados como destinos de armazenamento não são afetados quando você exclui o cache. Você pode adicioná-los a um cache futuro mais tarde ou descomissioná-los separadamente.

Note

O HPC Cache do Azure não grava automaticamente dados alterados do cache para os sistemas de armazenamento de back-end antes de excluir o cache.

Para garantir que todos os dados no cache foram gravados no armazenamento de longo prazo, interrompa o cache antes de excluí-lo. Verifique se ele mostra o status Parado antes de excluir.

Portal
Azure CLI

Depois de parar o cache, clique no botão Excluir para remover permanentemente o cache.

Configurar a CLI do Azure para o Azure HPC Cache.

Use o comando da CLI do Azure az hpc-cache delete para remover permanentemente o cache.

Exemplo:

$ az hpc-cache delete --name doc-cache0629
 - Running ..

<...>

{- Finished ..
  "endTime": "2020-07-09T22:24:35.1605019+00:00",
  "name": "7d3cd0ba-11b3-4180-8298-d9cafc9f22c1",
  "startTime": "2020-07-09T22:13:32.0732892+00:00",
  "status": "Succeeded"
}
$

Exibir avisos

Se o cache entrar em um estado não íntegro, verifique a página Avisos . Esta página mostra notificações do software de cache que podem ajudá-lo a entender seu estado.

Essas notificações não aparecem no log de atividades porque não são controladas pelo portal do Azure. Elas geralmente são associadas a configurações personalizadas que você pode ter feito.

Os tipos de avisos que você pode ver aqui incluem:

O cache não pode acessar seu servidor NTP
Falha no cache ao baixar informações de nome de usuário de Grupos Estendidos
As configurações de DNS personalizadas foram alteradas em um destino de armazenamento

captura de tela da página Avisos de Monitoramento > mostrando uma mensagem de que nomes de usuário de grupos estendidos não puderam ser baixados

Próximas Etapas

Last updated on 2022-06-29

Gerenciar seu cache

Parar o cache

Liberar dados armazenados em cache

Atualizar software de cache

Coletar o diagnóstico

Excluir o cache

Exibir avisos

Próximas Etapas

Recursos adicionais