Proses Continuous Integration (CI) dapat dipicu dengan beberapa cara:
- Secara otomatis saat permintaan pull dikirim ke repositori project LookML Anda oleh developer Looker (lihat halaman Membuat suite Continuous Integration untuk mengetahui informasi tentang cara menyiapkannya).
- Secara otomatis saat permintaan pull dikirim ke project LookML yang diimpor (lihat halaman Membuat suite Continuous Integration untuk mengetahui informasi tentang cara menyiapkannya).
- Secara otomatis saat tugas CI dbt Cloud selesai (lihat halaman Membuat suite Continuous Integration untuk mengetahui informasi tentang cara menyiapkannya).
- Secara otomatis pada jadwal berulang (lihat halaman Membuat suite Continuous Integration untuk mengetahui informasi tentang cara menyiapkannya).
- Memicu secara manual eksekusi baru suite CI dari Looker IDE.
- Menjalankan ulang secara manual operasi CI sebelumnya dari Looker IDE.
Setelah pengujian validasi selesai, Anda dapat meninjau hasilnya, seperti yang dijelaskan di halaman dokumentasi Melihat hasil operasi Continuous Integration.
Pemicuan otomatis dari permintaan pull
Jika Anda telah mengaktifkan suite CI dengan Trigger on pull requests from Looker, CI akan otomatis memicu operasi validasi saat developer Looker mengirimkan permintaan pull ke repositori LookML Anda. (Secara opsional, Anda dapat menentukan bahwa permintaan pull hanya ke cabang tertentu di repositori Anda yang akan memicu operasi CI otomatis.)
Untuk operasi validasi permintaan pull otomatis, CI memvalidasi commit permintaan pull terbaru dan menampilkan semua error dalam versi repositori tersebut.
Lihat halaman dokumentasi Melihat hasil operasi Continuous Integration untuk mengetahui informasi tentang cara melihat hasilnya.
Pemicuan otomatis dari permintaan pull project yang diimpor
Jika Anda telah mengaktifkan suite CI di project downstream (spoke) dengan Trigger on pull requests from imported projects, CI akan otomatis memicu operasi validasi di project spoke saat developer membuka atau memperbarui permintaan pull di repositori project upstream (hub) yang berlangganan.
Selama CI dijalankan dan dipicu oleh permintaan pull project yang diimpor, Looker akan melakukan tindakan berikut:
- Memvalidasi versi produksi project spoke sambil menyematkan sementara project hub yang diimpor ke commit permintaan pull.
- Menulis hasil operasi CI project spoke kembali ke permintaan pull di repositori project hub.
Lihat halaman dokumentasi Melihat hasil operasi Continuous Integration untuk mengetahui informasi tentang cara melihat hasilnya.
Pemicuan otomatis dari dbt Cloud
Jika Anda telah mengaktifkan suite CI dengan Trigger on pull requests from dbt Cloud, CI akan memicu operasi validasi secara otomatis saat tugas CI dbt Cloud yang ditentukan selesai.
CI run yang dipicu oleh tugas dbt Cloud CI dirancang untuk memeriksa apakah perubahan skema yang dibuat di dbt akan merusak konten LookML. Selama proses berjalan, Looker akan melakukan tindakan berikut:
- Menerima notifikasi dari dbt Cloud setelah tugas selesai.
- Mengekstrak detail skema sementara yang dibuat oleh dbt Cloud untuk operasi tertentu tersebut.
- Mengganti Atribut Pengguna yang dikonfigurasi (misalnya, atribut skema untuk koneksi Anda) dengan nama skema sementara ini.
- Menjalankan validator CI terhadap skema sementara ini.
Hal ini memungkinkan Anda menemukan perubahan yang dapat menyebabkan gangguan (seperti kolom yang dihapus atau tabel yang diganti namanya) sebelum perubahan dbt digabungkan ke produksi. Setelah operasi selesai, nilai atribut pengguna akan kembali ke nilai standarnya untuk pengguna CI.
Pemicuan otomatis sesuai jadwal
Jika Anda telah mengaktifkan suite CI dengan Picu sesuai jadwal, CI akan otomatis memicu proses validasi sesuai jadwal yang Anda tentukan.
Untuk operasi validasi terjadwal otomatis, CI memvalidasi versi produksi repositori dan menampilkan semua error dalam versi tersebut.
Lihat halaman dokumentasi Melihat hasil operasi Continuous Integration untuk mengetahui informasi tentang cara melihat hasilnya.
Memicu eksekusi baru suite CI secara manual
Pengguna Looker dengan izin see_ci dapat memicu CI run secara manual dari Looker IDE.
Untuk memicu eksekusi baru suite CI secara manual, ikuti langkah-langkah berikut:
- Dari Looker IDE, klik ikon Continuous Integration dari menu navigasi IDE.
- Klik Suites untuk membuka halaman Suites.
- Klik tombol Run suite untuk suite CI yang ingin Anda jalankan (jika tidak memiliki suite CI untuk project, Anda dapat membuat suite CI).
Dalam dialog Trigger a run manually, gunakan opsi Workspace untuk memilih cabang yang ingin Anda validasi (lihat bagian Workspace untuk mengetahui detailnya):
- Untuk memvalidasi versi produksi project LookML Anda, klik Production.
- Jika Anda ingin memvalidasi cabang pengembangan project LookML, klik Dev Mode. Gunakan menu pull-down Branch untuk memilih cabang pengembangan yang akan divalidasi.
Untuk memicu eksekusi suite CI, klik Start run.
Suite CI mungkin memerlukan waktu beberapa menit untuk menyelesaikan prosesnya, bergantung pada ukuran project Anda, validator yang disertakan dalam suite CI, dan konfigurasi suite CI.
Setelah Anda memicu operasi, Looker IDE akan menampilkan halaman Run untuk suite yang Anda picu. Setelah pengujian validasi selesai, halaman Run akan menampilkan hasil untuk setiap validator. Anda dapat keluar dari halaman Run saat pengujian validasi berjalan, lalu kembali ke halaman Run untuk melihat hasilnya.
Lihat halaman dokumentasi Melihat hasil operasi Continuous Integration untuk mengetahui informasi tentang cara melihat hasilnya.
Workspace
Saat memicu operasi CI secara manual, Anda dapat menggunakan opsi Workspace untuk memvalidasi versi produksi repositori atau cabang pengembangan repositori Anda.
Untuk opsi Production, jika ingin mengidentifikasi cabang atau commit yang digunakan untuk versi produksi, Anda dapat melihat di Looker IDE di kolom Default Production Branch di bagian Git Summary pada halaman Branch Management di Setelan Project:
- Untuk project yang dikonfigurasi dengan mode deploy lanjutan, versi produksi adalah commit atau tag yang dipilih di deployment manager oleh developer Looker yang memiliki izin
deploy. - Untuk project tanpa mode deploy lanjutan, versi produksi adalah cabang yang dikonfigurasi di kolom Git Production Branch Name di halaman Project Configuration di Setelan Project.
Untuk opsi Dev Mode, perhatikan hal berikut untuk memvalidasi cabang pengembangan dalam project Anda:
- Untuk melihat cabang di project LookML Anda serta mengidentifikasi cabang produksi dan cabang pribadi developer, lihat halaman Branch Management di Setelan Project project Anda di Looker IDE.
- Untuk memvalidasi cabang pengembangan, cabang pengembangan harus dikirim ke repositori LookML Anda. Di Looker IDE, artinya developer harus mengklik tombol Commit Changes & Push atau memilih opsi Commit dari panel Git Actions di IDE.
Menjalankan ulang secara manual proses CI sebelumnya
Untuk operasi yang telah selesai (jika operasi berhasil, gagal, mengalami error, atau dibatalkan), pengguna Looker dengan izin see_ci dapat memicu operasi ulang CI secara manual dari Looker IDE:
- Jika Anda menjalankan ulang operasi yang dipicu PR (yang dipicu oleh permintaan pull di repositori project atau di project yang diimpor), Continuous Integration akan berjalan terhadap commit yang sama dengan operasi aslinya.
- Jika Anda menjalankan ulang operasi yang dipicu secara manual, Continuous Integration akan berjalan terhadap status produksi atau HEAD cabang pada saat operasi dijalankan ulang, yang akan menyertakan commit berikutnya yang dibuat sejak operasi CI awal.
Selain itu, jika Anda telah mengedit CI suite sejak eksekusi awal, eksekusi ulang akan menyertakan perubahan apa pun yang Anda buat pada CI suite sejak eksekusi awal.
Untuk menjalankan ulang operasi CI, ikuti langkah-langkah berikut:
- Dari Looker IDE, klik ikon Continuous Integration dari menu navigasi IDE.
- Klik Runs untuk membuka halaman Runs.
- Di halaman Runs, klik tombol View Run untuk operasi CI yang ingin Anda batalkan.
- Di halaman hasil operasi untuk operasi yang dipilih, klik tombol Rerun di bagian atas halaman.
Setelah Anda mengklik Rerun, Validator Konten akan memulai proses dan mengembalikan Anda ke halaman Run untuk proses baru.
Lihat halaman dokumentasi Melihat hasil operasi Continuous Integration untuk mengetahui informasi tentang cara melihat hasilnya.
Membatalkan operasi CI
Jika ingin membatalkan CI run yang sedang berjalan, Anda dapat melakukannya dari halaman Run dengan mengikuti langkah-langkah berikut:
- Dari Looker IDE, klik ikon Continuous Integration dari menu navigasi IDE.
- Klik Runs untuk membuka halaman Runs.
- Di halaman Runs, klik tombol View Run untuk operasi CI yang ingin Anda batalkan.
- Di halaman Run untuk operasi yang dipilih, klik tombol Cancel di bagian atas halaman.
Setelah Anda mengklik Cancel, Continuous Integration akan membatalkan operasi dan menampilkan status Cancelled di halaman Run.