Membuat dan mengelola deployment

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

Head deployment

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

Deployment head selalu disinkronkan dengan kode terbaru yang disimpan. Misalnya, jika Anda membuat deployment berversi, lalu memodifikasi kode, deployment head akan mencerminkan perubahan tersebut, sedangkan deployment berversi akan tetap tidak berubah.

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 berversi menyediakan kode project versi tertentu. Hal ini memungkinkan pengguna untuk terus menggunakan versi yang berfungsi saat Anda melakukan perubahan dan peningkatan pada kode.

Saat aplikasi Anda dipublikasikan untuk konsumsi publik, selalu gunakan deployment berversi. Anda dapat memiliki beberapa deployment berversi yang 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 mereka.

Membuat deployment berversi

Untuk men-deploy versi Add-on Google Workspace, Add-on Editor, aplikasi Google Chat, atau API yang dapat dijalankan, Anda harus terlebih dahulu mengalihkan pengaitan 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 > Deployment baru.
3. Di sebelah Pilih jenis klik Aktifkan jenis deployment .
4. Pilih jenis deployment yang ingin di-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 dapat dilihat oleh pengguna library.

Lihat deployment berversi

Untuk melihat deployment project Apps Script, di bagian atas, klik Deploy > Manage 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 deployment.
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-nya 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 setiap pengguna yang menggunakan deployment tersebut.

Menemukan ID deployment

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

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

3. Pilih deployment aktif untuk menemukan ID-nya.

   ID deployment hanya muncul pada deployment aktif.

Menguji deployment

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

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 memiliki ID deployment, ikuti langkah-langkah untuk mengaktifkan Google Chat API. Pada halaman Konfigurasi pada bagian "Izin", cukup tentukan alamat email Anda sehingga Anda dapat menginstal dan menguji aplikasi.

API Dapat Dieksekusi

Untuk menguji deployment API yang dapat dijalankan, Anda harus membuat deployment berversi terlebih dahulu. 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 Executable.
3. Salin dan gunakan URL untuk menguji deployment API yang Dapat Dieksekusi.

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 deployment.
3. Pilih deployment yang ingin diarsipkan, lalu klik Arsipkan deployment .

Men-deploy ulang deployment yang diarsipkan

1. Buka project Apps Script.
2. Di kanan atas, klik Deploy > Manage deployment.
3. Di sebelah kiri pada bagian Diarsipkan, pilih deployment yang ingin di-deploy ulang, lalu klik Edit > Deploy.