È possibile creare un pacchetto ZIP contenente lo script e le dipendenze di Python utilizzati dalle azioni di estendibilità di Cloud Assembly.

Sono disponibili due metodi per creare lo script per le azioni di estendibilità:

  • Compilazione dello script direttamente nell'editor delle azioni di estendibilità in Cloud Assembly.
  • Creazione dello script nell'ambiente locale e aggiunta di tale script, con eventuali dipendenze pertinenti, a un pacchetto ZIP.

Utilizzando un pacchetto ZIP, è possibile creare un modello personalizzato preconfigurato di script di azione e dipendenze che è possibile importare in Cloud Assembly per l'utilizzo nelle azioni di estendibilità.

È inoltre possibile utilizzare un pacchetto ZIP in scenari in cui i moduli associati alle dipendenze nello script di azione non possono essere risolti dal servizio Cloud Assembly, ad esempio quando l'ambiente non dispone di accesso a Internet.

È inoltre possibile utilizzare un pacchetto ZIP per creare azioni di estendibilità che contengano più file di script di Python. L'utilizzo di più file di script può essere utile per organizzare la struttura del codice dell'azione di estendibilità.

Prerequisiti

Se si utilizza Python 3.3 o versioni precedenti, scaricare e configurare il programma di installazione del pacchetto PIP. Vedere Indice del pacchetto Python.

Procedura

  1. Nella macchina locale, creare una cartella per lo script di azione e le dipendenze.
    Ad esempio, /home/user1/zip-action.
  2. Aggiungere lo script o gli script di azione di Python principali alla cartella.
    Ad esempio, /home/user1/zip-action/main.py.
  3. (Facoltativo) Aggiungere tutte le dipendenze per lo script di Python alla cartella.
    1. Creare un file requirements.txt contenente le dipendenze. Vedere File dei requisiti.
    2. Aprire una shell Linux.
      Nota: Il runtime dell'estendibilità basata su azioni in Cloud Assembly è basato su Linux. Pertanto, tutte le dipendenze di Python compilate in un ambiente Windows potrebbero rendere i pacchetti ZIP generati inutilizzabili per la creazione di azioni di estendibilità. Pertanto, è necessario utilizzare una shell Linux.
    3. Installare il file requirements.txt nella cartella dello script eseguendo il comando seguente: 
      pip install -r requirements.txt --target=home/user1/zip-action
  4. Nella cartella assegnata, selezionare gli elementi dello script e, se applicabile, il file requirements.txt e comprimerli in un pacchetto ZIP.
    Nota: Gli elementi dello script e delle dipendenze devono essere archiviati al livello root del pacchetto ZIP. Quando si crea il pacchetto ZIP in un ambiente Linux, è possibile che si verifichi un problema perché il contenuto del pacchetto non viene archiviato al livello root. Se si verifica questo problema, creare il pacchetto eseguendo il comando zip -r nella shell della riga di comando. 
    cd your_script_and_dependencies_folder
zip -r ../your_action_ZIP.zip *

Operazioni successive

Utilizzare il pacchetto ZIP per creare uno script di azione di estendibilità. Vedere Come creare le azioni di estendibilità.