Abbiamo riorganizzato la struttura di navigazione della documentazione per allinearla direttamente ai tuoi flussi di lavoro operativi. Per ulteriori informazioni, consulta le note di rilascio e il video dimostrativo.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Gestire le dipendenze di integrazione

Supportato in:

Google secops SOAR

Questo documento descrive la procedura per aggiornare le dipendenze degli script di integrazione personalizzati in Google SecOps per supportare i 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 corrente, consulta Eseguire l'upgrade delle integrazioni personalizzate all'ultima versione di Python.

Come rimuovere le vecchie dipendenze e aggiungerne di nuove

Vai a Risposta > IDE. Seleziona l'integrazione personalizzata di destinazione.
Fai clic su more_vert Altro > Configura integrazione personalizzata.
In Dipendenze script, copia e salva localmente i nomi delle dipendenze.
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.
Elimina queste dipendenze dall'elenco Dipendenze script (solo in questa finestra di configurazione aperta).
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 l'ultima versione di Python 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).
Fai clic su Aggiungi e Salva.

Risolvere gli errori di migrazione

Risolvere gli errori "Unsupported wheel":

Identità errore: ERROR: <dependency_name>.whl is not a supported wheel on this platform.
Problema principale: quando la piattaforma tenta di installare un file .whl legacy (ad esempio, Python 3.7) in un ambiente Python 3.11 modernizzato.
Soluzione: verifica che tutti i file wheel legacy siano stati eliminati e aggiunti di nuovo 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.

Nota: tieni presente che questo errore esatto può verificarsi anche durante l'importazione di un'integrazione se il pacchetto di integrazione contiene file .whl incompatibili con la versione di Python della piattaforma. Se un'importazione non riesce per questo motivo, potrebbe essere necessario aggiornare manualmente le dipendenze per supportare l'ambiente di destinazione.

Gestire la memorizzazione nella cache dell'interfaccia:

Errore: la piattaforma torna a scaricare le vecchie dipendenze 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 immediatamente dopo aver salvato la nuova configurazione di Python.

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