Gerenciar revisões de patch para instâncias

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

Para saber mais sobre a diferença entre as revisões de patch e outros upgrades, consulte Upgrades de instância versus revisões de patch.

As revisões de patch incluem atualizações de segurança críticas e correções de bugs nas instâncias. Uma revisão de patch aplica somente correções na plataforma, sem alterar 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ões do Cloud Data Fusion, consulte Controle de versões 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, leia as notas da versão para informações sobre as correções específicas incluídas. É importante entender como eles afetam suas instâncias.
  • Prepare o ambiente:
    • Programe o tempo de inatividade para a revisão de patch.
    • Recomendado: antes de fazer upgrade, interrompa os pipelines em execução e desative os gatilhos upstream, como os do Cloud Composer. Quando o upgrade começa, todos os pipelines em execução são interrompidos.

Upgrade de instância versus revisão de patch

Upgrade da instância
Essas versões incluem os recursos mais recentes, melhorias de recursos e melhorias de desempenho da plataforma. Os upgrades de instância estão associados a alterações do plug-in e exigem upgrades do 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 alteram nem atualizam os recursos do pipeline e do plug-in.

Faça 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 instância do Cloud Data Fusion, siga estas etapas no console do Google Cloud, na Google Cloud CLI ou na API REST.

Console

  1. No console do Google Cloud, 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, recarregue a página Detalhes da instância. Verifique a atualização no campo Versã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 Cloud Shell de terminal local:

    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 de patch para fazer upgrade.

    • Opcional: se aplicável à sua instância, adicione as sinalizações --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. Verifique se o upgrade foi concluído seguindo estas etapas:

    1. Veja os detalhes da instância executando 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 está atualizado para a versão especificada.

API REST

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

Examples

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 corpo da solicitação JSON a seguir:

{
  "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 de patch para fazer upgrade, como 6.7.3.1. Consulte 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 de 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 padrão de revisão de patch

Chame o método patch():

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

Use o corpo da solicitação JSON a seguir:

{
  "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 imprevistos após incorporar uma revisão de patch, reverta a revisão de patch 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 Cloud Shell de terminal local:

    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 de patch à qual reverter.

    • Opcional: se aplicável à sua instância, adicione as sinalizações --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. Verifique se a reversão foi bem-sucedida seguindo estas etapas:

    1. Veja os detalhes da instância executando 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 está revertido para a versão especificada.

API REST

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

Exemplo

Neste exemplo, mostramos como reverter 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 corpo da solicitação JSON a seguir:

{
  "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 de patch à qual reverter. Consulte 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