Fazer upgrade da versão do Python

Compatível com:

Neste documento, explicamos como fazer upgrade de integrações certificadas e personalizadas, agentes remotos e conectores no Content Hub para a versão mais recente do Python. Como as versões mais antigas do Python foram descontinuadas, as integrações que usam versões sem suporte precisam ser atualizadas para continuar funcionando. Depois de atualizar a integração para a versão mais recente do Python, você também precisa fazer upgrade de cada conector.

Se o código de integração certificado ou personalizado usar uma versão descontinuada do Python, será necessário atualizá-lo manualmente. Use o modo de teste do ambiente de desenvolvimento integrado para atualizar o código de integração sem afetar os ambientes de produção.

Antes de começar

Verifique se o grupo de permissões inclui o acesso a Todos os ambientes. Para mais informações, consulte Trabalhar com grupos de permissões.

Fazer upgrade das integrações

  1. Acesse Automação > IDE. Se alguma integração estiver usando versões desatualizadas do Python, um banner vai aparecer nas páginas do IDE, do Content Hub e dos Playbooks.
  2. Clique em Ver integração para conferir uma lista de integrações.
  3. Clique em Fechar para dispensar o banner.
  4. Na lista de integrações, selecione a integração que você quer atualizar.
  5. Clique em more_vert Mais > Enviar para preparo. Essa etapa cria uma cópia da integração para teste.
  6. Clique no botão Produção para mudar de Produção para Staging.
  7. Na mesma integração, clique em more_vert Mais > Configurar instância.
  8. Siga um destes caminhos de upgrade:

Para saber como configurar instâncias, leia Configurar instâncias. Isso cria uma instância de preparo que não aparece na lista de configuração principal. Só é permitida uma instância de preparo por integração.

Não se esqueça de atualizar cada conector.

Fazer upgrade das integrações certificadas para a versão mais recente do Python

  1. Em Automação > IDE, clique em Fazer upgrade para mudar a integração e as dependências dela para a versão mais recente do Python.
  2. Se essa integração incluir elementos personalizados, atualize o código deles de acordo.
  3. Na seção Teste, insira os parâmetros necessários, incluindo a instância de preparo que você configurou anteriormente.
  4. Verifique se não há erros na Saída de depuração.
  5. Na mesma integração, clique em more_vert Mais > Enviar para produção.
  6. Clique no botão Produção para voltar ao modo de Produção, se necessário.

Fazer upgrade de integrações personalizadas para a versão mais recente do Python

Siga este procedimento para atualizar as dependências de script em integrações personalizadas.

  1. Clique em more_vert Mais > Configurar integração personalizada.
  2. No campo Executando no Python da caixa de diálogo, mude o campo Executando no Python para a versão mais recente do Python (por exemplo, Python 3.11).
  3. Em Dependências do script, copie e salve os nomes das dependências localmente.
  4. Exclua essas dependências da lista e clique em Salvar.
  5. Copie cada um dos nomes de dependência (sem a versão ou o SO de destino) do seu arquivo para o campo Libraries e clique em Add. Por exemplo, mude requests-2.27.1-none-any.whl para requests e adicione-o ao campo Bibliotecas. A plataforma faz o download de cada dependência com a versão mais recente do Python já configurada.

Fazer upgrade de agentes remotos

Se você estiver trabalhando com agentes remotos, faça upgrade do agente e das integrações dele, executando-os da seguinte maneira:

  1. Acesse Configurações > Administração > Agentes remotos do SOAR.
  2. Clique em Atualização disponível.
  3. Faça upgrade do agente usando o método apropriado:
  4. Depois de fazer upgrade do agente, siga as etapas de upgrade da integração descritas neste documento.

Fazer upgrade de conectores

É necessário fazer upgrade dos conectores, tanto personalizados quanto comerciais, para as versões mais recentes do Python.

  1. Acesse Configurações > Gerenciamento de dados > Conectores.
  2. Clique no botão amarelo Atualizar na parte de cima da tela.
  3. Clique em Salvar.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.