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 como as revisões de patch diferem de 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 no seu instâncias. Uma revisão de patch só aplica correções na plataforma, sem mudanças 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ões do Cloud Data Fusion, consulte Controle de versões no Cloud Data Fusion e os 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:
    • Programe um tempo de inatividade para a revisão do 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â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 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 segurança críticas para a plataforma e não alterar ou atualizar os recursos de pipeline e 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 Exibir 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 no campo Versão as atualizar.

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 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 o upgrade foi concluído seguindo estas etapas:

    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 está atualizada 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 de revisão de patch para o 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 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 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 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=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. 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 é revertido para a versão especificada.

API REST

Para reverter uma revisão de patch em uma instância do Cloud Data Fusion, chame 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 como 6.7.3.
  • STABLE_PATCH_REVISION: a revisão de patch a ser implantada. de volta. 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 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