Menggunakan kontrol versi dan deployment

Halaman ini mengasumsikan bahwa project Anda telah disiapkan untuk kontrol versi. Jika melihat tombol Configure Git dan bukan pilihan yang dijelaskan di halaman ini, Anda harus menyiapkan Git untuk project terlebih dahulu.

Looker menggunakan Git untuk merekam perubahan dan mengelola versi file. Setiap project LookML sesuai dengan repositori Git, dan setiap cabang developer berkorelasi dengan cabang Git.

Looker dapat dikonfigurasi agar berfungsi dengan banyak penyedia Git, seperti GitHub, GitLab, dan Bitbucket. Lihat halaman dokumentasi Menyiapkan dan menguji koneksi Git untuk mengetahui informasi tentang cara menyiapkan Git untuk project Looker Anda.

Bekerja dengan cabang Git

Salah satu manfaat utama Git adalah developer Looker dapat bekerja di cabang, versi repositori file yang terisolasi. Anda dapat mengembangkan dan menguji tanpa memengaruhi pengguna lain. Sebagai developer di Looker, Anda menggunakan cabang Git setiap kali berada dalam Mode Pengembangan.

Fitur utama lain dari Git adalah kemudahan berkolaborasi dengan developer lain yang disediakannya. Anda dapat membuat cabang dan (jika diinginkan) melakukan perubahan, lalu developer lain dapat beralih ke cabang tersebut untuk meninjau atau melakukan perubahan pada cabang tersebut. Jika developer lain telah melakukan perubahan pada cabang tersebut, Looker akan menampilkan tombol Pull Remote Changes. Anda harus menarik perubahan yang di-commit tersebut ke cabang sebelum membuat perubahan tambahan.

Anda juga dapat menghapus cabang selain cabang master, cabang saat ini, atau cabang pribadi developer.

Cabang pribadi

Saat pertama kali membuka Mode Pengembangan, Looker akan otomatis membuat cabang Git pribadi Anda. Cabang pribadi Anda diawali dengan dev- dan menyertakan nama Anda.

Cabang pribadi Anda khusus untuk Anda, dan tidak dapat dihapus. Cabang pribadi Anda bersifat hanya-baca untuk semua developer lain. Jika Anda berkolaborasi dengan developer lain dalam suatu project, sebaiknya buat cabang baru agar orang lain dapat beralih ke cabang tersebut dan juga berkontribusi pada perubahan.

Membuat cabang Git baru

Jika Anda sedang mengerjakan perbaikan sederhana dan tidak berkolaborasi dengan developer lain, cabang pribadi Anda biasanya merupakan tempat yang tepat untuk bekerja. Anda dapat menggunakan cabang pribadi untuk melakukan update cepat, lalu melakukan perubahan dan mengirimkannya ke produksi.

Namun, selain cabang pribadi Anda, Anda juga dapat membuat cabang Git baru. Cabang Git baru dapat diterima dalam situasi ini:

  • Anda bekerja sama dengan developer lain. Karena cabang pribadi Anda bersifat hanya-baca bagi developer lain, jika Anda ingin berkolaborasi dengan orang lain, Anda harus membuat cabang Git baru sehingga developer lain dapat menulis ke cabang tersebut. Ketika Anda berkolaborasi dengan orang lain, pastikan untuk melakukan perubahan setiap kali Anda melanjutkan pekerjaan. Dengan begitu, Anda akan mendapatkan info terbaru dari semua developer sebelum melanjutkan pekerjaan.
  • Anda sedang mengerjakan beberapa set fitur sekaligus. Terkadang Anda mungkin berada di tengah-tengah proyek besar, tetapi ingin menyelesaikan masalah kecil atau melakukan perbaikan cepat. Dalam hal ini, Anda dapat melakukan perubahan ke cabang tempat Anda berada, lalu membuat atau beralih ke cabang lain untuk mengerjakan rangkaian fitur yang terpisah. Anda dapat melakukan perbaikan di cabang baru, lalu men-deploy perubahan cabang tersebut ke produksi — sebelum melanjutkan pekerjaan di cabang asli.

Sebelum membuat cabang baru:

  • Jika mengalami konflik penggabungan di cabang saat ini, Anda harus menyelesaikan konflik tersebut sebelum dapat membuat cabang baru.
  • Jika memiliki perubahan yang belum di-commit pada cabang saat ini, Anda harus melakukan commit perubahan pada cabang saat ini sebelum membuat cabang baru.
  • Jika Anda ingin membuat cabang yang dimulai dari cabang pengembangan yang sudah ada (dan bukan cabang produksi), pertama-tama dapatkan versi terbaru cabang pengembangan dengan beralih ke cabang pengembangan tersebut, lalu ambil perubahan jarak jauh untuk menyinkronkan versi lokal cabang tersebut.

Untuk membuat cabang Git baru:

  1. Pastikan Anda telah mengaktifkan Mode Pengembangan.

  2. Buka file project Anda di menu Develop.

  3. Pilih ikon Git di menu ikon sebelah kiri untuk membuka panel Git Actions.

  4. Pilih menu drop-down View Branches.

  5. Pilih New Branch.

  6. Di jendela New Branch, masukkan nama untuk cabang Anda. Perhatikan bahwa ada batasan untuk nama cabang Git. Untuk persyaratan penamaan, lihat Aturan penamaan cabang Git di halaman ini.

  7. Pilih menu drop-down Buat Dari dan pilih cabang yang ada untuk digunakan sebagai titik awal untuk cabang baru Anda.

  8. Pilih Create untuk membuat cabang.

Atau, Anda dapat membuat cabang Git dari tab Branch Management di halaman Project Settings.

Aturan untuk penamaan cabang Git

Looker menggunakan persyaratan konvensi penamaan cabang yang ditentukan oleh Git.

Nama cabang Git tidak boleh:

  • Berisi karakter spasi
  • Berisi titik ganda: ..
  • Berisi garis miring terbalik: \
  • Berisi urutan: @{
  • Berisi tanda tanya: ?
  • Berisi tanda kurung siku buka: [
  • Berisi karakter kontrol ASCII: ~ atau \^ atau :
  • Mulai dengan periode: .
  • Dimulai dengan awalan: dev- (ditujukan untuk cabang pribadi developer Looker)
  • Akhiri dengan garis miring ke depan: /
  • Akhiri dengan ekstensi: .lock

Selain itu, nama cabang hanya dapat berisi tanda bintang (*) jika tanda bintang mewakili seluruh komponen jalur (misalnya, foo/* atau bar/*/baz), dalam hal ini akan ditafsirkan sebagai karakter pengganti dan bukan sebagai bagian dari nama cabang yang sebenarnya.

Beralih ke cabang Git lain

Jika mengalami konflik penggabungan di cabang saat ini, Anda harus menyelesaikan konflik tersebut sebelum dapat beralih ke cabang lain.

Selain itu, jika memiliki perubahan yang belum di-commit di cabang saat ini, Anda tidak dapat beralih ke cabang yang ada hingga Anda melakukan commit perubahan pada cabang saat ini.

Untuk beralih ke cabang Git lain, ikuti langkah-langkah berikut:

  1. Pada project, buka panel Git Actions dengan memilih ikon Git di menu ikon sebelah kiri.
  2. Di panel Git Actions, pilih menu drop-down cabang Git di sebelah kanan nama cabang Git Anda saat ini.
  3. Pilih cabang yang ingin Anda alihkan dengan memilihnya di menu, atau dengan mengetik nama cabang di kotak penelusuran. Penelusuran nama cabang tidak peka huruf besar/kecil. Misalnya, Anda dapat menelusuri "DEV" dan melihat semua cabang dengan nama yang menyertakan "dev", "DEV", "Dev", dan seterusnya.

Mengelola cabang Git

Tab Branch Management di halaman Project Settings menampilkan tabel semua cabang Git untuk project Looker. Untuk membuka tab Branch Management, buka halaman Project Settings terlebih dahulu dengan memilih ikon Settings dari menu ikon di sebelah kiri. Selanjutnya, pilih tab Branch Management.

Di tab Branch Management, Anda dapat:

  1. Buat cabang baru dengan memilih tombol New Branch. Lihat bagian Membuat cabang Git baru di halaman ini untuk informasi selengkapnya.
  2. Telusuri nama cabang di Kotak Penelusuran.
  3. Muat ulang tabel dengan memilih tombol Refresh.
  4. Urutkan tabel dengan memilih nama kolom.

Tabel ini mencakup informasi berikut:

  • Nama: Nama cabang Git. cabang pribadi developer Looker diawali dengan dev- dan menyertakan nama depan dan nama belakang developer.
  • Status: Perbedaan antara versi lokal cabang Anda dan versi jarak jauh cabang tersebut. Misalnya, status 3 commits behind berarti bahwa versi lokal cabang Anda berada di belakang versi jarak jauh cabang dengan tiga commit. Karena Looker selalu menggunakan versi master jarak jauh, tab Branch Management tidak menampilkan status cabang master versi lokal. Cabang utama selalu dapat dianggap terbaru.
  • Terakhir Diperbarui: Lama waktu sejak developer Looker membuat commit pada cabang.
  • Tindakan: Tombol untuk menghapus cabang, atau alasan cabang tidak memenuhi syarat untuk dihapus.

Menghapus cabang Git

Dari tab Branch Management, Anda dapat menghapus cabang yang memiliki tombol Delete di tabel. Anda tidak dapat menghapus cabang berikut:

Dalam tabel, cabang tersebut tidak memiliki tombol Delete. Sebagai gantinya, kolom Action pada tabel menampilkan alasan cabang tersebut tidak dapat dihapus.

Anda tidak dapat memulihkan cabang setelah dihapus. Saat Anda menghapus cabang, Looker akan menghapus versi lokal cabang dan versi jarak jauh cabang tersebut.

Namun, jika cabang tersebut dibuat oleh developer Looker lain, atau jika developer lain telah memeriksa cabang tersebut, developer tersebut masih akan memiliki cabang versi lokalnya. Jika developer Looker membuat commit ke versi lokal cabang mereka dan mendorongnya ke produksi, sekali lagi Anda akan melihat versi cabang jarak jauh. Tindakan ini berguna jika Anda ingin memulihkan cabang. Jika tidak, saat Anda menghapus cabang, semua developer Looker lainnya harus menghapus cabang yang sama untuk memastikan cabang tersebut tidak dapat dimunculkan kembali secara tidak sengaja oleh seseorang yang menekannya ke jarak jauh.

Untuk menghapus satu atau beberapa cabang Git dari project Anda, buka halaman Project Settings terlebih dahulu dengan memilih ikon Settings dari menu ikon di sebelah kiri. Kemudian, pilih tab Branch Management. Di tab Branch Management, Anda dapat menghapus cabang dengan dua cara:

  1. Hapus beberapa cabang dengan terlebih dahulu memilih kotak centang cabang, lalu memilih Delete Selected Branches.
  2. Hapus satu cabang dengan memilih Hapus di samping nama cabang.

Mengeksekusi perintah Git di Looker

Looker memiliki antarmuka bawaan yang terintegrasi dengan layanan Git Anda. Looker menampilkan tombol Git di sudut kanan atas LookML IDE.

Tombol Git menampilkan opsi yang berbeda, bergantung pada posisi Anda dalam proses membuat perubahan dan men-deploy ke produksi. Secara umum, opsi yang ditampilkan di tombol adalah panduan terbaik untuk tindakan Anda selanjutnya.

Jika cabang developer Anda disinkronkan dengan cabang produksi, tombol Git akan menampilkan pesan Up to Date dan tidak dapat dipilih.

Setelah project dikonfigurasi untuk Git, Anda dapat memilih tombol Git Actions untuk membuka panel Git Actions.

Perintah yang tersedia di panel Git Actions bergantung pada posisi Anda dalam proses melakukan perubahan dan men-deploy ke produksi.

Mendapatkan perubahan pada produksi

Dengan integrasi Looker Git default, Looker akan meminta developer melalui alur kerja Git berikut:

Artinya, dengan integrasi Git default, semua developer menggabungkan perubahan mereka ke dalam cabang yang disebut master, dan commit terbaru di cabang master digunakan untuk lingkungan produksi Looker.

Untuk implementasi Git lanjutan, Anda dapat menyesuaikan alur kerja ini:

  • Anda dapat meminta developer mengirimkan permintaan pull untuk cabang produksi Git Anda, bukan mengizinkan developer menggabungkan perubahan mereka melalui Looker IDE. Lihat halaman dokumentasi Mengonfigurasi setelan kontrol versi project untuk mengetahui detailnya.
  • Anda dapat menggunakan kolom Git Production Branch Name untuk menentukan cabang mana dari repositori Git Anda yang harus digunakan Looker sebagai cabang target tempat cabang developer Looker Anda digabungkan. Lihat halaman dokumentasi Mengonfigurasi setelan kontrol versi project untuk mengetahui detailnya.
  • Anda dapat menggunakan mode deploy lanjutan untuk menentukan SHA commit atau nama tag yang berbeda untuk di-deploy ke lingkungan produksi Looker, bukan menggunakan commit terbaru di cabang produksi. (Jika ingin men-deploy commit dari cabang yang berbeda, Anda dapat menggunakan webhook mode deploy lanjutan atau endpoint API.) Lihat halaman dokumentasi Mode deploy lanjutan untuk mengetahui detailnya.

Jika melihat tombol Configure Git dan bukan pilihan yang dijelaskan di bagian ini, Anda harus menyiapkan Git untuk project terlebih dahulu.

Melihat perubahan yang tidak di-commit

LookML IDE memiliki beberapa indikator yang ditampilkan saat Anda berada dalam Mode Pengembangan dan memiliki perubahan yang tidak di-commit, seperti yang dijelaskan di bagian Menandai penambahan, perubahan, dan penghapusan pada halaman dokumentasi Mengedit dan memvalidasi LookML.

Anda bisa mendapatkan ringkasan perbedaan untuk semua file dengan memilih opsi View Uncommitted Changes dari panel Git Actions.

Di jendela Uncommitted Changes to Project, Looker akan menampilkan ringkasan semua perubahan yang tidak di-commit dan tersimpan di semua file project. Untuk setiap perubahan, Looker akan menampilkan hal berikut:

  • Nama file yang diganti dan nama file yang ditambahkan.
    • Nama file yang diganti (ditunjukkan dengan ---) dan nama file yang ditambahkan (ditunjukkan dengan +++). Dalam banyak kasus, nama ini dapat menampilkan berbagai versi file yang sama, dengan revisi yang diidentifikasi oleh --- a/ dan +++ b/.
    • File yang dihapus ditampilkan sebagai menggantikan file null (+++ /dev/null).
    • File yang ditambahkan ditampilkan sebagai menggantikan file null (--- /dev/null).
  • Nomor baris tempat perubahan dimulai.

    Misalnya, -101,4 +101,4 menunjukkan bahwa, di baris ke-101 dalam file, 4 baris dihapus dan 4 baris ditambahkan. File yang dihapus dengan 20 baris akan menampilkan -1,20 +0,0 untuk menunjukkan bahwa, pada baris pertama dalam file, 20 baris telah dihapus dan diganti dengan baris nol.
  • Teks yang diperbarui:
    • Baris yang dihapus ditampilkan dengan warna merah.
    • Baris yang ditambahkan ditampilkan dengan warna hijau.

Agar dapat menampilkan ringkasan perbedaan untuk satu file, pilih opsi Lihat Perubahan dari menu file.

Melakukan perubahan

Setelah membuat dan menyimpan perubahan ke project LookML, IDE mungkin mengharuskan Anda memvalidasi LookML. Tombol Git menampilkan teks Validate LookML dalam skenario ini.

Apakah hal ini diperlukan atau tidak bergantung pada setelan kualitas kode project Anda. Untuk mengetahui informasi selengkapnya tentang Validator Konten, lihat halaman dokumentasi Memvalidasi LookML.

Jika developer lain telah membuat perubahan pada cabang produksi sejak Anda terakhir kali memperbarui cabang lokal, Looker mengharuskan Anda untuk mengambil pembaruan tersebut dari cabang produksi. Tombol Git menampilkan teks Pull from Production dalam skenario ini.

Jika project Anda diaktifkan untuk mode deploy lanjutan, tombol Git akan menampilkan teks Pull from Primary Branch.

Setelah Anda menyimpan perubahan (dan memperbaiki peringatan atau error LookML, jika diperlukan) dan mengambil dari production (jika diperlukan), tombol Git akan menampilkan teks Commit Changes & Push.

Jika diinginkan, Anda dapat meninjau perubahan yang belum di-commit terlebih dahulu sebelum melakukan commit.

Jika Anda sudah siap untuk meng-commit perubahan, gunakan tombol Git untuk meng-commit perubahan ini ke cabang Anda saat ini. Looker menampilkan kotak dialog Commit, yang mencantumkan file yang telah ditambahkan, diubah, atau dihapus.

Masukkan pesan yang menjelaskan perubahan Anda secara singkat, lalu hapus centang pada kotak di samping file apa pun yang tidak ingin disertakan dalam sinkronisasi. Kemudian, pilih Commit untuk melakukan commit perubahan.

Memeriksa PDT yang tidak dibangun

Jika Anda telah membuat perubahan pada PDT dalam project, sebaiknya semua PDT dibangun saat Anda melakukan deployment ke produksi, sehingga tabel dapat langsung digunakan sebagai versi produksi. Untuk memeriksa status PDT dalam project, pilih ikon Project Health untuk membuka panel Project Health, lalu pilih tombol Validate PDT Status.

Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi selengkapnya tentang cara memeriksa PDT yang tidak di-build di project LookML Anda dan cara menggunakan tabel turunan dalam Mode Pengembangan.

Menjalankan pengujian data

Project Anda dapat menyertakan satu atau beberapa parameter test yang menentukan pengujian data untuk memverifikasi logika model LookML Anda. Lihat halaman dokumentasi parameter test untuk mengetahui informasi tentang cara menyiapkan pengujian data di project Anda.

Jika project Anda berisi pengujian data dan Anda berada dalam Mode Pengembangan, Anda dapat memulai pengujian data project dengan beberapa cara:

  1. Jika setelan project dikonfigurasi untuk mewajibkan pengujian data untuk diteruskan sebelum men-deploy file ke produksi, IDE akan menampilkan tombol Jalankan Pengujian setelah Anda melakukan commit perubahan pada project untuk menjalankan semua pengujian bagi project, apa pun file yang menentukan pengujian. Anda harus lulus pengujian data sebelum dapat men-deploy perubahan ke produksi.
  2. Pilih tombol Run Data Tests di panel Project Health. Looker akan menjalankan semua pengujian data di project Anda, apa pun file yang menentukan pengujian.
  3. Pilih opsi Run LookML Tests dari menu file. Looker hanya akan menjalankan pengujian yang ditentukan dalam file saat ini.

Setelah Anda menjalankan pengujian data, panel Project Health akan menampilkan progres dan hasilnya.

  • Pengujian data lulus saat pernyataan pengujian benar untuk setiap baris dalam kueri pengujian. Lihat halaman dokumentasi parameter test untuk mengetahui detail tentang cara menyiapkan kueri dan pernyataan pengujian.
  • Jika pengujian data gagal, panel Project Health akan memberikan informasi tentang alasan pengujian gagal, apakah pengujian menemukan error dalam logika model Anda atau apakah pengujian tersebut tidak valid.
  • Dari hasil pengujian data, Anda dapat memilih nama pengujian data untuk langsung membuka LookML untuk pengujian data, atau Anda dapat memilih tombol Explore Query guna membuka Explore dengan kueri yang ditentukan dalam pengujian data.

Men-deploy ke produksi

Setelah melakukan perubahan pada cabang, Looker IDE akan meminta Anda untuk menggabungkan perubahan ke cabang utama. Jenis perintah yang akan Anda lihat di IDE bergantung pada konfigurasi project Anda:

  • Jika project dikonfigurasi untuk mode deploy lanjutan, IDE akan meminta Anda menggabungkan perubahan ke cabang utama. Setelah menggabungkan commit Anda, developer Looker yang memiliki izin deploy dapat men-deploy commit Anda ke produksi menggunakan pengelola deployment Looker IDE, atau menggunakan webhook atau endpoint API.
  • Jika project Anda dikonfigurasi untuk integrasi Git menggunakan permintaan pull, Anda akan diminta untuk membuka permintaan pull menggunakan antarmuka penyedia Git Anda.
  • Jika tidak, dengan integrasi Git Looker default, jika Anda memiliki izin deploy, Looker IDE akan meminta Anda menggabungkan perubahan ke cabang produksi dan men-deploy perubahan ke versi produksi instance Looker.

Mode deploy lanjutan

Dengan integrasi Looker Git default, developer Looker meng-commit perubahan mereka ke cabang pengembangannya, lalu menggabungkan cabang pengembangan ke cabang produksi. Kemudian, saat Anda men-deploy ke lingkungan Looker, Looker akan menggunakan commit terbaru di cabang produksi. (Lihat bagian Mendapatkan perubahan ke produksi di halaman ini untuk mengetahui alur kerja Git default dan opsi lainnya untuk implementasi Git lanjutan.)

Jika Anda tidak ingin selalu menggunakan commit terbaru di cabang produksi untuk lingkungan Looker, developer dengan izin deploy dapat menggunakan mode deploy lanjutan untuk menentukan commit yang tepat yang akan digunakan untuk lingkungan Looker Anda. Hal ini berguna dalam 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.

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

  • Menggunakan pengelola deployment di Looker IDE
  • Memicu webhook

  • Menggunakan endpoint API

Lihat halaman dokumentasi Mode deploy lanjutan untuk mengetahui detailnya.

Memeriksa dampak perubahan

Setelah membuat perubahan tersedia untuk organisasi, Anda dapat menggunakan validasi konten untuk memastikan bahwa Anda tidak membatalkan dasbor atau menyimpan Look. Anda dapat memperbaikinya jika Anda punya.

Menangani masalah umum

Saat mengerjakan model, Anda mungkin perlu:

  • Abaikan perubahan Anda

    Terkadang Anda mungkin ingin mengabaikan perubahan pemodelan data Anda. Jika belum disimpan, Anda dapat memuat ulang atau keluar dari halaman, lalu menerima perintah peringatan. Jika telah menyimpan perubahan, Anda dapat mengembalikan perubahan yang tidak di-commit seperti yang dijelaskan di bagian Mengembalikan perubahan yang tidak di-commit.

  • Menangani konflik penggabungan dengan pekerjaan developer lain

    Jika ada lebih dari satu developer yang mengerjakan model data Anda, Git biasanya akan menangani situasi ini. Namun, terkadang Git memerlukan manusia untuk mengatasi konflik penggabungan.

Beberapa perubahan, seperti mengubah nama kolom, dapat memengaruhi dasbor dan Look yang ada. Seperti yang disebutkan sebelumnya, setelah membuat perubahan tersedia untuk organisasi, Anda dapat menggunakan validasi konten untuk memeriksa konten dan memperbaiki masalah apa pun.

Mengembalikan perubahan yang tidak di-commit

Saat mengerjakan cabang pengembangan pribadi, Anda dapat mengembalikan perubahan yang belum di-commit yang telah disimpan jika tidak ingin men-deploy-nya. Anda dapat mengembalikan semua perubahan yang belum di-commit untuk semua file dalam project atau hanya perubahan dalam satu file.

Guna mengembalikan perubahan yang tidak di-commit untuk semua file:

  1. Pilih opsi Revert to... di panel Git Actions.
  2. Pilih opsi pengembalian:
    • Untuk mengembalikan perubahan yang tidak di-commit saja, pilih Kembalikan perubahan yang tidak di-commit. Anda juga dapat memilih tautan Lihat perubahan untuk melihat perubahan yang akan dikembalikan.
    • Untuk mengembalikan semua perubahan, termasuk perubahan yang tidak di-commit dan yang di-commit, pilih Kembalikan ke Produksi
  3. Untuk menyelesaikan proses pengembalian, pilih Konfirmasi.

Untuk mengembalikan penambahan atau penghapusan apa pun dalam isi file tunggal, pilih opsi Kembalikan Perubahan dari menu file tersebut:

Saat mengganti nama file, pada dasarnya Anda menghapus file asli dan membuat file baru dengan nama baru. Karena melibatkan lebih dari satu file, Anda tidak dapat menggunakan opsi Kembalikan File untuk mengurungkan penggantian nama file. Jika Anda ingin mengurungkan penggantian nama file, gunakan opsi Revert to... dari panel Git Actions.

Selain itu, jika Anda telah menghapus file, file tersebut tidak lagi ditampilkan di browser file IDE. Jika Anda ingin mengembalikan penghapusan file, gunakan opsi Revert to... dari panel Git Actions.

Menyelesaikan konflik penggabungan

Biasanya, Git dapat otomatis menggabungkan perubahan baru dengan versi produksi file LookML Anda. Konflik penggabungan terjadi saat Git mengalami perubahan yang bertentangan dan tidak dapat mengidentifikasi perubahan mana yang harus disimpan, biasanya ketika developer lain telah melakukan perubahan sejak terakhir Anda menarik dan Anda telah membuat perubahan di area yang sama. Jika terdapat konflik penggabungan dalam kode, Looker akan menampilkan peringatan Konflik penggabungan setelah Anda melakukan perubahan dan mengambil dari produksi.

Saat Looker menampilkan peringatan konflik penggabungan, sebaiknya Anda menyelesaikan konflik penggabungan sebelum melakukan perubahan lebih lanjut. Mengirim konflik penggabungan ke produksi akan menyebabkan error penguraian yang dapat mencegah eksplorasi data Anda. Jika Anda adalah pengguna Git tingkat lanjut dan ingin melanjutkan dengan mendorong perubahan, pilih tombol Don't Resolve.

Dalam file LookML itu sendiri, baris dengan konflik ditandai sebagai berikut:

<<<<<<< HEAD
Your code
&#61;&#61;&#61;&#61;&#61;&#61;&#61;
Production code
>>>>>>> branch 'master'

Looker menampilkan penanda penggabungan berikut untuk menunjukkan konflik penggabungan:

  • <<<<<<< HEAD menandai awal baris yang bertentangan.
  • >>>>>>> branch 'master' menandai akhir baris yang bertentangan.
  • ======= memisahkan setiap versi kode sehingga Anda dapat membandingkannya.

Dalam contoh sebelumnya, your code mewakili perubahan yang Anda lakukan, dan production code mewakili kode tempat Git tidak dapat menggabungkan perubahan secara otomatis.

Untuk mengatasi konflik penggabungan:

  1. Menemukan file dengan konflik penggabungan. Looker akan menandai file ini dengan warna merah, atau Anda juga dapat menelusuri project untuk menemukan penanda penggabungan, seperti <<<< atau HEAD, untuk menemukan semua konflik dalam project. Anda juga dapat menemukan file yang terpengaruh dengan memilih link file di peringatan penggabungan yang muncul di panel Git Actions.
  2. Dalam file, buka baris yang berisi konflik penggabungan dan hapus versi teks yang TIDAK ingin Anda pertahankan, dan hapus juga semua penanda konflik penggabungan.

  3. Simpan file tersebut, dan ulangi langkah-langkah sebelumnya untuk file lain yang ditandai dengan konflik penggabungan.

  4. Setelah Anda menyelesaikan semua konflik penggabungan dan menghapus semua penanda penggabungan dari project, commit perubahan dan deploy perubahan tersebut ke produksi.

Setelah Anda menyelesaikan konflik penggabungan dan meneruskan resolusi ke tahap produksi, developer lain dapat mengambil dari produksi dan melanjutkan pekerjaan seperti biasa.

Pembersihan sampah memori Git

Pembersihan sampah memori Git membersihkan file yang tidak perlu dan mengompresi revisi file untuk mengoptimalkan repositori Git Anda. Pembersihan sampah memori Git (git gc) dijalankan secara otomatis saat instance Looker Anda diupdate atau dimulai ulang. Agar git gc tidak terlalu sering dijalankan, Looker harus menunggu 30 hari sejak git gc terakhir, lalu menjalankan git gc saat mulai ulang berikutnya.

Dalam kasus yang jarang terjadi, Anda dapat mencoba Mendorong Perubahan ke Jarak Jauh atau Mendorong Cabang ke Jarak Jauh saat git gc berjalan. Jika Looker menampilkan error, tunggu satu atau dua menit, lalu coba lagi untuk menerapkan perubahan.