Gerenciar dependências de integração

Compatível com:

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 mais recentes do Python. 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 atual do Python, consulte Fazer upgrade de integrações personalizadas para a versão mais recente do Python.

Como remover dependências antigas e adicionar novas

  1. Acesse Resposta > IDE. Selecione a integração personalizada de destino.
  2. Clique em more_vert Mais > Configurar integração personalizada.
  3. Em Dependências de script, copie e salve os nomes das dependências localmente.
    Por exemplo, se as dependências do script incluírem: numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
    Copie apenas: numpy.
  4. Exclua essas dependências da lista Dependências de script (apenas nesta janela de configuração aberta).
  5. Adicione as dependências ao campo Bibliotecas usando um dos seguintes métodos:
    • Instalar por nome da dependência:copie cada nome de dependência (exceto a versão ou o SO de destino, por exemplo, numpy) do arquivo. A plataforma baixa automaticamente a 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 (verifique se ele usa dependências atualizadas).
  6. Clique em Adicionare em Salvar.

Resolver erros de migração

Como resolver falhas de "roda sem suporte":

  • Identidade do erro:ERROR: <dependency_name>.whl is not a supported wheel on this platform.
  • Problema principal: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 removidas e adicionadas novamente usando apenas nomes de bibliotecas básicas (como no exemplo anterior), permitindo que o sistema busque recursos adequados à versão.

Processar o armazenamento em cache da interface:

  • Erro:a plataforma volta a baixar dependências antigas, mesmo que a versão do Python tenha sido atualizada nas configurações.
  • Problema principal:continuar com 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.