Gerenciar o Openflow

Este tópico descreve as etapas para gerenciar os componentes do Openflow.

Excluir uma implementação

No console da AWS:

  1. Navegue até as instâncias do EC2

  2. Selecione a instância openflow-agent-{deployment-key} com sua chave de implantação.

  3. Clique em Connect na parte superior da página.

  4. Mudar de EC2 Instance Connect para Connect using EC2 Instance Connect Endpoint. Deixe o ponto de extremidade padrão do EC2 Instance Connect no lugar.

  5. Clique em Connect. Uma nova guia ou janela do navegador será exibida com uma interface de linha de comando.

  6. Execute ./destroy.sh a partir do shell.

    • Isso pode levar de 20 a 30 minutos. Se sua conexão for interrompida, o processo continuará em execução em segundo plano.

    • Você pode efetuar login novamente e visualizar o status com o comando: journalctl -u docker -f -n 250

    • O processo destroy estará concluído quando você vir a saída de delete successful.

  7. Navegue até CloudFormation no console da AWS da sua região.

  8. Exclua a pilha CloudFormation de sua implementação.

No Snowsight:

  1. Navegue até o Openflow.

  2. Selecione a guia Deployments.

  3. Na linha da implantação que deseja excluir, selecione o ícone More options.

  4. Selecione Delete.

  5. Na caixa de diálogo de confirmação, digite delete para confirmar a exclusão.

  6. Clique em Delete deployment.

Faça o upgrade de uma implementação

Na implementação do Openflow, há vários componentes que podem precisar de atualização. Atualmente, isso é executado por meio de um script do agente de implementação do Openflow. Os componentes incluem o agente, o serviço de implementação, a UI de implementação, o gateway de tempo de execução e o operador de tempo de execução. Todos os componentes serão atualizados de acordo com os procedimentos a seguir.

Conecte-se ao agente de implementação

  1. Navegue até o Openflow.

  2. Selecione a guia Deployments.

  3. Veja os detalhes de sua implementação e anote a chave de implementação.

  4. Na sua conta AWS, visualize as instâncias EC2 e filtre usando a chave de implantação.

  5. Localize a instância EC2 do agente de implantação chamada openflow-agent-{deployment-key}.

  6. Conecte-se usando o EC2 Instance Connect Endpoint e aceitando todos os padrões.

  7. Execute os comandos restantes na nova guia ou janela do navegador que aparece com uma interface de linha de comando.

Verifique se há upgrades disponíveis

cat ~/.upgrade
Copy

O script exibirá a versão mais recente disponível dos vários componentes de implantação.

Se não houver atualizações disponíveis, você verá uma saída semelhante a esta:

AGENT_IMAGE_VERSION_UPGRADE=
OPERATOR_CHART_VERSION_UPGRADE=
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Caso contrário, você verá a versão que os componentes atualizados usarão, como:

AGENT_IMAGE_VERSION_UPGRADE=0.17.0
OPERATOR_CHART_VERSION_UPGRADE=0.31.0
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Inicie o upgrade

Se a saída indicar que há atualizações disponíveis, execute o seguinte script para iniciar a atualização. Implantações mais antigas do Openflow podem usar o script upgrade-data-plane.sh.

./upgrade.sh
Copy

Você verá uma saída semelhante a esta:

openflow-data-plane-agent-aws is set to version 0.16.0
   Upgrade set to version 0.17.0
openflow-dataplane-service-chart is set to version 0.47.0
   No upgrade is available
openflow-dataplane-ui-chart is set to version 0.5.0
   No upgrade is available
openflow-runtime-gateway is set to version 2025.6.8.2
   No upgrade is available
runtime-operator-chart is set to version 0.30.0
   Upgrade set to version 0.31.0

Então, você tem duas opções:

  • Aguarde a atualização automática: o sistema iniciará automaticamente o processo de atualização em aproximadamente 10 minutos.

  • Faça o upgrade manual: para iniciar o upgrade imediatamente, execute o seguinte comando:

./create.sh
Copy

Monitore o processo de upgrade

Para acompanhar o progresso do upgrade, use o comando journalctl:

journalctl -u openflow-apply-infrastructure -f -n 250
Copy

Verifique se o upgrade foi bem-sucedido

Um upgrade bem-sucedido normalmente mostrará uma saída semelhante a esta:

All resources applied successfully and log uploaded to s3
openflow-apply-infrastructure.service: Deactivated successfully

Atualize um tempo de execução

As atualizações serão disponibilizadas pela Snowflake, tanto quando forem introduzidos novos processadores Openflow ou versões mais recentes de processadores existentes, quanto quando for introduzida uma nova funcionalidade de tempo de execução do Openflow. Quando houver atualizações disponíveis para os tempos de execução do Openflow, você verá um ícone de atualização ao lado do seu tempo de execução na UI do Openflow.

Para atualizar um tempo de execução, faça o seguinte:

  1. Navegue até o Openflow.

  2. Selecione a guia Runtimes.

  3. Um indicador ao lado do nome do tempo de execução mostrará se há uma atualização disponível.

  4. Na linha do tempo de execução que você deseja atualizar, selecione o ícone Mais opções.

  5. Selecione Upgrade.

Atualizar um conector

As atualizações do conector são disponibilizadas pelo Snowflake quando funcionalidades são adicionadas, a lógica de processamento é aprimorada ou novas versões do processador são usadas.

Por exemplo, para adicionar suporte a uma nova versão da API de origem.

Quando as atualizações do conector estiverem disponíveis, você verá um ícone Upgrade no seu grupo de processos na tela.

Nota

Você só pode atualizar conectores após ter atualizado o tempo de execução deles.

Para atualizar um conector, faça o seguinte:

  1. Navegue até o Openflow.

  2. Selecione a guia Runtimes.

  3. Clique no nome do tempo de execução ou selecione «View Canvas» no menu More Options para navegar até a tela.

  4. Localize o(s) grupo(s) de processadores que exibe(m) uma seta vermelha de atualização ao lado do nome.

  5. Clique com o botão direito do mouse no grupo de processos e selecione Version » Change Version.

  6. Selecione a versão mais recente disponível e depois Change.

  7. Confirme se o seu conector foi atualizado para a versão mais recente, que agora deve exibir uma marca de seleção verde. Você também pode validar a versão passando o mouse sobre o balão de diálogo no canto inferior direito do grupo de processos.

Configurar o registro de fluxo do conector Snowflake

Importante

As primeiras versões preliminares do Openflow não configuravam um tempo de execução para atualizações de conectores. Caso não veja a opção Version ao clicar com o botão direito do mouse em um grupo de processos, será necessário configurar o Registro de fluxo do conector Snowflake e ativar manualmente o controle de versão para os conectores existentes.

Para configurar o registro de fluxo do conector Snowflake, faça o seguinte:

  1. Navegue até a tela.

  2. Clique no menu no canto superior direito e selecione Controller Settings.

  3. Alterne para a guia Registry Clients.

  4. Clique no ícone + para adicionar um novo cliente de registro.

  5. Selecione ConnectorFlowRegistryClient e depois Add.

  6. Clique em More Options para a linha ConnectorFlowRegistryClient e selecione Edit.

  7. Digite /nifi/configuration_resources/connector_flow_registry como o valor para Storage Location e selecione Apply.

Após configurar o registro de fluxo do conector Snowflake, agora você pode ativar o controle de versão para seus conectores existentes.

Para ativar o controle de versão para conectores existentes, faça o seguinte:

  1. Navegue até a tela e localize o grupo de processos ao qual deseja adicionar o controle de versão.

  2. Clique com o botão direito do mouse no grupo de processos e selecione Version » Set Version.

  3. Na caixa de diálogo Set Version, escolha o fluxo que corresponde ao seu grupo de processos.

    Por exemplo, escolha sqlserver se estiver usando o conector do SQL Server.

    Observe que os nomes dos fluxos não correspondem exatamente ao nome do conector.

  4. Selecione a versão mais recente e, em seguida, Set version para ativar o controle de versão.

  5. Na tela, clique com o botão direito do mouse no grupo de processos novamente e selecione Version » Revert Local Changes para aplicar a versão mais recente do conector.

  6. Revise a lista de alterações e selecione Revert.

  7. Confirme se o seu conector foi atualizado para a versão mais recente, que agora deve exibir uma marca de seleção verde. Você também pode validar a versão passando o mouse sobre o balão de diálogo no canto inferior direito do grupo de processos.

Linguagem: Português