Endpoint deployment webhook meminta instance Looker Anda untuk men-deploy perubahan dari cabang Git, SHA commit, atau nama tag, lalu mengirim 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 pembaruan 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 terjadi:
- Anda mendorong update ke cabang produksi jarak jauh di luar Looker IDE, yang umum terjadi dalam alur kerja pengembangan dengan lingkungan staging.
- Anda ingin menggunakan webhook untuk men-deploy dengan mode deployment lanjutan, yang memungkinkan Anda menentukan cabang, SHA commit, atau nama tag yang digunakan untuk versi produksi project Looker Anda.
- 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 Anda. Sebagian besar layanan hosting Git memiliki cara mengotomatiskannya jika Anda menambahkan webhook ke antarmuka penyedia Git.
Jika Anda adalah admin Looker, Anda dapat mengonfigurasi webhook deployment untuk mewajibkan rahasia sehingga hanya pihak yang diizinkan yang dapat memicunya. Developer Looker yang bukan admin dapat melihat halaman Setelan Project, tetapi tidak dapat mengubah opsi di sana.
Menambahkan rahasia deploy
Looker mendukung rahasia web untuk penyedia Git berikut: GitHub, Bitbucket Server, dan GitLab.
Untuk menetapkan rahasia deploy webhook ke project Anda:
- Dalam Mode Pengembangan, buka project Anda, lalu pilih ikon setelan di menu navigasi IDE untuk membuka panel setelan project.
- Pilih Configuration di panel setelan project.
- Scroll ke bagian Webhook Deploy Secret, lalu klik Set Webhook Secret. Looker akan otomatis membuat token rahasia. Anda bisa menggunakan secret yang dihasilkan secara otomatis ini, atau Anda bisa mengetikkan token rahasia Anda sendiri.
- Baik Anda menggunakan secret yang dibuat secara otomatis atau membuat secret Anda sendiri, salin rahasia deploy webhook dan tempelkan ke file teks agar Anda dapat mengaksesnya jika perlu menambahkan rahasia ke webhook untuk repositori Anda. Pastikan untuk menyalinnya pada tahap ini. Setelah keluar atau memuat ulang halaman Setelan Project, Anda akan kehilangan akses ke rahasia deploy webhook dan harus mengubah atau menghapus rahasia deployment webhook untuk mendapatkan kembali akses ke project Anda.
- Klik Save Project Configuration.
Webhook deploy untuk project Anda sekarang memerlukan rahasia ini. Untuk project yang menggunakan instance staging Looker, Anda harus menyertakan rahasia deploy webhook di header HTTP agar dapat men-deploy ke produksi. Untuk project dengan Integrasi permintaan pull Git, Anda harus membuka antarmuka penyedia Git untuk menambahkan rahasia ke webhook untuk repositori Anda.
Mengonfigurasi rahasia untuk webhook repositori Git Anda
Untuk project dengan Integrasi permintaan pull Git, jika telah menambahkan rahasia webhook deploy ke project LookML, Anda harus membuka antarmuka penyedia Git untuk menambahkan rahasia tersebut ke webhook untuk repositori Anda. Sebagai contoh, berikut adalah cara Anda melakukannya menggunakan GitHub:
Buka setelan repositori project di situs penyedia Git Anda.
TIPS: Jika telah menyiapkan project untuk integrasi Git, Anda dapat menggunakan opsi View Project on Git dari menu Git project di Looker.
Di setelan repositori Anda, klik Webhook.
Temukan webhook untuk project LookML Anda, lalu klik tombol Edit.
Di kolom Secret, tempel secret deploy webhook yang Anda salin dari bagian Webhook Deploy Secret di Looker.
Klik Perbarui webhook.
Rahasia webhook sekarang diperlukan untuk men-deploy perubahan ke versi produksi project Anda. Jika perlu, Anda dapat mengubah rahasia atau menghapus rahasia tersebut dari project.
Mengubah rahasia deploy
Setelah rahasia deploy webhook ditambahkan ke project, jika Anda adalah admin Looker, Anda dapat mengubah rahasia tersebut dengan melakukan hal berikut:
- Dari project Anda, pilih ikon Setelan dari menu navigasi.
- Scroll ke bagian Webhook Deploy Secret, lalu klik Reset Secret. Looker akan otomatis membuat token rahasia baru. Anda bisa menggunakan secret yang dihasilkan secara otomatis ini, atau ketik token rahasia yang baru.
- Baik Anda menggunakan secret yang dibuat secara otomatis atau membuat secret Anda sendiri, salin rahasia deploy webhook dan tempelkan ke file teks sehingga Anda akan memilikinya jika perlu menambahkan rahasia ke webhook untuk repositori Anda. Pada tahap ini, pastikan untuk menyalinnya dari papan klip. Setelah keluar atau memuat ulang halaman Setelan Project, Anda akan kehilangan akses ke secret deploy webhook dan harus kembali lalu mengubahnya atau menghapus sama sekali.
- Klik Save Project Configuration.
Jika project Anda dikonfigurasi dengan Integrasi permintaan pull Git, Anda juga harus membuka antarmuka penyedia Git untuk memperbarui rahasia webhook untuk repositori Anda.
Menghapus rahasia deploy
Setelah rahasia deploy webhook ditambahkan ke project, jika Anda adalah admin Looker, Anda dapat menghapus rahasia tersebut dengan melakukan hal berikut:
- Dari project Anda, pilih ikon Setelan dari menu navigasi.
- Scroll ke bagian Webhook Deploy Secret lalu klik Remove Secret. Pada tahap ini, Anda dapat membatalkan operasi dan menyimpan rahasia deployment dengan mengklik Don't Remove.
- Untuk menghapus rahasia deploy webhook dari project Anda secara permanen, klik Save Project Configuration.
Project Anda tidak lagi memerlukan rahasia untuk webhook deployment. Jika project Anda dikonfigurasi dengan Integrasi permintaan pull Git, Anda kini dapat membuka antarmuka penyedia Git untuk menghapus rahasia webhook dari repositori. Looker sendiri tidak akan lagi memeriksa secret di pihak penyedia Git, jadi tidak ada salahnya jika webhook repositori Git Anda masih memiliki secret yang dikonfigurasi. Jika ingin menghapus rahasia dari repositori Git, lihat Mengonfigurasi Secret untuk Webhook Repositori Git untuk mengetahui informasi tentang cara mengedit secret pada antarmuka penyedia Git.