Gestire le dipendenze dell'integrazione

Supportato in:

Questo documento descrive la procedura per aggiornare le dipendenze degli script di integrazione personalizzati in Google SecOps per supportare runtime Python più recenti. Vengono descritti in dettaglio i passaggi necessari per rimuovere le librerie legacy, configurare le dipendenze aggiornate e risolvere gli errori di migrazione comuni.

Per eseguire l'upgrade degli script di integrazione al runtime Python attuale, consulta Esegui l'upgrade delle integrazioni personalizzate alla versione più recente di Python.

Come rimuovere le dipendenze precedenti e aggiungerne di nuove

  1. Vai a Risposta > IDE. Seleziona l'integrazione personalizzata di destinazione.
  2. Fai clic su more_vert Altro > Configura integrazione personalizzata.
  3. In Dipendenze script, copia e salva i nomi delle dipendenze localmente.
    Ad esempio, se le dipendenze dello script includono: numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl
    Copia solo: numpy.
  4. Elimina queste dipendenze dall'elenco Dipendenze script (solo in questa finestra di configurazione aperta).
  5. Aggiungi le dipendenze al campo Librerie utilizzando uno dei seguenti metodi:
    • Installa per nome della dipendenza:copia ogni nome della dipendenza (esclusa la versione o il sistema operativo di destinazione, ad es. numpy) dal file. La piattaforma scarica automaticamente la dipendenza con la versione Python più recente configurata (ad es. per "numpy" in Python 3.11: numpy-2.3.4-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl).
    • Installa una versione specifica:inserisci il nome e la versione della dipendenza (ad es. numpy==1.21.6), assicurandoti che sia compatibile con il tuo ambiente.
    • Carica il file .whl di destinazione (assicurati che utilizzi dipendenze aggiornate).
  6. Fai clic su Aggiungi e Salva.

Risolvere gli errori di migrazione

Risoluzione degli errori "Ruota non supportata":

  • Identità errore: ERROR: <dependency_name>.whl is not a supported wheel on this platform.
  • Problema principale: quando la piattaforma tenta di installare un .whl legacy (ad esempio Python 3.7) in un ambiente Python 3.11 modernizzato.
  • Soluzione: verifica che tutte le ruote legacy siano state eliminate e aggiunte nuovamente utilizzando solo i nomi delle librerie di base (come nell'esempio precedente), in modo che il sistema possa recuperare le risorse appropriate per la versione.

Gestisci la memorizzazione nella cache dell'interfaccia:

  • Errore: la piattaforma ripristina il download delle dipendenze precedenti nonostante la versione di Python sia stata aggiornata nelle impostazioni.
  • Problema principale: se procedi all'installazione della libreria senza un aggiornamento, il sistema potrebbe utilizzare parametri di runtime obsoleti.
  • Soluzione:adotta la best practice di aggiornare la finestra del browser subito dopo aver salvato la nuova configurazione Python.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.