Gerencie 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 do cache. Ele também tem controles para parar ou iniciar o cache, excluir o cache, liberar dados para 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 seu recurso de cache no portal do Azure. Por exemplo, carregue a página Todos os recursos e clique no nome do cache.

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

• Start and Stop - Retoma ou suspende a operação de cache
• Flush - Grava dados alterados em destinos de armazenamento
• Atualizar - Atualiza o software de cache
• Coletar diagnósticos - Carrega informações de depuração
• Atualizar - Recarrega a página de visão geral
• Excluir - Destrói permanentemente o cache

Leia mais sobre essas opções abaixo.

Gorjeta

Você também pode gerenciar destinos de armazenamento individuais - leia Exibir e gerenciar destinos de armazenamento para obter detalhes.

Parar o cache

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

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

Portal

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

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. Finalmente, o status do cache muda para Parado.

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

CLI do Azure

Configure a CLI do Azure para o Cache HPC do Azure.

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 é concluída, o status do cache muda para Parado.

Reative um cache interrompido com az hpc-cache start.

Quando você emite o comando start ou stop, 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 ..

Após a conclusão, a mensagem atualiza 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 Liberar na página de visão geral informa ao cache para gravar imediatamente todos os dados alterados armazenados no cache nos destinos de armazenamento 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 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.

Nota

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 liberação de cache, o cache para de aceitar solicitações de cliente e o status do cache na página de visão geral muda para Liberação.

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

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

CLI do Azure

Configure a CLI do Azure para o Cache HPC do Azure.

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

Exemplo:

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

Quando a descarga terminar, 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"
}
$

Gorjeta

Se você precisar gravar arquivos individuais específicos 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 cliente NFSv3 do PC Cache. Saiba mais em Personalizar write-back de arquivo no Cache HPC do Azure.

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 a atualização do software.

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

A atualização de software pode levar várias horas. Os caches configurados com taxa de transferência mais alta levam mais tempo para serem atualizados do que os caches com valores de taxa de transferência de pico menores. O status do cache muda para Atualizando 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 seu cache.

Você pode usar o portal do Azure para agendar um horário mais conveniente para a atualização. Siga as instruções no separador Portal abaixo.

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

Portal

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.

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 um horário posterior ao prazo na mensagem original.

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

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

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.

Não é possível alterar a programação se faltarem menos de 15 minutos para a atualização.

CLI do Azure

Configure a CLI do Azure para o Cache HPC do Azure.

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 a string "upgradeStatus" na mensagem.

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

Se nenhuma atualização estiver disponível, esta 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
$

Recolher diagnósticos

O botão Coletar diagnóstico inicia manualmente o processo para coletar informações do sistema e carregá-las no Serviço e Suporte da Microsoft para solução de problemas. O 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 Suporte da Microsoft o solicitar.

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

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 cobranças de conta.

Os volumes de armazenamento 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.

Nota

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

Para certificar-se de que todos os dados no cache foram gravados no armazenamento de longo prazo, pare o cache antes de excluí-lo. Certifique-se de que mostra o estado Parado antes de eliminar.

Portal

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

CLI do Azure

Configure a CLI do Azure para o Cache HPC do Azure.

Use o comando az hpc-cache delete da CLI do Azure 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"
}
$

Ver 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. Eles geralmente são associados a configurações personalizadas que você pode ter feito.

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

• O cache não pode alcançar seu servidor NTP
• O cache falhou ao baixar informações de nome de usuário do Extended Groups
• As configurações de DNS personalizadas foram alteradas em um destino de armazenamento

Próximos passos

• Monitore o cache com estatísticas
• Obter ajuda com o Cache HPC do Azure