Membuat dan mengelola deployment

Deployment project Apps Script adalah versi skrip yang 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 dengan kode project saat ini.
• Deployment dengan versi, 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 sinkron dengan kode yang terakhir disimpan. Misalnya, jika Anda membuat deployment dengan versi, lalu mengubah kode, deployment head akan mencerminkan perubahan tersebut, sementara deployment dengan versi tetap utuh.

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

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

Deployment dengan versi

Deployment dengan versi akan menyediakan versi tertentu dari kode project. Hal ini memungkinkan pengguna terus menggunakan versi yang berfungsi saat Anda membuat perubahan dan peningkatan pada kode.

Saat aplikasi Anda dipublikasikan untuk konsumsi publik, selalu gunakan deployment dengan versi. Anda dapat memiliki beberapa deployment berversi aktif sekaligus.

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

Membuat deployment dengan versi

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

Untuk membuat deployment dengan versi, ikuti langkah-langkah berikut:

1. Buka project Apps Script.
2. Di kanan atas, klik Deploy > Deployment baru.
3. Di samping 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.

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

Melihat deployment dengan versi

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

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 diubah, 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.

   Jika Anda ingin men-deploy perubahan pada kode project, buat versi baru dan edit deployment untuk menggunakannya. Versi baru akan otomatis digunakan oleh 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 deployment aktif untuk menemukan ID-nya.

   ID deployment hanya muncul di deployment aktif.

Menguji deployment

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

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 berversi skrip terlebih dahulu untuk mengakses ID deployment-nya.

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

API yang Dapat Dijalankan

Untuk menguji deployment API yang dapat dieksekusi, Anda harus membuat deployment berversi terlebih dahulu. Setelah 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 Executable API Anda.

Mengarsipkan deployment berversi

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

Untuk mengarsipkan deployment berversi:

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 pada bagian Diarsipkan, pilih deployment yang ingin di-deploy ulang, lalu klik Edit > Deploy.