Menjalankan suite Continuous Integration

Eksekusi Continuous Integration (CI) dapat dipicu dengan beberapa cara:

Setelah pengujian validasi selesai, Anda dapat meninjau hasilnya, seperti yang dijelaskan di halaman dokumentasi Melihat hasil eksekusi Integrasi Berkelanjutan.

Pemicuan otomatis dari permintaan pull

Jika Anda telah mengaktifkan suite CI dengan Pemicu pada permintaan pull dari Looker, CI akan memicu validasi secara otomatis saat developer Looker mengirimkan permintaan pull ke repositori LookML Anda. (Anda dapat secara opsional menentukan bahwa permintaan pull hanya ke cabang tertentu di repositori Anda yang akan memicu eksekusi CI otomatis.)

Untuk menjalankan validasi permintaan pull otomatis, CI akan memvalidasi commit permintaan pull terbaru dan menampilkan semua error dalam versi repositori tersebut.

Lihat halaman dokumentasi Melihat hasil eksekusi Continuous Integration untuk mengetahui informasi tentang cara melihat hasil.

Pemicuan otomatis dari dbt Cloud

Jika Anda telah mengaktifkan rangkaian CI dengan Pemicu pada permintaan pull dari dbt Cloud, CI akan memicu proses validasi secara otomatis saat tugas CI dbt Cloud yang ditentukan selesai.

Eksekusi CI yang dipicu oleh tugas CI dbt Cloud dirancang untuk memeriksa apakah perubahan skema yang dilakukan di dbt akan merusak konten LookML. Selama menjalankan, Looker akan melakukan tindakan berikut:

  1. Menerima notifikasi dari dbt Cloud setelah tugas selesai.
  2. Mengekstrak detail skema sementara yang dibuat oleh dbt Cloud untuk operasi tertentu tersebut.
  3. Menggantikan Atribut Pengguna yang dikonfigurasi (misalnya, atribut skema untuk koneksi Anda) dengan nama skema sementara ini.
  4. Menjalankan validator CI terhadap skema sementara ini.

Hal ini memungkinkan Anda menemukan perubahan yang merusak (seperti kolom yang dihapus atau tabel yang diganti namanya) sebelum perubahan dbt digabungkan ke produksi. Setelah proses selesai, nilai atribut pengguna akan dikembalikan ke nilai standarnya untuk pengguna CI.

Pemicuan otomatis sesuai jadwal

Jika Anda telah mengaktifkan rangkaian CI dengan Picu sesuai jadwal, CI akan memicu proses validasi secara otomatis sesuai jadwal yang Anda tentukan.

Untuk menjalankan validasi terjadwal otomatis, CI memvalidasi versi produksi repositori dan menampilkan semua error dalam versi tersebut.

Lihat halaman dokumentasi Melihat hasil eksekusi Continuous Integration untuk mengetahui informasi tentang cara melihat hasil.

Memicu secara manual eksekusi baru rangkaian CI

Pengguna Looker dengan izin see_ci dapat memicu eksekusi CI secara manual dari IDE Looker.

Untuk memicu secara manual eksekusi baru rangkaian CI, ikuti langkah-langkah berikut:

  1. Dari IDE Looker, klik ikon Integrasi Berkelanjutan dari menu navigasi IDE.
  2. Klik Suites untuk membuka halaman Suites.
  3. Klik tombol Run suite untuk rangkaian CI yang ingin Anda jalankan (jika tidak memiliki rangkaian CI untuk project, Anda dapat membuat rangkaian CI).
  4. 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 Produksi.
    • Jika Anda ingin memvalidasi cabang pengembangan project LookML, klik Mode Dev. Gunakan menu pull-down Branch untuk memilih cabang pengembangan yang akan divalidasi.
  5. Untuk memicu eksekusi rangkaian CI, klik Start run.

Rangkaian CI mungkin memerlukan waktu beberapa menit untuk menyelesaikan prosesnya, bergantung pada ukuran project, validator yang disertakan dalam rangkaian CI, dan konfigurasi rangkaian CI.

Setelah Anda memicu eksekusi, Looker IDE akan menampilkan halaman Run untuk rangkaian yang Anda picu. Setelah pengujian validasi selesai, halaman Run akan menampilkan hasil untuk setiap validator. Anda dapat keluar dari halaman Run saat pengujian validasi sedang berjalan, lalu kembali ke halaman Run untuk melihat hasilnya.

Lihat halaman dokumentasi Melihat hasil eksekusi Continuous Integration untuk mengetahui informasi tentang cara melihat hasil.

Workspace

Saat memicu eksekusi CI secara manual, Anda dapat menggunakan opsi Workspace untuk memvalidasi versi produksi repositori atau cabang pengembangan repositori.

Untuk opsi Produksi, jika Anda ingin mengidentifikasi cabang atau commit mana yang digunakan untuk versi produksi, Anda dapat melihat di Looker IDE di kolom Default Production Branch pada bagian Git Summary di halaman Branch Management pada Project Settings:

  • Untuk project yang dikonfigurasi dengan mode deployment lanjutan, versi produksi adalah commit atau tag yang dipilih di pengelola deployment oleh developer Looker yang memiliki izin deploy.
  • Untuk project tanpa mode deployment lanjutan, versi produksi adalah cabang yang dikonfigurasi di kolom Git Production Branch Name di halaman Project Configuration pada Project Settings.

Untuk opsi Dev Mode, perhatikan hal berikut untuk memvalidasi cabang pengembangan di project Anda:

  • Untuk melihat cabang di project LookML Anda dan mengidentifikasi cabang produksi serta cabang pribadi developer Anda, lihat halaman Pengelolaan Cabang di Setelan Project project Anda di IDE Looker.
  • Untuk memvalidasi cabang pengembangan, cabang pengembangan harus di-push 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 proses CI sebelumnya secara manual

Untuk operasi yang telah selesai (jika operasi lulus, gagal, error, atau dibatalkan), pengguna Looker dengan izin see_ci dapat memicu ulang operasi CI secara manual dari IDE Looker:

  • Jika Anda menjalankan ulang proses yang dipicu PR, Integrasi Berkelanjutan akan berjalan terhadap commit yang sama dengan proses awal.
  • Jika Anda menjalankan ulang proses yang dipicu secara manual, Integrasi Berkelanjutan akan berjalan terhadap status produksi atau HEAD cabang pada saat proses dijalankan ulang, yang akan mencakup semua commit berikutnya yang dilakukan sejak proses CI awal.

Selain itu, jika Anda telah mengedit rangkaian CI sejak dijalankan pertama kali, rangkaian CI yang dijalankan ulang akan mencakup perubahan apa pun yang Anda buat pada rangkaian CI sejak dijalankan pertama kali.

Untuk menjalankan ulang proses CI, ikuti langkah-langkah berikut:

  1. Dari IDE Looker, klik ikon Integrasi Berkelanjutan dari menu navigasi IDE.
  2. Klik Runs untuk membuka halaman Runs.
  3. Di halaman Runs, klik tombol View Run untuk menjalankan CI yang ingin Anda batalkan.
  4. Di halaman hasil eksekusi untuk eksekusi yang dipilih, klik tombol Rerun di bagian atas halaman.

Setelah Anda mengklik Jalankan ulang, Validator Konten akan memulai proses dan mengarahkan Anda kembali ke halaman Jalankan untuk proses baru.

Lihat halaman dokumentasi Melihat hasil eksekusi Continuous Integration untuk mengetahui informasi tentang cara melihat hasil.

Membatalkan proses CI

Jika ingin membatalkan proses CI yang sedang berjalan, Anda dapat melakukannya dari halaman Run dengan mengikuti langkah-langkah berikut:

  1. Dari IDE Looker, klik ikon Integrasi Berkelanjutan dari menu navigasi IDE.
  2. Klik Runs untuk membuka halaman Runs.
  3. Di halaman Runs, klik tombol View Run untuk menjalankan CI yang ingin Anda batalkan.
  4. Di halaman Run untuk proses yang dipilih, klik tombol Cancel di bagian atas halaman.

Setelah Anda mengklik Cancel, Integrasi Berkelanjutan akan membatalkan tampilan proses dan menampilkan status Cancelled di halaman Run.