Rangkaian Continuous Integration (CI) adalah serangkaian petunjuk validasi yang terkait dengan project LookML Anda. Pengguna Looker dengan izin manage_ci dapat mengonfigurasi hal berikut di rangkaian CI:
- Cara menjalankan validasi CI dipicu (secara manual dari IDE Looker atau secara otomatis saat permintaan pull dikirimkan ke repositori Anda).
- Validator CI mana yang akan dijalankan.
- Opsi tambahan untuk setiap uji validasi. Lihat halaman dokumentasi untuk setiap validator guna mengetahui detailnya:
Sebelum memulai
Sebelum dapat membuat rangkaian CI, Anda memerlukan hal berikut:
- Instance Looker yang memenuhi persyaratan untuk CI dan yang diaktifkan untuk CI.
- Akun pengguna Looker dengan izin
manage_ci(izin ini disertakan dalam set izin Admin).
Membuat rangkaian CI
Anda dapat mengonfigurasi dan menjalankan validator di halaman Suites di Looker IDE:
Untuk membuat rangkaian CI, ikuti langkah-langkah berikut:
- Dari IDE Looker, klik ikon Integrasi Berkelanjutan dari menu navigasi IDE.
- Klik tab Suites untuk membuka halaman Suites.
- Di halaman Rangkaian, Anda dapat membuat rangkaian baru atau mengedit rangkaian yang ada:
- Untuk membuat rangkaian pengujian baru, klik tombol Buat rangkaian pengujian.
- Untuk mengedit rangkaian yang ada, klik tombol Edit rangkaian untuk rangkaian tersebut.
- Masukkan nama untuk Nama suite. Jika Anda mengedit rangkaian yang ada, Anda dapat mengklik ikon pensil untuk mengedit nama rangkaian.
- (Opsional) Aktifkan tombol Picu sesuai jadwal jika Anda ingin menyiapkan pengujian validasi otomatis sesuai jadwal berulang. Lihat bagian Picu sesuai jadwal di halaman ini untuk mengetahui informasi selengkapnya.
(Opsional) Aktifkan tombol Picu permintaan pull dari Looker jika Anda ingin menyiapkan pengujian validasi otomatis setiap kali developer Looker mengirimkan permintaan pull ke repositori Anda. Lihat bagian Pemicu pada permintaan pull dari Looker di halaman ini untuk mengetahui informasi selengkapnya.
Jika mengaktifkan pemicuan permintaan pull untuk rangkaian CI, Anda dapat menggunakan kolom Hanya untuk cabang target secara opsional untuk menentukan bahwa permintaan pull hanya ke cabang tertentu di repositori yang akan memicu eksekusi rangkaian CI. Lihat bagian Pemicu pada permintaan pull dari Looker di halaman ini untuk mengetahui informasi selengkapnya.
(Opsional) Aktifkan tombol Aktifkan pemberitahuan email jika Anda ingin menerima pemberitahuan email berdasarkan status proses CI. Lihat bagian Menyiapkan pemberitahuan di halaman ini untuk mengetahui informasi selengkapnya.
Secara opsional, aktifkan tombol pengonfirmasi untuk mengaktifkan pengonfirmasi dan mengonfigurasi opsinya. Lihat halaman dokumentasi untuk setiap validator guna mengetahui detailnya:
Simpan perubahan Anda:
- Jika Anda membuat rangkaian baru, klik tombol Buat rangkaian.
- Jika Anda mengedit rangkaian yang ada, klik tombol Perbarui rangkaian.
Pemicu
Eksekusi CI dapat dipicu dengan beberapa cara:
- Secara otomatis, sesuai jadwal berulang.
- Secara otomatis, saat permintaan pull dikirimkan ke repositori project LookML Anda oleh developer Looker.
- Secara manual, menggunakan tombol Jalankan rangkaian pengujian di halaman Rangkaian pengujian di Looker IDE.
- Secara manual, dengan menjalankan ulang proses CI sebelumnya, dari halaman Runs di Looker IDE.
Pemicu sesuai jadwal
Anda dapat mengonfigurasi rangkaian CI agar otomatis dipicu sesuai jadwal dengan mengaktifkan tombol Picu sesuai jadwal.
Jika tombol ini diaktifkan, Anda dapat memilih frekuensi dan spesifikasi untuk menjalankan rangkaian CI secara otomatis:
- Bulanan, pada hari dan waktu tertentu
- Setiap minggu, pada hari dan waktu tertentu
- Harian, pada waktu tertentu
- Per jam atau setiap 2, 3, 4, 6, 8, atau 12 jam, dimulai dan diakhiri pada waktu tertentu dalam sehari
- Menit setiap 5, 10, 15, 20, atau 30 menit, dimulai dan diakhiri pada waktu tertentu dalam sehari
- Bulan tertentu dalam setahun, pada hari dan waktu tertentu
- Hari tertentu dalam seminggu pada waktu tertentu
Pemicu pada permintaan pull dari Looker
Untuk mengonfigurasi rangkaian CI agar dipicu secara otomatis pada permintaan pull, aktifkan tombol Picu pada permintaan pull dari Looker. Untuk menggunakan pemicuan permintaan pull, repositori Git Anda harus dikonfigurasi oleh admin Looker di halaman Continuous Integration Admin Looker).
Jika mengaktifkan pemicu permintaan pull untuk rangkaian CI, Anda dapat secara opsional menentukan bahwa permintaan pull hanya ke cabang tertentu di repositori yang akan memicu rangkaian CI. Untuk membatasi pemicu permintaan pull otomatis dari proses CI ke cabang tertentu di repositori Anda, masukkan daftar cabang yang dipisahkan koma di kolom Hanya untuk cabang target.
Misalnya, jika repositori memiliki tiga cabang bernama main, release_1, dan dev, Anda dapat memasukkan main, release_1 di kolom Hanya untuk cabang target. Artinya, proses CI akan dipicu saat developer Looker mengirimkan permintaan pull ke cabang main atau release_1. Jika developer Looker mengirimkan permintaan pull ke cabang dev, hal ini tidak akan memicu eksekusi otomatis rangkaian CI.
Menyiapkan pemberitahuan
Untuk menerima notifikasi email berdasarkan status eksekusi CI, Anda dapat menyiapkan pemberitahuan untuk rangkaian CI. Dengan begitu, Anda dapat memantau eksekusi Continuous Integration tanpa harus melihat halaman Runs di Looker IDE.
Untuk mengonfigurasi pemberitahuan email untuk rangkaian CI, ikuti langkah-langkah berikut saat membuat atau mengedit rangkaian CI:
- Aktifkan tombol Aktifkan pemberitahuan email.
- Di kolom Alamat email, masukkan daftar alamat email yang dipisahkan dengan koma yang akan menerima notifikasi.
- Gunakan kotak centang untuk memilih status pekerjaan yang harus memicu pemberitahuan:
- Gagal: Memicu email saat proses CI gagal dalam pengujian validasi.
- Error: Memicu email saat proses CI mengalami error sistem atau konfigurasi.
- Lulus: Memicu email saat proses CI berhasil diselesaikan.
- Dibatalkan: Memicu email saat proses CI dibatalkan.
Menghapus rangkaian
Untuk menghapus rangkaian CI, lakukan langkah-langkah berikut:
- Dari IDE Looker, klik ikon Integrasi Berkelanjutan dari menu navigasi IDE.
- Klik tab Suites untuk membuka halaman Suites.
- Di halaman Suites, klik tombol Edit suite untuk rangkaian pengujian.
- Di halaman rangkaian kartu, klik tombol Hapus rangkaian kartu.
- Pada dialog konfirmasi, klik tombol Hapus rangkaian.