Gerenciar revisões de patch para instâncias

Nesta página, você encontra informações e diretrizes para gerenciar revisões de patch de uma instância do Cloud Data Fusion.

Para mais informações sobre como as revisões de patch são diferentes de outros upgrades, consulte Upgrades de instância x revisões de patch.

As revisões de patch incluem atualizações de segurança críticas e correções de bugs nas suas instâncias. Uma revisão de patch aplica apenas correções na plataforma sem mudar os pipelines ou plug-ins. O processo de upgrade envolve inatividade da instância e do pipeline.

Para mais informações sobre o controle de versão do Cloud Data Fusion, consulte Controle de versão no Cloud Data Fusion e upgrades de revisão de patch disponíveis.

Antes de começar

  • Antes de fazer upgrade para uma revisão de patch, consulte as notas da versão para informações sobre as correções específicas incluídas. É importante entender como eles podem afetar suas instâncias.
  • Prepare o ambiente:
    • Programe um período de inatividade para a revisão do patch.
    • Recomendado: antes de fazer upgrade, interrompa todos os pipelines em execução e desative os gatilhos upstream, como os do Serviço gerenciado para Apache Airflow. Quando o upgrade começa, todos os pipelines em execução são interrompidos.

Upgrade da instância x revisão de patch

Upgrade da instância
Essas versões incluem os recursos mais recentes, melhorias de recursos e melhorias de desempenho para a plataforma. Os upgrades de instância estão associados a mudanças de plug-in e exigem upgrades de pipeline. Para mais informações, consulte Upgrades de versão: instâncias e pipelines.
Revisões de patch
Essas versões incluem apenas correções críticas de segurança e bugs para a plataforma e não mudam nem atualizam os recursos de pipeline e plug-in.

Fazer upgrade para uma revisão de patch de uma instância do Cloud Data Fusion

Para fazer upgrade para uma revisão de patch da sua instância do Cloud Data Fusion, siga estas etapas no console Google Cloud , na Google Cloud CLI ou na API REST.

Console

  1. No Google Cloud console, acesse a página do Cloud Data Fusion.

  2. Clique em Instâncias e marque a caixa de seleção ao lado do nome da instância.

    Acesse "Instâncias"

  3. Clique em Fazer upgrade.

  4. Selecione a revisão de patch mais recente e clique em Fazer upgrade.

  5. Para acessar a instância atualizada na interface da Web do Cloud Data Fusion, clique em Visualizar instância.

  6. Para verificar se o upgrade foi bem-sucedido, no console do Google Cloud , atualize a página Detalhes da instância. Verifique o campo Versão para a atualização.

gcloud

  1. Para atualizar para uma revisão de patch disponível, execute o seguinte comando da CLI gcloud em uma sessão do terminal local Cloud Shell:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    Substitua:

    • INSTANCE_ID: o nome da instância.
    • PROJECT_ID: o ID do projeto que contém a instância do Cloud Data Fusion.
    • LOCATION_NAME: o local da instância.
    • CURRENT_INSTANCE_VERSION: a versão atual.

    • AVAILABLE_PATCH_REVISION: a revisão do patch para fazer upgrade.

    • Opcional: se aplicável à sua instância, adicione as flags --enable_stackdriver_logging, --enable_stackdriver_monitoring e --labels.

    • Opcional: é possível transmitir as propriedades do CDAP, como enable.unrecoverable.reset, como --options.

    Para mais informações, consulte a referência da CLI gcloud.

  2. Para verificar se o upgrade foi concluído, siga estas etapas:

    1. Para conferir os detalhes da instância, execute o seguinte comando da CLI gcloud em uma sessão do Cloud Shell de terminal local:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Verifique se o campo PATCH_REVISION nos detalhes da instância foi atualizado para a versão especificada.

API REST

Para fazer uma revisão de patch da instância do Cloud Data Fusion, chame o método patch() dela. Defina o campo opcional patchRevision na solicitação. Se você não especificar uma revisão de patch, a mais recente disponível será usada.

Exemplos

Os exemplos a seguir mostram como fazer upgrade de uma instância para uma revisão de patch com a API REST.

Fazer upgrade de uma instância para uma versão de revisão de patch específica

Chame o método patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Substitua:

  • PROJECT_ID: o ID do projeto que contém a instância do Cloud Data Fusion.
  • LOCATION_NAME: o local da instância.
  • INSTANCE_ID: o nome da instância.

Use o seguinte corpo da solicitação JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

Substitua:

  • VERSION_NUMBER: a versão da instância, como 6.7.3.
  • PATCH_REVISION_NUMBER: a versão de revisão do patch para fazer upgrade, como 6.7.3.1. Confira as revisões de patch disponíveis.

Por exemplo, para fazer upgrade de uma instância da versão 6.7.3 para a revisão do patch 6.7.3.1, use o seguinte corpo da solicitação JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

Fazer upgrade de uma instância para a versão de revisão de patch padrão

Chame o método patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Use o seguinte corpo da solicitação JSON:

{
  "version": VERSION_NUMBER
}

Substitua VERSION_NUMBER pela versão da instância, como 6.7.3:

{
  "version": 6.7.3
}

Reverter uma revisão de patch

Se você tiver problemas inesperados depois de incorporar uma revisão de patch, reverta a revisão para um estado anterior e estável seguindo estas etapas.

gcloud

  1. Para reverter para uma revisão de patch anterior, execute o seguinte comando da CLI gcloud em uma sessão do terminal local Cloud Shell:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    Substitua:

    • INSTANCE_ID: o nome da instância.
    • PROJECT_ID: o ID do projeto que contém a instância do Cloud Data Fusion.
    • LOCATION_NAME: o local da instância.
    • CURRENT_INSTANCE_VERSION: a versão atual.

    • STABLE_PATCH_REVISION: a revisão do patch para reverter.

    • Opcional: se aplicável à sua instância, adicione as flags --enable_stackdriver_logging, --enable_stackdriver_monitoring e --labels.

    • Opcional: é possível transmitir as propriedades do CDAP, como enable.unrecoverable.reset, como --options.

    Para mais informações, consulte a referência da CLI gcloud.

  2. Siga estas etapas para verificar se a reversão foi bem-sucedida:

    1. Para conferir os detalhes da instância, execute o seguinte comando da CLI gcloud em uma sessão do Cloud Shell de terminal local:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Verifique se o campo PATCH_REVISION nos detalhes da instância foi revertido para a versão especificada.

API REST

Para reverter de uma revisão de patch em uma instância do Cloud Data Fusion, chame o método patch(). Defina o campo patchRevision na solicitação para qualquer revisão de patch estável anterior.

Exemplo

Este exemplo mostra como fazer o rollback de uma instância da revisão de patch 6.7.3.1 para a revisão de patch 6.7.3 usando a API REST.

Chame o método patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Substitua:

  • PROJECT_ID: o ID do projeto que contém a instância do Cloud Data Fusion.
  • LOCATION_NAME: o local da instância.
  • INSTANCE_ID: o nome da instância.

Use o seguinte corpo da solicitação JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

Substitua:

  • VERSION_NUMBER: a versão da instância, como 6.7.3.
  • STABLE_PATCH_REVISION: a revisão do patch para reverter. Confira as revisões de patch disponíveis.

Por exemplo, para reverter a instância da revisão de patch 6.7.3.1 para a revisão de patch 6.7.3, use o seguinte corpo da solicitação JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

A seguir