Il deployment di un progetto Google Apps Script è una release dello script disponibile per l'utilizzo come app web, componente aggiuntivo di Google Workspace o eseguibile API. Creando e gestendo i deployment, puoi eseguire iterazioni sul codice e controllare a quale script versione accedono gli utenti.
Esistono due tipi di deployment:
- Deployment head, che si sincronizzano sempre con il codice del progetto corrente.
- Deployment con versioni, che si connettono a una versione specifica del progetto.
Deployment head
Un deployment head è il codice del progetto corrente. Quando crei un progetto Apps Script, il sistema crea automaticamente un deployment head per quel progetto.
Il deployment head si sincronizza sempre con il codice salvato più di recente. Ad esempio, se crei un deployment con versioni e poi modifichi il codice, il deployment head riflette queste modifiche, mentre il deployment con versioni rimane intatto.
Utilizza i deployment head per testare il codice. Non utilizzare i deployment head per l'uso pubblico.
Esiste un solo deployment head per ogni progetto Apps Script. Per utilizzare un deployment head, devi disporre almeno dell'accesso in lettura al progetto di script.
Deployment con versioni
Un deployment con versioni rende disponibile una versione specifica del codice del progetto. In questo modo, gli utenti possono continuare a utilizzare una versione funzionante mentre apporti modifiche e miglioramenti al codice.
Quando pubblichi un'applicazione per l'uso pubblico, utilizza sempre un deployment con versioni. Puoi avere più deployment con versioni attivi contemporaneamente.
Importante: non puoi trasferire la proprietà dei deployment con versioni. Se trasferisci la proprietà di un progetto di script, il proprietario dei deployment con versioni esistenti non cambia. Se un amministratore elimina l'account del proprietario del deployment, i deployment potrebbero riscontrare errori di script.
Deployment e versioni
Una versione e un deployment sono concetti distinti in Apps Script:
- Versione: uno snapshot statico del codice del progetto di script. Una volta creata, una versione è immutabile. Considera una versione come un "punto di salvataggio" nella cronologia di sviluppo.
- Deployment: una release che rende disponibile agli utenti una versione specifica dello script. Un deployment ha un URL o un ID univoco.
Quando vuoi aggiornare il codice utilizzato da un deployment esistente (ad esempio un'app web ), crei una nuova versione e poi modifica il deployment in modo che punti a questa nuova versione. In questo modo, l'applicazione viene aggiornata per tutti gli utenti mantenendo lo stesso URL o ID deployment.
Creare un deployment con versioni
Per eseguire il deployment di una versione di un componente aggiuntivo, un componente aggiuntivo Editor, un'app di Chat o un eseguibile API, devi prima cambiare l'associazione del progetto Google Cloud di Apps Script dal progetto predefinito a un progetto standard.
Per creare un deployment con versioni:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Nuovo deployment.
- Accanto a Seleziona tipo , fai clic su Attiva i tipi di deployment .
- Seleziona il tipo di deployment di cui vuoi eseguire il deployment. Per i componenti aggiuntivi di Google Workspace, i componenti aggiuntivi Editor e le app di Google Chat, seleziona Componente aggiuntivo.
- Inserisci le informazioni sul deployment e fai clic su Esegui il deployment.
Ogni nuovo deployment può essere condiviso come libreria. Se condividi lo script come libreria, la descrizione del deployment è visibile agli utenti della libreria.
Visualizzare i deployment con versioni
Per visualizzare i deployment di un progetto Apps Script, in alto, fai clic su Esegui il deployment > Gestisci deployment.
Per visualizzare il codice di una versione specifica, consulta Visualizzare una versione precedente.
Modificare un deployment con versioni
Puoi modificare un deployment con versioni per cambiarne la descrizione o la versione. Per modificare un deployment:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment attivo e fai clic su Modifica .
- Apporta le modifiche e fai clic su Esegui il deployment.
Per modificare un deployment archiviato, riesegui il deployment e poi segui i passaggi precedenti.
Per eseguire il deployment di una modifica al codice del progetto, crea una nuova versione e modifica il deployment in modo che la utilizzi. Questo è il modo standard per aggiornare l'applicazione senza modificarne l'URL o l'ID deployment. Il deployment utilizza automaticamente la nuova versione per tutti gli utenti.
Trovare un ID deployment
Ogni deployment ha un ID stringa associato. Per trovare questo ID:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona un deployment attivo per trovarne l'ID.
Gli ID deployment vengono visualizzati solo nei deployment attivi.
Testare un deployment
Il metodo per testare un deployment dipende dal tipo di app che crei.
Componente aggiuntivo di Google Workspace
Per testare il deployment di un componente aggiuntivo, consulta Testare i componenti aggiuntivi.
Componente aggiuntivo Editor
Per testare il deployment di un componente aggiuntivo Editor, consulta Testare un componente aggiuntivo Editor.
App web
Per testare il deployment di un'app web, consulta Testare il deployment di un'app web.
App Google Chat
Per testare il deployment di un'app di chat, crea un deployment con versioni dello script per accedere al relativo ID deployment.
Dopo aver ottenuto l'ID deployment, specificalo nella configurazione dell'API Chat e segui i passaggi per testare le funzionalità interattive.
Eseguibile API
Per testare il deployment di un eseguibile API, crea un deployment con versioni. Dopo aver creato un deployment:
- In alto a destra nel progetto Apps Script, fai clic su Esegui il deployment > Test dei deployment.
- Accanto a "Seleziona tipo," fai clic su
> Eseguibile API. - Copia e utilizza l'URL per testare il deployment dell'eseguibile API.
Archiviare un deployment con versioni
Non puoi eliminare i deployment con versioni dal record dei deployment. Puoi invece archiviarli.
Per archiviare un deployment con versioni:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment e fai clic su Archivia deployment .
Eliminare una versione dalla cronologia del progetto
Anche se non puoi eliminare i deployment con versioni, puoi eliminare le versioni dello script che utilizzano dalla cronologia del progetto. Per eliminare una versione, questa non deve essere in uso da un deployment attivo.
Per eliminare una versione, consulta Eliminare le versioni.
Eseguire di nuovo il deployment di un deployment archiviato
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Gestisci deployment.
- In Archiviati, seleziona il deployment e fai clic su Modifica > Esegui il deployment.