Membuat dan mengelola deployment

Deployment project Apps Script adalah versi skrip yang dibuat tersedia untuk digunakan sebagai aplikasi web, add-on, atau file yang dapat dieksekusi API. Dengan membuat dan mengelola deployment, Anda dapat melakukan iterasi pada kode, melacak perubahan, dan mengontrol versi kode yang tepat yang dapat 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 membuat project Apps Script, Anda 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.

Deployment berversi

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

Saat aplikasi Anda dipublikasikan untuk penggunaan publik, selalu gunakan deployment yang diberi versi. Anda dapat memiliki beberapa deployment yang diberi versi dan aktif sekaligus.

Penting: Anda tidak dapat mentransfer kepemilikan deployment yang diberi versi. Jika Anda mentransfer kepemilikan project skrip kepada seseorang, pemilik deployment versi yang ada dalam project tidak akan berubah. Jika administrator menghapus akun pemilik deployment, Anda mungkin mengalami error skrip untuk deployment-nya.

Membuat deployment berversi

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

Untuk membuat deployment berversi, ikuti langkah-langkah berikut:

  1. Buka project Apps Script.
  2. Di kanan atas, klik Deploy > New deployment.
  3. Di sebelah Pilih jenis, klik Aktifkan jenis deployment .
  4. Pilih jenis deployment yang ingin Anda deploy. Untuk add-on Google Workspace, add-on Editor, dan aplikasi Google Chat, pilih Add-on.

  5. Masukkan informasi tentang deployment Anda, lalu klik Deploy.

Melihat deployment yang diberi versi

Untuk melihat penerapan project Apps Script, di bagian atas, klik Deploy > Kelola penerapan.

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, ikuti langkah-langkah berikut:

  1. Buka project Apps Script.
  2. Klik Deploy > Manage deployments.
  3. Pilih deployment aktif yang ingin Anda ubah, lalu klik Edit .

  4. Lakukan perubahan, lalu klik Deploy.

    Jika ingin mengedit deployment yang diarsipkan, Anda harus men-deploy ulang, lalu mengikuti langkah-langkah sebelumnya.

    Saat Anda ingin men-deploy perubahan pada kode project, buat versi baru dan edit deployment untuk menggunakannya. Versi baru akan otomatis digunakan oleh semua pengguna yang menggunakan deployment tersebut.

Menemukan ID deployment

Setiap deployment memiliki ID string terkait yang dibuat secara otomatis untuknya. Untuk menemukan ID ini, ikuti langkah-langkah di bawah:

  1. Buka project Apps Script.
  2. Di kanan atas, klik Deploy > Manage deployments.

  3. Pilih penerapan aktif untuk menemukan ID-nya.

    ID deployment hanya muncul di deployment aktif.

Menguji deployment

Cara Anda menguji deployment bergantung pada jenis aplikasi yang Anda buat.

Add-on Google Workspace

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

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, Anda harus membuat deployment versi skrip terlebih dahulu untuk mengakses ID deployment-nya.

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

API yang Dapat Dijalankan

Untuk menguji deployment yang dapat dieksekusi API, Anda harus membuat deployment berversi terlebih dahulu. Setelah Anda membuat deployment, ikuti langkah-langkah di bawah:

  1. Di kanan atas project Apps Script, klik Deploy > Test Deployments.
  2. Di samping ”Pilih jenis”, klik Aktifkan jenis deployment > API Executable.
  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 yang ingin Anda arsipkan, 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 sebelah kiri di bagian Diarsipkan, pilih deployment yang ingin Anda deploy ulang dan klik Edit > Deploy.