Reorganizamos a estrutura de navegação da documentação para se alinhar diretamente aos seus fluxos de trabalho operacionais. Consulte as notas da versão e o vídeo explicativo para mais informações.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Gerenciar dependências de integração

Compatível com:

Google SecOps SOAR

Este documento descreve o processo de atualização das dependências de script de integração personalizada no Google SecOps para oferecer suporte a ambientes de execução Python mais recentes. Ele detalha as etapas necessárias para remover bibliotecas legadas, configurar dependências atualizadas e resolver erros comuns de migração.

Para fazer upgrade dos scripts de integração para o ambiente de execução Python atual, consulte Fazer upgrade de integrações personalizadas para a versão mais recente do Python.

Como remover dependências antigas e adicionar novas

Acesse Resposta > IDE. Selecione a integração personalizada de destino.
Clique em more_vert Mais > Configurar integração personalizada.
Em Dependências de script, copie e salve os nomes das dependências localmente.
Por exemplo, se as dependências de script incluírem: numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Copie apenas: numpy.
Exclua essas dependências da lista Dependências de script (somente nesta janela de configuração aberta).
Adicione as dependências ao campo Bibliotecas usando um dos seguintes métodos:
- Instalar por nome de dependência:copie cada nome de dependência (excluindo a versão ou o SO de destino, por exemplo, numpy) do arquivo. A plataforma faz o download automático da dependência com a versão mais recente do Python configurada (por exemplo, para "numpy" no Python 3.11: numpy-2.3.4-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl).
- Instalar uma versão específica:insira o nome e a versão da dependência (por exemplo, numpy==1.21.6), garantindo que ela seja compatível com seu ambiente.
- Faça upload do arquivo .whl de destino (garanta que ele use dependências atualizadas).
Clique em Adicionar e Salvar.

Resolver erros de migração

Como resolver falhas de "roda não compatível":

Identidade do erro: ERROR: <dependency_name>.whl is not a supported wheel on this platform.
Problema raiz:quando a plataforma tenta instalar um .whl legado (por exemplo, Python 3.7) em um ambiente Python 3.11 modernizado.
Solução:verifique se todas as rodas legadas foram limpas e adicionadas novamente usando apenas nomes de bibliotecas de base (como no exemplo anterior), permitindo que o sistema busque recursos adequados à versão.

Observação:esse erro exato também pode ocorrer durante a importação de uma integração se o pacote de integração contiver arquivos .whl incompatíveis com a versão do Python da plataforma. Se uma importação falhar por esse motivo, talvez seja necessário atualizar manualmente as dependências para oferecer suporte ao ambiente de destino.

Como lidar com o armazenamento em cache da interface:

Erro:a plataforma reverte para o download de dependências antigas, mesmo que a versão do Python seja atualizada nas configurações.
Problema raiz:a instalação da biblioteca sem uma atualização pode fazer com que o sistema use parâmetros de ambiente de execução desatualizados.
Solução:adote a prática recomendada de atualizar a janela do navegador imediatamente após salvar a nova configuração do Python.

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