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 kode, memantau 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 berversi, yang terhubung ke versi project tertentu.

Deployment head

Deployment head adalah kode project saat ini. Saat membuat project Apps Script, Anda 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 tidak berubah.

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

Deployment dengan versi

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

Saat aplikasi Anda dipublikasikan untuk konsumsi publik, selalu gunakan deployment berversi. 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 sudah 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 dieksekusi, Anda harus mengalihkan asosiasi project Google Cloud Apps Script terlebih dahulu 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 samping 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.

Lihat deployment berversi

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

Untuk melihat kode versi tertentu, buka 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 > Kelola 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 ulang deployment tersebut, lalu ikuti langkah-langkah sebelumnya.

    Jika Anda ingin men-deploy perubahan pada kode project, buat versi baru dan edit deployment tersebut untuk menggunakannya. Versi baru ini 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 berikut:

  1. Buka project Apps Script.
  2. Di kanan atas, klik Deploy > Kelola 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 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 terlebih dahulu membuat deployment berversi skrip untuk mengakses ID deployment-nya.

Setelah memiliki ID deployment, ikuti langkah-langkah untuk mengaktifkan Google Chat API. Di halaman Configuration di bagian "Izin", tentukan hanya alamat email Anda agar dapat menginstal dan menguji aplikasi.

API Dapat Dieksekusi

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

  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 yang dapat dieksekusi 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 > Kelola 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 > Kelola deployment.
  3. Di sebelah kiri di bagian Diarsipkan, pilih deployment yang ingin di-deploy ulang, lalu klik Edit > Deploy.