Mengonfigurasi secret deploy webhook

Endpoint deployment webhook meminta instance Looker Anda untuk men-deploy perubahan dari cabang Git, SHA commit, atau nama tag, lalu mendorong perubahan ke versi produksi project Anda. (Lihat bagian Men-deploy dengan webhook untuk format webhook deployment Looker.) Untuk sebagian besar project, Looker menangani integrasi Git dan men-deploy update ke produksi, sehingga Anda tidak perlu menyiapkan webhook deployment.

Namun, Anda harus menggunakan webhook deployment untuk mendorong perubahan ke produksi jika salah satu situasi berikut berlaku:

  • Anda mendorong update ke cabang produksi jarak jauh di luar IDE Looker, yang umum dalam alur kerja pengembangan dengan lingkungan staging.
  • Anda ingin menggunakan webhook untuk melakukan deployment dengan mode deployment lanjutan, yang memungkinkan Anda menentukan cabang, SHA commit, atau nama tag yang digunakan untuk versi produksi project Looker.
  • Anda telah mengonfigurasi project Looker dengan permintaan pull Git, yang berarti Anda harus memicu webhook deployment setelah menggabungkan permintaan pull untuk mendorong perubahan tersebut ke lingkungan produksi Looker. Sebagian besar layanan hosting Git memiliki cara untuk mengotomatiskan hal ini jika Anda menambahkan webhook ke antarmuka penyedia Git.

Jika Anda adalah admin Looker, Anda dapat mengonfigurasi webhook deployment agar memerlukan secret sehingga hanya pihak yang berwenang yang dapat memicunya. Developer Looker yang bukan admin dapat melihat halaman Project Configuration, tetapi tidak dapat mengubah opsi di sana.

Menambahkan secret deployment

Looker mendukung secret web untuk penyedia Git berikut: GitHub, Bitbucket Server, dan GitLab.

Untuk menetapkan secret deploy webhook ke project Anda:

  1. Dalam Mode Pengembangan, buka project Anda dan pilih ikon setelan di menu navigasi IDE untuk membuka panel setelan project.
  2. Pilih Configuration di panel setelan project.
  3. Scroll ke bagian Webhook Deploy Secret, lalu klik Set Webhook Secret. Looker akan otomatis membuat token rahasia. Anda dapat menggunakan secret yang dibuat secara otomatis ini, atau Anda dapat mengetik token secret Anda sendiri.
  4. Baik Anda menggunakan secret yang dibuat secara otomatis atau membuat secret Anda sendiri, salin secret deployment webhook dan tempelkan ke file teks sehingga Anda akan memilikinya jika perlu menambahkan secret ke webhook untuk repositori Anda. Pastikan untuk menyalinnya pada tahap ini. Setelah keluar atau memuat ulang halaman Project Configuration, Anda akan kehilangan akses ke secret deployment webhook dan harus mengubah atau menghapus secret deployment webhook untuk mendapatkan kembali akses ke project Anda.
  5. Klik Save Project Configuration.

Webhook deploy untuk project Anda sekarang memerlukan secret ini. Untuk project yang menggunakan instance staging Looker, Anda harus menyertakan secret deployment webhook di header HTTP untuk men-deploy ke produksi. Untuk project dengan integrasi permintaan pull Git, Anda harus membuka antarmuka penyedia Git untuk menambahkan secret ke webhook untuk repositori Anda.

Mengonfigurasi secret untuk webhook repositori Git Anda

Untuk project dengan integrasi permintaan pull Git, jika Anda telah menambahkan secret webhook deployment ke project LookML, Anda harus membuka antarmuka penyedia Git untuk menambahkan secret ke webhook untuk repositori Anda. Sebagai contoh, berikut cara melakukannya menggunakan GitHub:

  1. Buka setelan repositori project Anda di situs penyedia Git.

    TIPS: Jika telah menyiapkan project untuk integrasi Git, Anda dapat menggunakan opsi Lihat Project di Git dari menu Git project di Looker.

  2. Di setelan repositori, klik Webhook.

  3. Temukan webhook untuk project LookML Anda, lalu klik tombol Edit.

  4. Di kolom Secret, tempel secret deploy webhook yang Anda salin dari bagian Webhook Deploy Secret di Looker.

  5. Klik Perbarui webhook.

Rahasia webhook kini diperlukan untuk men-deploy perubahan ke versi produksi project Anda. Jika perlu, Anda dapat mengubah secret atau menghapus secret dari project.

Mengubah secret deployment

Setelah secret deployment webhook ditambahkan ke project, jika Anda adalah admin Looker, Anda dapat mengubah secret dengan melakukan tindakan berikut:

  1. Dari project Anda, pilih ikon Setelan dari menu navigasi.
  2. Scroll ke bagian Webhook Deploy Secret, lalu klik Reset Secret. Looker akan otomatis membuat token rahasia baru. Anda dapat menggunakan secret yang dibuat secara otomatis ini, atau mengetik token secret baru Anda sendiri.
  3. Baik Anda menggunakan secret yang dibuat secara otomatis atau membuat secret Anda sendiri, salin secret deployment webhook dan tempelkan ke file teks sehingga Anda akan memilikinya jika perlu menambahkan secret ke webhook untuk repositori Anda. Pastikan untuk menyalinnya dari papan klip Anda pada tahap ini. Setelah keluar atau memuat ulang halaman Project Configuration, Anda akan kehilangan akses ke secret deployment webhook dan harus kembali dan mengubahnya atau menghapusnya sepenuhnya.
  4. Klik Save Project Configuration.

Jika project Anda dikonfigurasi dengan integrasi permintaan pull Git, Anda juga harus membuka antarmuka penyedia Git untuk memperbarui secret webhook untuk repositori Anda.

Menghapus secret deployment

Setelah secret deployment webhook ditambahkan ke project, jika Anda adalah admin Looker, Anda dapat menghapus secret dengan melakukan tindakan berikut:

  1. Dari project Anda, pilih ikon Setelan dari menu navigasi.
  2. Scroll ke bagian Webhook Deploy Secret, lalu klik Remove Secret. Pada tahap ini, Anda dapat membatalkan operasi dan menyimpan secret deployment dengan mengklik Jangan Hapus.
  3. Untuk menghapus secret deployment webhook secara permanen dari project Anda, klik Save Project Configuration.

Project Anda tidak lagi memerlukan secret untuk webhook deployment. Jika project Anda dikonfigurasi dengan integrasi permintaan pull Git, Anda kini dapat membuka antarmuka penyedia Git untuk menghapus secret webhook dari repositori. Looker itu sendiri tidak akan lagi memeriksa secret di sisi penyedia Git, jadi tidak masalah jika webhook repositori Git Anda masih memiliki secret yang dikonfigurasi. Jika Anda ingin menghapus secret dari repositori Git, lihat Mengonfigurasi Secret untuk Webhook Repositori Git Anda untuk mengetahui informasi tentang cara mengedit secret di antarmuka penyedia Git.