Gerenciar revisões de patch para instâncias

Esta página fornece informações e diretrizes para gerenciar revisões de patches em uma instância do Cloud Data Fusion.

Para mais informações sobre as diferenças entre as revisões de patch e outros upgrades, consulte Upgrades de instâncias e 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 só aplica 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ã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 saber mais sobre as correções específicas incluídas. É importante entender como elas podem afetar suas instâncias.
  • Prepare o ambiente:
    • Programe um tempo 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 Cloud Composer. Quando o upgrade começa, todos os pipelines em execução são interrompidos.

Upgrade de instâncias e revisão de patches

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âncias são associados a mudanças de plug-ins 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 de bugs e de segurança críticas para a plataforma e não mudam nem atualizam os recursos do pipeline e do 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 do Google Cloud, na CLI do Google Cloud 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 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 concluído, no console do Google Cloud, recarregue a página Detalhes da instância. Verifique o campo Versão para conferir 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 de terminal local do 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. Siga estas etapas para verificar se o upgrade foi concluído:

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

      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 realizar 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 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 específica da revisão de patch

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 da revisão do patch para a qual você quer fazer upgrade, como 6.7.3.1. Consulte as versõ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 de 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 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 do gcloud em uma sessão do terminal local do 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 terminal local do Cloud Shell:

      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 é 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(). Defina o campo patchRevision na solicitação para qualquer revisão de patch anterior e estável.

Exemplo

Este exemplo mostra como reverter uma instância da revisão do patch 6.7.3.1 para a revisão do 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 voltar. Consulte as versões de patch disponíveis.

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

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

A seguir