Membuat dan mengelola deployment

Deployment project Google Apps Script adalah versi skrip yang tersedia untuk digunakan sebagai aplikasi web, add-on Google Workspace, atau API yang dapat dieksekusi. Dengan membuat dan mengelola deployment, Anda dapat melakukan iterasi pada kode, melacak perubahan, dan mengontrol versi kode yang diakses pengguna.

Ada dua jenis deployment:

  • Deployment head, yang selalu disinkronkan ke kode project saat ini.
  • Deployment berversi, yang terhubung ke versi project tertentu.

Deployment utama

Deployment head adalah kode project saat ini. Saat Anda membuat project Apps Script, sistem akan otomatis membuat deployment head untuk project tersebut.

Deployment head selalu disinkronkan dengan kode yang terakhir disimpan. Misalnya, jika Anda membuat deployment berversi, lalu mengubah kode, deployment head akan mencerminkan perubahan tersebut, sedangkan deployment berversi tetap utuh.

Gunakan deployment head untuk menguji kode. Jangan gunakan deployment head untuk penggunaan publik.

Hanya ada satu deployment head untuk setiap project Apps Script. Untuk menggunakan deployment head, Anda harus memiliki setidaknya akses baca ke project skrip.

Deployment berversi

Deployment versi membuat versi kode project tertentu tersedia. Hal ini memungkinkan pengguna terus menggunakan versi yang berfungsi saat Anda melakukan perubahan dan peningkatan pada kode.

Saat memublikasikan aplikasi untuk penggunaan publik, selalu gunakan deployment berversi. Anda dapat memiliki beberapa deployment versi aktif sekaligus.

Penting: Anda tidak dapat mentransfer kepemilikan deployment yang diberi versi. Jika Anda mentransfer kepemilikan project skrip, pemilik deployment yang dikelola versinya yang ada tidak akan berubah. Jika administrator menghapus akun pemilik deployment, deploymentnya mungkin mengalami error skrip.

Membuat deployment berversi

Untuk men-deploy versi add-on, add-on Editor, aplikasi Chat, atau API yang dapat dieksekusi, Anda harus mengalihkan terlebih dahulu project Google Cloud yang terkait dengan project Apps Script dari project default ke project standar.

Untuk membuat deployment berversi:

  1. Buka project Apps Script. <<../_common/snippets/create-new-deployment.md>>

Setiap deployment baru dapat dibagikan sebagai pustaka. Jika Anda membagikan skrip sebagai library, deskripsi deployment akan terlihat oleh pengguna library.

Melihat deployment yang diberi versi

Untuk melihat deployment project Apps Script, di bagian atas, klik Deploy > Manage deployments.

Untuk melihat kode versi tertentu, lihat Melihat versi sebelumnya.

Mengedit deployment berversi

Anda dapat mengedit deployment berversi untuk mengubah deskripsi atau versinya. Untuk mengedit deployment:

  1. Buka project Apps Script.
  2. Klik Deploy > Manage deployments.
  3. Pilih deployment yang aktif, lalu klik Edit .
  4. Lakukan perubahan, lalu klik Deploy.

Untuk mengedit deployment yang diarsipkan, deploy ulang, lalu ikuti langkah-langkah sebelumnya.

Untuk men-deploy perubahan pada kode project, buat versi baru dan edit deployment untuk menggunakannya. Deployment otomatis menggunakan versi baru untuk semua pengguna.

Menemukan ID deployment

Setiap deployment memiliki ID string terkait. Untuk menemukan ID ini:

  1. Buka project Apps Script.
  2. Di kanan atas, klik Deploy > Manage deployments.
  3. Pilih deployment aktif untuk menemukan ID-nya.

ID deployment hanya muncul di deployment aktif.

Menguji deployment

Metode untuk menguji deployment bergantung pada jenis aplikasi yang Anda buat.

Add-on Google Workspace

Untuk menguji deployment add-on, lihat Menguji add-on.

Add-on editor

Untuk menguji deployment add-on Editor, lihat Menguji add-on Editor.

Aplikasi web

Untuk menguji deployment aplikasi web, lihat Menguji deployment aplikasi web.

Aplikasi Google Chat

Untuk menguji deployment aplikasi Chat, buat deployment versi skrip untuk mengakses ID deployment-nya.

Setelah Anda memiliki ID deployment, tentukan ID di konfigurasi Chat API dan ikuti langkah-langkah untuk menguji fitur interaktif.

API yang Dapat Dijalankan

Untuk menguji deployment yang dapat dieksekusi API, buat deployment berversi. Setelah Anda membuat deployment, ikuti langkah-langkah berikut:

  1. Di kanan atas project Apps Script, klik Deploy > Test deployments.
  2. Di samping ”Pilih jenis”, klik Aktifkan jenis deployment > API yang Dapat Dieksekusi.
  3. Salin dan gunakan URL untuk menguji deployment API Executable Anda.

Mengarsipkan deployment yang diberi versi

Anda tidak dapat menghapus deployment berversi. Sebagai gantinya, Anda dapat mengarsipkannya.

Untuk mengarsipkan deployment yang diberi versi:

  1. Buka project Apps Script.
  2. Klik Deploy > Manage deployments.
  3. Pilih deployment, lalu klik Arsipkan deployment .

Men-deploy ulang deployment yang diarsipkan

  1. Buka project Apps Script.
  2. Di kanan atas, klik Deploy > Manage deployments.
  3. Di bagian Diarsipkan, pilih deployment dan klik Edit > Deploy.