Gerenciar revisões de patch para instâncias

Esta página fornece informações e diretrizes para gerenciar revisões de patch para 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 no seu instâncias. Uma revisão de patch só aplica correções na plataforma sem mudar os pipelines ou plug-ins. O processo de upgrade envolve instâncias e tempo de inatividade.

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, revise as notas da versão para informações sobre as correções específicas incluídas. É importante entender como elas podem afetar as instâncias.
  • Prepare o ambiente:
    • Programar o tempo de inatividade da revisão de patch.
    • Recomendado: antes de fazer upgrade, interrompa quaisquer pipelines em execução e desativar todos 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ância estão associados com mudanças de plug-ins e exigir 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 em uma instância do Cloud Data Fusion

Para fazer upgrade da sua instância do Cloud Data Fusion para uma revisão de patch, siga estas instruções: 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 versão da Web do Cloud Data Fusion do aplicativo, clique em Ver instância.

  6. Para verificar se o upgrade foi concluído, acesse o console do Google Cloud: Atualize 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 este comando: Comando da CLI gcloud em um terminal local Sessão 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 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. Consulte os detalhes da instância executando o seguinte Comando da CLI gcloud em um terminal local Sessão 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 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.

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 específica 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

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 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 de versão 6.7.3 para o patch 6.7.3.1 revisão, 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 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 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 para reverter.

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

    • Opcional: é possível passar as propriedades do CDAP, como enable.unrecoverable.reset, conforme --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. 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(). Definir o campo patchRevision na solicitação como qualquer versão anterior e estável revisão de patch.

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 de patch a ser implantada. de volta. Consulte as versões de patch disponíveis.

Por exemplo, para reverter a instância da revisão de patch 6.7.3.1 para 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