Perlu diperhatikan bahwa Anda sedang melihat dokumentasi Looker. Untuk melihat dokumentasi Looker Studio, buka https://support.google.com/looker-studio.

Mode deploy lanjutan

Dengan integrasi Git Looker default, developer Looker melakukan perubahan ke cabang pengembangan mereka, lalu menggabungkan cabang pengembangan ke cabang produksi. Kemudian, saat Anda men-deploy ke lingkungan Looker, Looker menggunakan commit terbaru di cabang produksi. (Lihat halaman dokumentasi Menggunakan kontrol versi dan deployment untuk alur kerja Git default dan opsi lainnya untuk implementasi Git lanjutan.)

Untuk implementasi Git lanjutan di mana Anda tidak ingin commit terbaru di cabang produksi digunakan untuk lingkungan Looker, admin Looker dapat mengaktifkan mode deploy lanjutan. Jika diaktifkan, mode deploy lanjutan memungkinkan developer dengan izin deploy menentukan SHA atau tag commit yang berbeda untuk di-deploy ke lingkungan produksi Looker Anda, bukan menggunakan commit terbaru di cabang produksi. Jika ingin men-deploy commit dari cabang lain, Anda dapat menggunakan webhook atau endpoint API mode deploy lanjutan.

Mode deploy lanjutan membantu menggabungkan repositori di alur kerja developer multi-lingkungan, dengan setiap lingkungan mengarah ke versi codebase yang berbeda. Hal ini juga memberi satu atau beberapa developer atau administrator kontrol yang lebih besar atas perubahan yang di-deploy ke produksi.

Saat mode deploy lanjutan diaktifkan, Looker tidak meminta developer untuk men-deploy perubahan ke produksi. Sebagai gantinya, Looker akan meminta developer untuk menggabungkan perubahan mereka ke cabang produksi. Dari sana, perubahan hanya dapat di-deploy dengan cara berikut:

Menggunakan pengelola deployment
Memicu webhook
Menggunakan endpoint API

Mengaktifkan mode deploy lanjutan

Untuk mengaktifkan mode deploy lanjutan:

Buka tab Configuration di halaman Project Settings dengan memilih ikon Settings dari menu ikon di sebelah kiri.
Pilih kotak centang di samping Enable Advanced Deploy Mode, di bagian Deployment.
Pilih tombol Save Project Configuration untuk menyimpan perubahan.

Kontrol versi dengan mode deploy lanjutan

Saat mode deploy lanjutan diaktifkan, deployment ke produksi dari Looker tidak lagi dapat dilakukan bagi developer. Sebagai gantinya, saat developer membuat commit, tombol tersebut akan meminta mereka untuk menggabungkan perubahan ke cabang utama, bukan meminta mereka untuk men-deploy ke produksi.

Perubahan di-deploy ke produksi menggunakan webhook, API, atau pengelola deployment.

Pengelola deployment

Untuk project dengan mode deploy lanjutan diaktifkan, developer Looker yang memiliki izin deploy dapat menggunakan pengelola deployment untuk men-deploy commit atau tag ke lingkungan produksi Looker mereka.

Deployment Manager menampilkan semua commit dan tag yang sebelumnya di-deploy menggunakan mode deployment lanjutan.

Seperti yang dijelaskan di bagian Menerapkan commit dari deployment manager di halaman ini, Anda dapat men-deploy commit dengan atau tanpa tag. Jika Anda menerapkan commit dengan tag, pengelola deployment akan menampilkan SHA tag, yang berbeda dengan SHA commit. Anda dapat menggunakan histori commit project Looker untuk melihat SHA commit yang terkait dengan tag. Jika tidak, jika Anda men-deploy commit tanpa tag, pengelola deployment akan menampilkan SHA commit, yang sama dengan SHA commit yang dapat Anda lihat di antarmuka penyedia Git atau di histori commit project Looker Anda.

Jika Anda belum menggunakan mode deploy lanjutan untuk men-deploy commit, pilih tombol Pilih Commit untuk melihat histori commit dengan commit yang telah digabungkan oleh developer Looker Anda ke cabang produksi.

Untuk project yang telah menggunakan mode deploy lanjutan untuk men-deploy commit, histori commit juga akan menampilkan tag terkait commit, jika ada, dan akan menunjukkan commit mana yang merupakan versi saat ini yang digunakan untuk produksi.

Jika cabang produksi memiliki commit yang lebih baru daripada commit yang di-deploy, pengelola deployment akan menampilkan informasi ini dan menunjukkan commit terbaru yang telah digabungkan oleh developer Looker Anda ke cabang produksi.

Men-deploy commit dari deployment manager

Ada beberapa cara untuk men-deploy commit dari pengelola deployment:

Untuk men-deploy commit yang belum di-deploy, pilih tombol Select Commit untuk memilih dari semua commit yang telah digabungkan ke cabang produksi jarak jauh. (Jika Anda ingin men-deploy commit dari cabang lain, gunakan webhook atau endpoint API mode deploy lanjutan.)
Untuk men-deploy commit gabungan terbaru di cabang produksi jarak jauh, pilih tombol Deploy Terbaru.
Untuk menerapkan commit atau tag yang telah diterapkan sebelumnya, pilih menu Options tiga titik dari deployment manager, lalu Deploy to Production.

Jika Anda memilih commit yang belum di-deploy sebelumnya, pengelola deployment akan menampilkan modal Deploy Commit.

Untuk men-deploy commit tanpa menetapkan tag, pilih Terapkan tanpa pemberian tag, lalu pilih Terapkan ke Lingkungan. Jika tidak, tetap pilih opsi Tag dan deploy.
Tentukan tag untuk commit. Tag Git menandai signifikansi commit dalam histori repositori, seperti nomor rilis atau nama versi. Perhatikan hal-hal berikut tentang tag Git:
- Tag Git harus unik dalam repositori Git. Anda tidak dapat menggunakan tag yang sama untuk dua commit yang berbeda di repositori Anda.
- Tag Git tidak boleh berisi spasi atau karakter khusus tertentu. Lihat dokumentasi Referensi Git untuk mengetahui aturan penamaan referensi di Git.
Anda juga dapat menambahkan deskripsi untuk tag guna memberikan detail lebih lanjut tentang commit.
Pilih Deploy to Environment untuk men-deploy commit ke versi produksi instance Looker Anda.

Setelah Anda men-deploy commit, pengelola deployment akan menandai commit tersebut sebagai versi saat ini di lingkungan produksi Looker Anda.

Men-deploy dengan webhook

Untuk project dengan mode deploy lanjutan, Anda dapat menggunakan webhook deploy untuk men-deploy perubahan ke produksi.

Untuk menyiapkan webhook deploy, Anda harus terlebih dahulu menambahkan rahasia webhook untuk project Looker Anda dari halaman Setelan Project. Hal ini untuk memastikan bahwa hanya pihak yang diberi otorisasi yang dapat memicu webhook deployment.

Dua webhook tersedia untuk men-deploy perubahan ke produksi dengan mengaktifkan mode deploy lanjutan. Satu webhook untuk men-deploy head cabang, dan webhook lainnya untuk men-deploy SHA atau tag Git tertentu.

Webhook untuk men-deploy head cabang menggunakan format ini:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>

Webhook untuk men-deploy SHA atau tag commit menggunakan format ini:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>

Ganti informasi dalam tanda kurung sudut < > dengan informasi khusus untuk alamat instance, project LookML, dan nama cabang atau commit SHA/tag Anda. Berikut adalah contoh webhook untuk men-deploy nama tag v1.0 untuk project e_faa di instance Looker docsexamples.dev.looker.com:

https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0

Men-deploy dengan API

Untuk project dengan mode deploy lanjutan, Anda dapat menggunakan Looker API untuk men-deploy perubahan pada produksi.

Untuk men-deploy dengan API, pengguna API yang melakukan panggilan harus memiliki izin deploy. Lihat halaman dokumentasi Autentikasi Looker API dan Mulai menggunakan API untuk mendapatkan informasi selengkapnya tentang cara mengautentikasi dan menggunakan Looker API.

Untuk men-deploy dengan API, gunakan endpoint deploy_ref_to_production. Endpoint ini dapat dipanggil dengan beberapa cara. Contoh berikut adalah untuk metode HTTPS dan SDK.

HTTPS

Saat menggunakan contoh berikut, pastikan untuk mengganti informasi dalam tanda kurung sudut < > dengan informasi khusus untuk alamat instance, project LookML, nama cabang, SHA, atau tag Anda.

Untuk men-deploy secara manual menggunakan endpoint deploy_ref_to_production API, lihat contoh berikut, yang menggunakan metode HTTPS. Untuk mengetahui informasi selengkapnya dan contoh cara memanggil API secara manual menggunakan permintaan CURL, lihat readme GitHub Cara Melakukan Autentikasi ke API, atau gunakan API Explorer. Anda dapat menginstal API Explorer di instance Looker dari Looker Marketplace.

Gunakan contoh berikut dalam permintaan HTTPS untuk men-deploy head cabang atau SHA atau tag commit tertentu melalui endpoint deploy_ref_to_production API:

Deploy head cabang: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>

Men-deploy SHA atau tag commit: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>

SDK

Saat menggunakan contoh berikut, pastikan untuk mengganti informasi dalam tanda kurung sudut < > dengan informasi yang spesifik untuk project LookML Anda, serta nama cabang, SHA, atau tag.

Atau, gunakan salah satu SDK Looker dan jangan membuat permintaan manual ke API. SDK menangani detail autentikasi, serialisasi parameter dan respons, serta masalah lainnya.

Men-deploy dengan deploy_ref_to_production dengan metode SDK akan terlihat seperti berikut:

Deploy head cabang: deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})

Men-deploy SHA atau tag commit: deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})