Janelas de manutenção definidas pelo cliente

Gen 2

Defina os dias e o horário de início da manutenção em sua implantação. O serviço “ Cloud Databases ” controla a duração da janela de manutenção, e todos os trabalhos de manutenção são concluídos ou interrompidos no prazo de 4 horas a partir do horário de início programado.

Disponibilidade

Estão disponíveis janelas de manutenção definidas pelo cliente para:

Databases for PostgreSQL em eu-de.
Databases for MongoDB Enterprise Edition em. eu-de

O suporte a mais bancos de dados e regiões será adicionado gradualmente.

Configure um horário diário para manutenção, a menos que sua organização exija que a manutenção seja realizada apenas em dias específicos. Uma janela diária permite que as tarefas de manutenção pendentes ou incompletas, incluindo atualizações de segurança e confiabilidade, sejam retomadas no dia seguinte, em vez de se esperar até a semana seguinte.

O que está incluído na manutenção

A manutenção inclui qualquer alteração que afete diretamente sua implantação, como:

Atualizações de software de banco de dados e de imagens.
Atualizações nos nós de trabalho nos quais sua implantação é executada.
Atualizações relacionadas à segurança, confiabilidade e facilidade de manutenção.

Essas alterações são executadas durante o seu período de manutenção, mesmo que não causem um impacto visível no serviço. As alterações solicitadas por você mesmo, como o dimensionamento da sua implantação, são executadas no momento em que você as solicita.

Durante a manutenção, sua implantação pode ser transferida para um novo servidor primário. Certifique-se de que seus aplicativos possam se reconectar automaticamente. Para obter mais informações, consulte Alta disponibilidade.

Janela de manutenção padrão

Você não precisa definir um horário de manutenção. Caso contrário, o Cloud Databases utiliza a configuração padrão regional: um horário de início entre 23h00 UTC e 10h00 UTC, de segunda a sexta-feira. A hora exata de início não é exibida.

Para voltar à configuração padrão regional depois de definir sua própria janela, defina system_assigned como true``.

Requisitos relativos ao período de manutenção

É possível definir apenas uma hora de início. Não é possível definir uma duração ou hora de término. O parâmetro “ Cloud Databases ” controla a duração da janela de manutenção.
Especifique a hora de início em UTC usando o formato hh:mmZ.
Selecione pelo menos um dia de manutenção por semana. Recomenda-se uma janela de manutenção diária. Para obter mais informações, consulte “Se a manutenção não for concluída a tempo ”.
Defina a hora de início pelo menos 60 minutos antes do intervalo de manutenção ao qual você deseja que ela se aplique.
Você pode atualizar sua janela de manutenção a qualquer momento. As alterações entram em vigor na próxima janela de manutenção elegível. Se a manutenção já tiver sido concluída no dia, a programação atualizada entrará em vigor na próxima vez que a manutenção estiver programada para ser executada.
Se você atualizar a janela de manutenção enquanto a manutenção estiver em andamento, a operação de manutenção atual não será reiniciada. O cronograma atualizado se aplica à próxima janela de manutenção elegível.
As notificações de manutenção são baseadas no cronograma em vigor no momento em que a notificação é gerada. Alterações feitas pouco antes de um período de manutenção podem não ser aplicadas às notificações que já foram geradas ou enviadas.

Como funcionam as janelas de manutenção

A janela de manutenção tem duração de 4 horas a partir do horário de início programado, e todos os trabalhos de manutenção são concluídos ou interrompidos dentro desse período.

Por exemplo, se o horário de início da manutenção for 02h00 UTC:

Exemplo de janela de manutenção com horário de início às 02:00 UTC
Horário (UTC)	O que acontece
02h00 - 06h00	A manutenção tem início, e as atividades de manutenção são iniciadas. Sua implantação pode ser transferida para um novo servidor primário, e seus aplicativos podem precisar se reconectar.
Às 06h00	Todos os trabalhos de manutenção foram concluídos ou interrompidos.

Ao escolher um horário de início, reserve o intervalo total de 4 horas, e não apenas o horário de início. Escolha um horário em que sua aplicação tenha o menor tráfego possível e sua equipe de operações esteja disponível.

Seus backups nunca coincidem com o seu horário de manutenção. O Cloud Databases ajusta a programação dos backups automaticamente.

Definir um intervalo de manutenção

Você pode definir seus dias de manutenção e o horário de início usando o console, a CLI, a API ou o Terraform.

Definir um intervalo de manutenção no console

É possível configurar uma janela de manutenção ao criar uma implantação ou após o provisionamento.

No console do IBM Cloud, crie uma implantação ou abra uma implantação existente.
Vá até a janela “Manutenção ” e clique em “Editar ”.
Selecione os dias da semana em que a manutenção pode começar. Recomenda-se um cronograma de manutenção diária.
Selecione uma hora de início da manutenção. Você pode exibir a hora no formato UTC ou no seu fuso horário local.
Verifique o cronograma de manutenção e clique em “Salvar ”.

Para voltar à janela de manutenção padrão da região, clique em “Redefinir como padrão ”.

Definir um intervalo de manutenção usando a CLI

Você pode definir um intervalo de manutenção específico usando o seguinte comando:

ibmcloud resource service-instance-create \
  <INSTANCE_NAME> \
  <SERVICE_NAME> \
  <SERVICE_PLAN_NAME> \
  <LOCATION> \
  -g <RESOURCE_GROUP> \
  -p '{
    "dataservices": {
      "maintenance": {
        "window": {
          "start_time": "05:00Z",
          "days": "Wednesday,Thursday"
        }
      }
    }
  }'

É possível definir uma janela de manutenção d system_assigned, utilizando os seguintes comandos:

ibmcloud resource service-instance-create \
  <INSTANCE_NAME> \
  <SERVICE_NAME> \
  <SERVICE_PLAN_NAME> \
  <LOCATION> \
  -g <RESOURCE_GROUP> \
  -p '{
    "dataservices": {
      "maintenance": {
        "window": {
          "system_assigned": true
        }
      }
    }
  }'

Definir um intervalo de manutenção usando a API

É possível definir um intervalo de manutenção específico usando a seguinte solicitação:

curl -X POST \
  "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
  -H "Authorization: Bearer <IAM_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<DATABASE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP_ID>",
    "resource_plan_id": "<DATABASE_SERVICE_PLAN_ID>",
    "parameters": {
      "dataservices": {
        "maintenance": {
          "window": {
            "start_time": "05:00Z",
            "days": "Wednesday,Thursday"
          }
        }
      }
    }
  }'

É possível definir uma janela de manutenção d system_assigned e por meio da seguinte solicitação:

curl -X POST \
  "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
  -H "Authorization: Bearer <IAM_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<DATABASE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP_ID>",
    "resource_plan_id": "<DATABASE_SERVICE_PLAN_ID>",
    "parameters": {
      "dataservices": {
        "maintenance": {
          "window": {
            "system_assigned": true
          }
        }
      }
    }
  }'

Definir um intervalo de manutenção usando o Terraform

É possível definir um intervalo de manutenção específico usando a seguinte solicitação do Terraform:

maintenance_days = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
data "ibm_resource_group" "rg" {
  name = var.resource_group_name
}
resource "ibm_database" "cmw_test" {
  name              = "<DATABASE_INSTANCE_NAME>"
  resource_group_id = data.ibm_resource_group.rg.id
  service = "<DATABASE_SERVICE_NAME>"
  plan    = "<DATABASE_SERVICE_PLAN_ID>"
  location          = "<GEN2-REGION>"
  service_endpoints = "private"
  maintenance {
    window {
      start_time = "05:00Z"
      days       = var.maintenance_days
    }
  }
}

É possível definir uma janela de manutençã system_assigned e usando a seguinte solicitação do Terraform:

data "ibm_resource_group" "rg" {
  name = var.resource_group_name
}
resource "ibm_database" "cmw_test" {
  name              = "<DATABASE_INSTANCE_NAME>"
  resource_group_id = data.ibm_resource_group.rg.id
  service = "<DATABASE_SERVICE_NAME>"
  plan    = "<DATABASE_SERVICE_PLAN_ID>"
  location          = "<GEN2-REGION>"
  service_endpoints = "private"
  maintenance {
    window {
      system_assigned = true
    }
  }
}

Acompanhamento da manutenção

Quando houver uma manutenção pendente para sua implantação, você receberá um evento “ IBM Cloud Activity Tracker ” pelo menos 2 horas antes do início da atividade de manutenção.

IBM Cloud Activity Tracker Os eventos também são acionados como resultado de qualquer atualização da instância do serviço decorrente de uma janela de manutenção bem-sucedida. Confira a lista completa dos eventos “ Activity Tracker ” sobre bancos de dados.

Manutenção incompleta

A manutenção nunca se estende além do fim do seu período de manutenção. Se a manutenção ainda estiver em andamento 4 horas após o horário de início, o Cloud Databases a interrompe. O trabalho restante será executado na sua próxima janela de manutenção. Enquanto isso, sua implantação permanece disponível.

Defina um intervalo diário para manutenção. Se você selecionar apenas um dia por semana, as tarefas de manutenção que não foram concluídas, incluindo correções de segurança, ficarão em espera por até uma semana até a sua próxima janela de manutenção. Com uma janela diária, a manutenção é retomada no dia seguinte, e sua implantação permanece atualizada e segura.

manutenção emergencial

Em circunstâncias excepcionais, pode ser necessária uma manutenção de emergência fora do horário programado para manutenção, sem aviso prévio. Nesses casos, não são criadas tarefas de manutenção programadas.