Mendiagnosis dan memperbaiki masalah Git dalam project LookML

Project Looker mengandalkan konfigurasi Git yang stabil (seperti koneksi repositori jarak jauh, kunci deployment yang valid, struktur repositori yang utuh, dan izin sistem file yang benar). Saat masalah Git terjadi, developer dan administrator dapat menggunakan alat Diagnostik & Perbaikan untuk menguji kesehatan repositori, mengidentifikasi penyebab utama, dan menjalankan perbaikan otomatis.

Alat Diagnostik & Perbaikan mengevaluasi repositori project LookML Anda di delapan pemeriksaan pengujian diagnostik di lingkungan pengembangan pribadi atau lingkungan produksi bersama. Jika masalah ditemukan, Looker dapat secara otomatis melakukan perbaikan yang tepat (seperti menghapus file lock yang tidak aktif, memperbaiki izin file, atau memperbaiki indeks objek yang rusak) atau membangun ulang repositori yang rusak sambil mengamankan perubahan yang belum di-commit di cabang pemulihan khusus.

Prasyarat dan izin

Untuk menggunakan alat Diagnostik & Perbaikan Git, Anda harus memenuhi persyaratan izin berikut:

• Lingkungan developer: Memerlukan izin develop untuk setidaknya satu model dalam project.
• Lingkungan produksi: Memerlukan izin deploy untuk setidaknya satu model dalam project.

Menjalankan diagnosis Git

Untuk mendiagnosis project LookML, ikuti langkah-langkah berikut:

1. Aktifkan Mode Pengembangan.
2. Di panel navigasi, pilih Develop untuk membuka panel Develop.
3. Di panel Develop, pilih Projects untuk menampilkan halaman LookML Projects.
4. Buka project yang ingin Anda diagnosis.
5. Pilih ikon Setelan dari menu ikon Looker IDE.
6. Di bagian Git Diagnose and Repair, klik Diagnose & Repair.

7. Dalam dialog Diagnostik & Perbaikan, pilih lingkungan yang ingin Anda uji:

   

   • Pengembangan: Menguji salinan repositori Git developer pribadi Anda.
   • Produksi: Menguji salinan produksi repositori Git.

8. Klik Diagnostik.

Looker memulai suite pengujian diagnostik dan menampilkan progres langsung untuk setiap pemeriksaan pengujian dalam dialog.

Memahami hasil diagnostik

Saat suite pengujian diagnostik berjalan, setiap pemeriksaan akan melaporkan salah satu status berikut:

Badge Status	Arti	Tindakan Diperlukan
Tidak Terdeteksi	Pemeriksaan diagnostik berhasil dan tidak ada masalah yang ditemukan.	Tindakan tidak diperlukan.
Terdeteksi	Masalah atau inkonsistensi teridentifikasi di repositori atau koneksi.	Jalankan perbaikan otomatis jika tersedia, atau ikuti langkah-langkah penyelesaian manual.
Diperbaiki	Masalah berhasil diselesaikan oleh proses perbaikan otomatis.	Anda tidak perlu melakukan tindakan lebih lanjut.
Gagal	Upaya perbaikan otomatis tidak dapat menyelesaikan masalah, atau pemeriksaan memerlukan intervensi manual.	Tinjau detail masalah dan ikuti prosedur perbaikan manual.

Menjalankan perbaikan otomatis

Jika ada pemeriksaan diagnostik yang menampilkan status Terdeteksi dan mendukung perbaikan otomatis, Anda dapat memulai perbaikan langsung dari dialog:

1. Pada dialog Diagnose & Repair, klik tombol Start Repair.
2. Looker menerapkan perbaikan otomatis untuk semua masalah yang dapat diperbaiki.
3. Setelah proses perbaikan selesai, badge status akan diperbarui menjadi Diperbaiki untuk pemeriksaan yang diselesaikan, atau Gagal jika intervensi manual diperlukan.

Referensi pemeriksaan dan perbaikan diagnostik

Suite pengujian diagnostik mengevaluasi delapan kategori masalah Git. Tabel berikut menjelaskan setiap pemeriksaan, diagnosisnya, dan tindakan perbaikan yang dilakukan:

Pemeriksaan Diagnostik	Deskripsi	Jenis Reparasi	Tindakan Perbaikan
Penyiapan Git	Memverifikasi bahwa project memiliki prasyarat yang diperlukan untuk menginisialisasi repositorinya (URL origin Git jarak jauh yang dikonfigurasi dan catatan konfigurasi database yang aktif).	Manual	Jika nilai yang diperlukan tidak ada, selesaikan konfigurasi Git awal di setelan project (Settings > Configuration > Configure Git). Untuk mengetahui informasi selengkapnya, lihat bagian Menyelesaikan masalah penyiapan Git.
Uji Koneksi Git	Menjalankan suite pengujian koneksi Git standar Looker terhadap repositori asal jarak jauh, memverifikasi kredensial, Keterjangkauan Jaringan, dan izin akses jarak jauh.	Manual	Kegagalan koneksi disebabkan oleh faktor eksternal (seperti kunci deployment SSH yang sudah habis masa berlakunya, token akses pribadi atau OAuth yang dicabut, batasan firewall, atau gangguan penyedia). Selesaikan masalah kredensial atau jaringan secara langsung dengan penyedia Git Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Menyelesaikan masalah pengujian koneksi Git.
Akses Sistem File	Mendeteksi error I/O sistem file atau penyimpanan yang mencegah Looker membaca listingan direktori atau nama file di repositori project.	Otomatis	Membangun ulang salinan bersih repositori project dari awal. Mengarsipkan direktori lama ke cadangan yang aman dan menyimpan pekerjaan yang belum di-commit ke cabang pemulihan jarak jauh.
Status Fungsional Repositori	Memeriksa apakah struktur .git internal ada dan utuh, serta memverifikasi bahwa Git mengenali direktori sebagai pohon kerja yang berfungsi.	Otomatis	Membangun ulang repositori project dari awal, memulihkan struktur direktori Git yang berfungsi dengan baik sekaligus mengarsipkan konten sebelumnya untuk mencegah kehilangan data.
Mengunci File Git	Memindai file .lock yang tidak aktif (seperti kunci indeks atau konfigurasi) yang tertinggal akibat operasi Git yang terganggu atau dihentikan yang memblokir perintah Git berikutnya.	Otomatis	Menghapus file lock yang tidak aktif dengan aman secara langsung, sehingga tidak memblokir operasi Git tanpa mengubah histori repositori atau file kerja.
Izin Objek	Memindai file dan direktori project untuk menemukan izin sistem file yang menyimpang dari standar keamanan dan operasional yang direkomendasikan (misalnya, memastikan bahwa direktori dan skrip memiliki akses baca dan eksekusi, sementara file standar tetap tidak dapat dieksekusi).	Otomatis	Secara otomatis menormalisasi izin file dan direktori di seluruh project, memulihkan izin akses standar yang aman tanpa mengubah konten file.
Setelan Konfigurasi Git	Memeriksa apakah konfigurasi Git internal repositori cocok dengan default yang diperlukan Looker (khususnya memverifikasi bahwa pelacakan mode file core.filemode dinonaktifkan sehingga perbedaan izin di seluruh sistem file tidak menghasilkan perubahan palsu).	Otomatis	Memperbarui konfigurasi repositori agar sesuai dengan default Looker dan menyimpan konfigurasi yang diperbarui.
FSCK Konsistensi Repositori	Menjalankan pemeriksaan sistem file Git (git fsck) untuk memeriksa database objek internal repositori terkait kerusakan struktural (termasuk file indeks yang rusak, tanda tangan commit yang buruk, pointer objek yang tidak valid, objek yang rusak, atau referensi yang rusak).	Otomatis	Perbaikan awal: Membangun ulang indeks, memangkas log referensi yang sudah tidak berlaku, menghapus referensi yang rusak, dan menjalankan git fetch --refetch untuk mengambil objek yang hilang. Pembangunan ulang penggantian: Jika perbaikan awal tidak dapat menyelesaikan semua error, bangun ulang repositori dengan aman dan pertahankan pekerjaan yang belum di-commit di cabang pemulihan jarak jauh.

Menyelesaikan masalah Git manual

Jika pemeriksaan Penyiapan Git atau Uji Koneksi Git mendeteksi masalah, perbaikan otomatis tidak tersedia karena masalah berasal dari luar repositori lokal. Ikuti panduan berikut untuk menyelesaikan masalah manual:

• Menyelesaikan masalah penyiapan Git:

  1. Buka project Anda di Looker IDE.
  2. Pilih ikon Setelan dari menu ikon.
  3. Di tab Configuration, pilih Reset Git Connection atau Configure Git untuk menyelesaikan penyiapan repositori. Untuk mengetahui petunjuk mendetail, lihat Menyiapkan dan menguji koneksi Git.

• Mengatasi masalah uji koneksi Git:

  • Kunci deployment SSH: Verifikasi bahwa kunci deployment di Looker cocok dengan kunci publik yang terdaftar di penyedia hosting Git Anda, dan pastikan kunci tersebut memiliki akses tulis yang diaktifkan. Jika perlu, buat kunci deployment baru di setelan project dan perbarui penyedia Git Anda.
  • Kredensial HTTPS dan token akses pribadi: Periksa apakah token akses pribadi atau sandi akun layanan Anda telah habis masa berlakunya atau dicabut. Buat token baru di penyedia Git Anda dan perbarui kredensial Anda di Looker.
  • Daftar yang diizinkan IP dan firewall: Pastikan penyedia hosting Git Anda mengizinkan traffic masuk dari alamat IP instance Looker Anda.