Faça a gestão das revisões de patches para instâncias

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

Para mais informações sobre a diferença entre as revisões de patches e outras atualizações, consulte o artigo Atualizações de instâncias versus revisões de patches.

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

Para mais informações sobre o controlo de versões do Cloud Data Fusion, consulte os artigos Controlo de versões no Cloud Data Fusion e atualizações de revisões de patches disponíveis.

Antes de começar

  • Antes de atualizar para uma revisão de patch, reveja as notas de lançamento para ver informações sobre as correções específicas que inclui. É importante compreender como podem afetar as suas instâncias.
  • Prepare o ambiente:
    • Agende o período de descanso para a revisão do patch.
    • Recomendado: antes de fazer a atualização, pare todos os pipelines em execução e desative todos os acionadores a montante, como os acionadores do Cloud Composer. Quando a atualização começa, todos os pipelines em execução são interrompidos.

Atualização da instância versus revisão do patch

Atualização da instância
Estas versões incluem as funcionalidades mais recentes, melhorias de funcionalidades e melhorias de desempenho para a plataforma. As atualizações de instâncias estão associadas a alterações de plugins e requerem atualizações de pipelines. Para mais informações, consulte o artigo Atualizações de versões: instâncias e pipelines.
Revisões de patches
Estas versões incluem apenas correções de erros e de segurança críticas para a plataforma e não alteram nem atualizam as funcionalidades de pipeline e plug-ins.

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

Para atualizar para uma revisão de patch da sua instância do Cloud Data Fusion, siga estes passos na Google Cloud consola, na Google Cloud CLI ou na API REST.

Consola

  1. Na Google Cloud consola, aceda à página do Cloud Data Fusion.

  2. Clique em Instâncias e selecione a caixa de verificação junto ao nome da instância.

    Aceda a Instâncias

  3. Clique em Atualizar.

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

  5. Para aceder à instância atualizada na interface Web do Cloud Data Fusion, clique em Ver instância.

  6. Para verificar se a atualização foi bem-sucedida, na Google Cloud consola, atualize a página Detalhes da instância. Verifique o campo Versão para ver a atualização.

gcloud

  1. Para atualizar para uma revisão de patch disponível, execute o seguinte comando da CLI gcloud a partir de um terminal local ou de uma 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 o seguinte:

    • 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: a localização da instância.
    • CURRENT_INSTANCE_VERSION: a versão atual.

    • AVAILABLE_PATCH_REVISION: a revisão da correção para atualizar.

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

    • Opcional: pode transmitir as propriedades do CDAP, como enable.unrecoverable.reset, como --options.

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

  2. Siga estes passos para verificar se a atualização foi bem-sucedida:

    1. Obtenha os detalhes da instância executando o seguinte comando da CLI gcloud a partir de um terminal local ou de uma 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 fazer uma revisão de patch da instância do Cloud Data Fusion, chame o método patch(). Defina o campo opcional patchRevision no pedido. Se não especificar uma revisão da correção, é usada a mais recente disponível.

Exemplos

Os exemplos seguintes mostram como atualizar uma instância para uma revisão de patch com a API REST.

Atualize 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 o seguinte:

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

Use o seguinte corpo do pedido JSON:

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

Substitua o seguinte:

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

Por exemplo, para atualizar uma instância da versão 6.7.3 para a revisão 6.7.3.1, use o seguinte corpo do pedido JSON:

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

Atualize uma instância para a versão de revisão do patch predefinida

Chame o método patch():

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

Use o seguinte corpo do pedido JSON:

{
  "version": VERSION_NUMBER
}

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

{
  "version": 6.7.3
}

Reverta uma revisão de patch

Se tiver problemas inesperados após incorporar uma revisão de patch, reverta a revisão de patch para um estado estável anterior seguindo estes passos.

gcloud

  1. Para reverter para uma revisão de patch anterior, execute o seguinte comando da CLI gcloud a partir de um terminal local ou de uma 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 o seguinte:

    • 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: a localização da instância.
    • CURRENT_INSTANCE_VERSION: a versão atual.

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

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

    • Opcional: pode transmitir as propriedades do CDAP, como enable.unrecoverable.reset, como --options.

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

  2. Siga estes passos para verificar se a reversão foi bem-sucedida:

    1. Obtenha os detalhes da instância executando o seguinte comando da CLI gcloud a partir de um terminal local ou de uma 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 revertido para a versão especificada.

API REST

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

Exemplo

Este exemplo mostra como reverter uma instância da revisão da patch 6.7.3.1 para a revisão da patch 6.7.3 através da API REST.

Chame o método patch():

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

Substitua o seguinte:

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

Use o seguinte corpo do pedido JSON:

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

Substitua o seguinte:

  • VERSION_NUMBER: a versão da instância, como 6.7.3.
  • STABLE_PATCH_REVISION: a revisão do patch para a qual reverter. Consulte as revisões de patches 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 do pedido JSON:

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

O que se segue?