Configurar janelas de manutenção

Nesta página, explicamos como definir janelas de manutenção para o Cloud Data Fusion instâncias.

As janelas de manutenção têm suporte para instâncias do Cloud Data Fusion em 6.8.0 e posteriores.

Sobre as janelas de manutenção

Uma janela de manutenção no Cloud Data Fusion é um período em que você que permitem a realização de operações de manutenção, reduzindo o risco e interrupções durante os horários de pico de uso. Como programar janelas de manutenção durante fora dos horários de pico, ou momentos em que sua atividade é menor, minimiza o impacto sobre as instâncias do Cloud Data Fusion e as execuções de pipeline.

Configurar janelas de manutenção permite controlar quando as operações de manutenção ocorrer na sua instância:

  • Se a janela de manutenção for definida, as operações de manutenção serão executadas pelo Cloud Data Fusion nos períodos definidos.
  • Se a janela de manutenção não estiver definida, a manutenção poderá ser realizada a qualquer tempo de resposta.

Sobre as operações de manutenção

Para garantir a segurança e a conformidade do sistema, o Cloud Data Fusion realiza durante as operações de manutenção regular. Essas operações incluem a aplicação atualizações e patches de segurança para mitigar vulnerabilidades e proteger os dados dos usuários. As janelas de manutenção programadas garantem a aplicação eficiente das atualizações, preservar a integridade do sistema e minimizar as interrupções em instâncias e pipelines execuções.

  • Ao configurar as janelas de manutenção, é preciso alocar pelo menos 12 horas por semana para operações de manutenção. Cada janela deve ter entre 4 e 12 horas.

  • Durante as horas da janela de manutenção, algumas operações podem ser afetadas. Recomendamos que você tenha janelas de manutenção fora dos horários de pico de uso. O operação de manutenção pode afetar o Cloud Data Fusion das seguintes maneiras:

    • A interface do Studio do Cloud Data Fusion pode ficar temporariamente indisponível.
    • A execução do pipeline pode ser afetada, causando falhas.
    • Os serviços do Cloud Data Fusion podem estar temporariamente indisponíveis, causando que as chamadas falhem.
    • As instâncias podem não funcionar totalmente por até uma hora durante e as janelas de manutenção. Recomendamos que você faça a manutenção janelas quando os pipelines não estão em execução ou não estão programados para run.
.

Especificar janelas de manutenção ao criar uma instância

Console

Para definir a janela de manutenção ao criar uma instância, siga estas etapas:

  1. Acesse a página Instâncias do Cloud Data Fusion e clique em Criar instância.

    Crie uma instância

  2. Preencha o campo Nome da instância e a Edição. Para mais informações sobre cada campo, consulte Criar uma instância.
  3. Expanda a seção Opções avançadas.
  4. Expanda a seção Manutenção e siga estas etapas:
    1. Marque a caixa de seleção Ativar janela de manutenção.
    2. No campo Horário de início, insira um horário em um formato compatível.
    3. Na lista TimeZone, selecione um fuso horário.
    4. Nas listas Dias e Duração, selecione os dias da semana e duração do período. Para mais informações sobre essas configurações, consulte Sobre as operações de manutenção.
    5. Clique em Criar.

Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)

API REST

  1. Defina a configuração Instance usando a API instance.create:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Substitua:

  • START_TIME: horário de início da janela de tempo. no formato RFC 3339.
  • END_TIME: horário de término da janela de horário, em formato RFC 3339.

  • MAINTENANCE_RECURRENCE: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA ou BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Isso especifica a frequência recorrência da janela nos dias selecionados, começando no startTime e pela duração especificada.

Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)

O exemplo a seguir cria uma instância com uma janela de manutenção de seis horas entre 10h e 16h (UTC), aos sábados e domingos, toda semana. Para mais mais informações, consulte a documentação da API de instâncias.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

gcloud

É possível especificar a janela de manutenção ao criar uma instância usando o comando gcloud beta data-fusion instances create.

Os parâmetros a seguir precisam ser definidos para uma janela de manutenção:

  • --maintenance-window-start define o horário de início da janela.
  • --maintenance-window-end define o horário de término da janela.
  • --maintenance-window-recurrence define um RRULE para o recorrência da janela de manutenção.
gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • PROJECT_NAME: o nome do projeto.
  • LOCATION: o nome da região da instância.
  • START_TIME: o horário de início da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada.
  • END_TIME: o horário de término da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada. O a data e a hora especificadas devem ser posteriores à hora de início.

  • MAINTENANCE_RECURRENCE: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA ou BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Isso especifica a frequência recorrência da janela nos dias selecionados, começando no --maintenance-window-start vez e pela duração especificada.

Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)

O comando a seguir cria uma instância com uma janela de manutenção de seis horas entre 12h e 18h (UTC), todos os sábados e domingos, toda semana.

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Atualizar as janelas de manutenção de uma instância

Console

Para atualizar a janela de manutenção em uma instância existente no Console do Google Cloud, siga estas etapas:

  1. Acesse a página Instâncias do Cloud Data Fusion.

    Acesse "Instâncias"

  2. Clique no nome da instância para ver os detalhes dela.

  3. Na página Detalhes da instância, navegue até a Janela de manutenção. campo e clique em Editar.

  4. Os campos da janela de manutenção são abertos no modo de edição. Atualize os valores conforme necessário:

    1. Marque a caixa de seleção Ativar janela de manutenção.
    2. No campo Horário de início, insira um horário em um formato compatível.
    3. Na lista TimeZone, selecione um fuso horário.
    4. Nas listas Dias e Duração, selecione os dias da semana e a duração. de janela. Para mais informações sobre essas configurações, consulte Sobre as operações de manutenção.

  5. Clique em Salvar.

Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)

API REST

Para as instâncias existentes, atualize as janelas de manutenção com o instances.patch solicitação de API. Isso substitui a configuração da janela de manutenção atual, se presente. Caso contrário, uma nova configuração será definida, conforme mencionado na solicitação. body.

Crie uma solicitação de API da seguinte maneira:

  1. No parâmetro updateMask, especifique a máscara maintenance_policy.
  2. No corpo da solicitação, especifique a janela de manutenção configuração da política:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)

O exemplo a seguir atualiza a configuração da política de manutenção do com uma janela de manutenção de quatro horas entre 11h e 15h (UTC) toda semana, na sexta, no sábado e no domingo.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

gcloud

É possível atualizar a janela de manutenção de uma instância usando o comando gcloud beta data-fusion instances update.

Os parâmetros a seguir precisam ser definidos para uma janela de manutenção:

  • --maintenance-window-start define o horário de início da janela.
  • --maintenance-window-end define o horário de término da janela.
  • --maintenance-window-recurrence define um RRULE para o recorrência da janela de manutenção.
gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • PROJECT_NAME: o nome do projeto.
  • LOCATION: o nome da região da instância.
  • START_TIME: o horário de início da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada.
  • END_TIME: o horário de término da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada. O a data e a hora especificadas devem ser posteriores à hora de início.

  • MAINTENANCE_RECURRENCE: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA ou BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Isso especifica a frequência recorrência da janela nos dias selecionados, começando no --maintenance-window-start vez e pela duração especificada.

O comando a seguir atualiza a instância example-instance com um comando período de manutenção das 12h às 18h (UTC) aos sábados e domingos. semana.

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Configurar os horários da janela de manutenção e a recorrência (RRULE)

Quando você configura os horários de início e término da janela de manutenção, a data componentes dos carimbos de data/hora fornecidos serão ignorados. Apenas a hora do dia e entre os horários de início e término são consideradas. Os horários são armazenados em UTC, mas use o UTC ou o deslocamento de fuso horário ao programar janelas de manutenção usando a API REST ou a CLI gcloud.

Ao configurar a recorrência, tenha em mente que o RRULE segue os dias UTC, portanto, faça os ajustes necessários caso seu fuso horário seja diferente. Por exemplo, se seu fuso horário for PDT (UTC-7) e você quiser que uma janela de manutenção comece às 21h nas quartas-feiras de seu fuso horário (que corresponde a 4h UTC às quintas-feiras), especifique TH em vez de WE na opção BYDAY do RRULE.

Remover a janela de manutenção de uma instância

Console

Para remover a janela de manutenção de uma instância existente no Console do Google Cloud, siga estas etapas:

  1. Acesse a página Instâncias do Cloud Data Fusion.

    Acesse "Instâncias"

  2. Clique no nome da instância para ver os detalhes dela.

  3. Na página Detalhes da instância, navegue até a Janela de manutenção. campo e clique em Editar.

  4. Para remover a janela de manutenção da instância, limpe a Caixa de seleção Ativar janela de manutenção.

  5. Clique em Salvar.

API REST

Para remover a janela de manutenção de uma instância, passe uma solicitação de objeto de política no corpo da solicitação.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

gcloud

Para remover a janela de manutenção de uma instância, use gcloud beta data-fusion instances update. com a sinalização --clear-maintenance-window.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • PROJECT_NAME: o nome do projeto.
  • LOCATION: o nome da região da instância.

A seguir