Gerenciar políticas de manutenção para uma instância do Looker (Google Cloud Core)

Uma vez por mês, o Looker (Google Cloud Core) programa períodos de manutenção em que será feito upgrade da instância. Durante um período de manutenção, sua instância será reiniciada e você ficará temporariamente impossibilitado de acessá-la. Você pode especificar uma janela de manutenção para sua instância, na forma de um dia da semana e um horário do dia em que a manutenção ocorrerá. Se você não especificar uma janela de manutenção preferencial, os upgrades vão acontecer até duas semanas após o lançamento de uma nova versão do Looker (Google Cloud Core). Também é possível especificar um Período de negação de manutenção para impedir que a manutenção ocorra durante o período especificado.

Esta página discute a localização de manutenção programada, a definição de uma janela preferencial para manutenção, a especificação de um período de bloqueio de manutenção e o recebimento e definição de configurações para notificações sobre manutenção futura de uma instância do Looker (Google Cloud Core).

Papel necessário

Para ter as permissões necessárias para definir as configurações de manutenção de uma instância do Looker (Google Cloud Core), peça ao administrador para conceder a você Administrador do Looker (roles/looker.admin) no projeto em que a instância foi criada. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Configurações de manutenção

O Looker (Google Cloud Core) permite definir atualizações de manutenção com um conjunto de configurações.

É possível configurar a manutenção para que seja programada quando um período curto de inatividade causar o menor impacto na instância. É possível configurar o seguinte:

  • Janela de manutenção: o dia da semana e a hora em que o Looker (Google Cloud Core) programa a manutenção. As janelas de manutenção duram uma hora.

  • Período de bloqueio de manutenção: um intervalo de dias em que o Looker (Google Cloud Core) não programa manutenções. Os períodos de bloqueio de manutenção podem ser de até 60 dias. É preciso oferecer pelo menos 14 dias de disponibilidade de manutenção entre dois períodos de bloqueio de manutenção.

É possível atualizar as políticas de manutenção ao criar sua instância do Looker (Google Cloud Core) ou editar a configuração de uma instância atual.

Definir uma janela preferencial para manutenção

Para especificar uma janela preferencial em que o Looker (núcleo do Google Cloud) vai programar a manutenção, selecione uma das seguintes opções:

Console

  1. No console do Google Cloud, crie uma instância do Looker (Google Cloud Core) ou edite a configuração de uma instância atual do Looker (Google Cloud Core).

  2. Em Janela de manutenção, na seção Manutenção preferencial, defina as seguintes configurações para a janela de manutenção:

    • Dia: o dia da semana em que a instância será atualizada.

    • Janela de tempo: o horário aproximado do dia em que a manutenção da instância vai começar

  3. Selecione Salvar.

gcloud

Use o comando gcloud looker instances create se você estiver criando a instância ou use o comando gcloud looker instances update se estiver atualizando a instância e inclua os seguintes parâmetros:

--maintenance-window-day=MAINTENANCE_WINDOW_DAY
--maintenance-window-time=MAINTENANCE_WINDOW_TIME

Substitua:

  • MAINTENANCE_WINDOW_DAY: precisa ser um dos seguintes: friday, monday, saturday, sunday, thursday, tuesday, wednesday
  • MAINTENANCE_WINDOW_TIME: precisa estar no horário UTC no formato de 24 horas (por exemplo, 13:00, 17:45)

Depois que você especifica uma janela de manutenção, as alterações na configuração levam até uma semana para entrar em vigor.

Configurar um período de manutenção de negação

Para adiar a manutenção programada, altere o período de bloqueio de manutenção da instância. Um período de bloqueio de manutenção pode ser de até 60 dias.

Para especificar uma janela preferencial em que o Looker (Google Cloud Core) não vai realizar a manutenção, selecione uma das seguintes opções:

Console

  1. No console do Google Cloud, crie uma instância do Looker (Google Cloud Core) ou edite a configuração de uma instância atual do Looker (Google Cloud Core).

  2. Na seção Período de bloqueio de manutenção, defina as seguintes configurações para esse período:

  • Data de início: escolha a data de início do período em que a manutenção não vai ocorrer.

  • Data de término: escolha a data de término do período em que a manutenção não ocorrerá.

  • Horário de início/término: defina o horário específico em que o Período de negação de manutenção começa (na data especificada para Data de início) e termina (na data especificada para Data de término).

  1. Selecione Salvar.

gcloud

Use o comando gcloud looker instances create se você estiver criando a instância ou use o comando gcloud looker instances update se estiver atualizando a instância e inclua os seguintes parâmetros:

--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
      --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
      --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME

Substitua:

  • DENY_MAINTENANCE_PERIOD_START_DATE e DENY_MAINTENANCE_PERIOD_END_DATE: precisam estar no formato YYYY-MM-DD.
  • DENY_MAINTENANCE_PERIOD_TIME: precisa estar na hora UTC no formato de 24 horas (por exemplo, 13:00, 17:45).

Exemplo de manutenção

Por exemplo, defina as configurações de manutenção da instância de produção da seguinte maneira:

  • Período de manutenção: domingos, entre 0h e 1h (ET)
  • Período de negação de manutenção: 1o de dezembro às 22h até 15 de janeiro às 22h

Notificações de manutenções futuras

Notificações sobre a manutenção futura podem ser enviadas por e-mail até uma semana antes da manutenção. Se quiser definir um filtro de e-mail para notificações, o título do e-mail será [Looker (Google Cloud Core) Advanced Maintenance Notification] Sua instância está programada para manutenção.

As notificações de manutenção não são enviadas por padrão. Se você quiser receber uma notificação sobre uma manutenção futura, siga estas etapas:

  1. Defina uma janela de manutenção.
  2. Ative as notificações de manutenção para envolvidos no projeto.
  3. Para receber notificações sobre a manutenção programada, conclua as duas etapas pelo menos sete dias antes da próxima atualização de manutenção programada da sua instância do Looker (Google Cloud Core).

As notificações são enviadas para o endereço de e-mail associado à sua Conta do Google. Não é possível configurar um alias de e-mail personalizado (por exemplo, um alias de e-mail de equipe).

Ative as notificações de manutenção de todas as instâncias do Looker (núcleo do Google Cloud) que tiverem janelas de manutenção em um projeto específico. Você recebe uma notificação por instância.

Ativar as notificações de manutenção

Para ativar as notificações de manutenção:

  1. Acesse a página Comunicação no console do Google Cloud:

    Comunicação

  2. Selecione a guia Notificações de produtos.

  3. Selecione seu projeto no menu suspenso.

  4. Na linha do Looker (Google Cloud Core), defina o botão de alternância do e-mail como ATIVADO.

Encontrar a manutenção programada

Se a manutenção tiver sido programada para sua instância, será possível acessar essa informação seguindo estas etapas:

  1. Acesse a página do Looker (Google Cloud Core) no console do Google Cloud.

  2. Selecione o nome da instância em que você quer conferir a manutenção programada.

  3. Ao visualizar os detalhes de configuração da sua instância, na página DETALHES, você verá as seguintes informações: