Menyiapkan dan menguji koneksi Git

Saat Anda membuat project baru, project tersebut hanya ada dalam Mode Pengembangan untuk memungkinkan Anda mengembangkan model dalam lingkungan yang aman dan tidak akan memengaruhi pengguna lain. Setelah Anda siap memublikasikan project, langkah berikutnya adalah mengonfigurasi koneksi Git.

Dengan mengonfigurasi koneksi Git untuk project, Anda dapat men-deploy LookML ke Mode Produksi, yang memungkinkan pengguna lain menjelajahi model data Anda, membuat dasbor, dan menambahkan LookML ke model Anda. Untuk penyiapan yang lebih cepat, gunakan repositori kosong. Untuk integrasi Git yang lebih andal, buat repositori Git Anda sendiri dan ikuti petunjuk di halaman ini untuk menghubungkannya ke instance Looker Anda.

Catatan: Saat Anda membuat project baru selama proses pembuatan model, project akan dibuat dengan repositori kosong.

Mengintegrasikan Looker dengan Git

Looker menggunakan Git untuk mencatat perubahan dan mengelola versi file. Setiap project LookML sesuai dengan repositori Git. Setiap kali pengguna berada dalam Mode Pengembangan, pengguna tersebut berada di cabang Git-nya sendiri.

Untuk pengelolaan file sumber LookML, Looker dapat dikonfigurasi dengan penyedia Git apa pun yang menggunakan kunci SSH atau HTTPS untuk autentikasi. Langkah-langkah umumnya sama, apa pun platform yang Anda gunakan. Halaman ini menggunakan GitHub sebagai contoh untuk menghubungkan project Looker ke Git setelah Anda membuat repositori Git.

Untuk mengakses opsi integrasi Git, Anda harus mengaktifkan Mode Pengembangan.

Anda dapat mengonfigurasi integrasi Git menggunakan salah satu protokol berikut:

• HTTPS: HyperText Transfer Protocol Secure. Dengan HTTPS, Looker mengakses repositori Git Anda dengan nama pengguna dan sandi (atau token akses) yang Anda berikan, seperti yang dijelaskan dalam Menghubungkan ke Git Menggunakan HTTPS.
• SSH: Secure Shell. Dengan SSH, Looker mengakses repositori Git Anda menggunakan kunci deployment yang Anda buat melalui situs penyedia Git, seperti yang dijelaskan dalam Menghubungkan ke Git Menggunakan SSH.

Menghubungkan ke Git menggunakan HTTPS

Untuk project LookML yang dikonfigurasi dengan autentikasi HTTPS, Looker terhubung ke penyedia Git Anda dengan satu atau beberapa akun pengguna yang Anda siapkan dengan penyedia Git. Looker menggunakan nama pengguna dan sandi (atau token akses) untuk login ke penyedia Git Anda dan melakukan operasi Git atas nama developer LookML Anda.

Jika akun Git Anda menggunakan autentikasi 2 langkah, Anda dapat membuka penyedia Git dan membuat token akses untuk digunakan, bukan sandi. Buka postingan Komunitas Menyiapkan koneksi git HTTPS dengan 2FA Aktif untuk melihat petunjuk membuat token akses pribadi bagi penyedia Git umum.

Dengan autentikasi HTTPS, Anda dapat mengonfigurasi project LookML untuk menggunakan satu akun Git untuk seluruh project, atau Anda dapat mengonfigurasi project untuk menggunakan akun Git individual developer untuk menjalankan operasi Git mereka.

Perhatikan hal-hal berikut untuk autentikasi HTTPS GitHub:

• GitHub tidak menerima sandi akun untuk mengautentikasi operasi Git di github.com. Lihat postingan blog GitHub untuk mengetahui informasi selengkapnya. Untuk menghubungkan project Looker ke GitHub menggunakan HTTPS, gunakan setelan developer di GitHub untuk membuat token akses pribadi.
• Looker tidak mendukung token akses pribadi terperinci GitHub. Untuk menghubungkan project Looker ke GitHub menggunakan HTTPS, gunakan opsi Token (klasik) GitHub saat Anda membuat token akses pribadi.

Autentikasi HTTPS akun tunggal

Jika Anda menyiapkan project LookML dengan satu akun Git, Looker akan menggunakan akun Git tersebut untuk login ke penyedia Git Anda guna melakukan perubahan atas nama developer. Looker membuat commit ini menggunakan nama pengguna Looker developer sehingga Anda dapat mengetahui developer mana yang membuat setiap commit. Anda dapat melihat histori commit project di antarmuka penyedia Git atau dengan memilih opsi History dari menu Git di Looker IDE. Lihat Menjalankan perintah Git di Looker untuk mengetahui informasi selengkapnya tentang menu Git di Looker.

Untuk autentikasi HTTPS akun tunggal, akun pengguna Git yang Anda tentukan harus memiliki akses baca dan tulis ke repositori Git Anda. Developer LookML Anda sendiri tidak perlu memiliki akun pengguna Git mereka sendiri.

Autentikasi HTTPS beberapa akun dengan atribut pengguna

Jika Anda menyiapkan project LookML dengan beberapa akun, project LookML akan menggunakan akun Git masing-masing developer Looker untuk melakukan operasi Git. Anda juga perlu mengonfigurasi satu akun pengguna Git generik, dengan setidaknya akses baca, yang akan digunakan Looker untuk mengambil versi produksi file.

Tugas dan persyaratan berikut diperlukan untuk autentikasi Git dengan atribut pengguna:

• Setiap developer LookML harus memiliki akun penggunanya sendiri dengan penyedia Git Anda. Setiap akun pengguna Git harus memiliki akses baca dan tulis ke repositori project.
• Admin Looker Anda harus menyiapkan akun pengguna Looker dengan atribut pengguna yang sesuai dengan nama pengguna Git dan sandi Git (atau token akses jika akun pengguna Git memiliki autentikasi 2 langkah).
• Atribut pengguna untuk sandi akun Git (atau token akses) harus disembunyikan. Saat Anda membuat atribut sandi atau token akses, pilih Ya di bagian opsi Sembunyikan Nilai dan masukkan URL penyedia Git di kolom Daftar yang Diizinkan Domain.
• Atribut pengguna untuk nama dan sandi Git (atau token akses) harus diisi untuk setiap developer Looker. Atribut pengguna dapat dikonfigurasi oleh admin Looker atau oleh pengguna Looker.

Contoh berikut menunjukkan halaman Admin User Attributes, tempat admin Looker telah menyiapkan atribut pengguna untuk nama pengguna Git dan token akses pengguna.

Contoh berikut menunjukkan halaman Akun pengguna Looker tempat pengguna telah memasukkan kredensial Git-nya ke kolom atribut pengguna.

Mengonfigurasi autentikasi Git HTTPS

Untuk mengonfigurasi project LookML dengan autentikasi Git HTTPS, ikuti langkah-langkah berikut:

1. Dapatkan URL HTTPS untuk repositori Git Anda. Untuk GitHub, untuk repositori baru (repositori yang belum berisi file apa pun), GitHub akan menampilkan URL sebagai bagian dari penyiapan awal. Pastikan untuk memilih tombol HTTPS di tab Code agar Anda mendapatkan URL HTTPS, lalu pilih ikon Copy URL to clipboard untuk menyalinnya ke papan klip.

   

   Untuk repositori GitHub yang ada (repositori yang sudah berisi file), Anda dapat melihat URL HTTPS dengan membuka tab Code repositori dan memilih tombol Code. Pastikan untuk memilih link HTTPS. Anda dapat memilih ikon Salin URL ke papan klip untuk menyalin URL HTTPS ke papan klip.

   

2. Buka project LookML Anda, lalu pilih ikon Setelan dari menu navigasi.

3. Di halaman Project Configuration, pada tab Configuration, buka tombol Configure Git (untuk project baru) atau tombol Reset Git Connection (untuk project yang ada yang telah terhubung ke Git sebelumnya).

4. Pilih tombol Configure Git atau Reset Git Connection untuk membuka halaman Configure Git.

   Mereset koneksi Git akan mempertahankan histori Git untuk cabang utama. Tindakan ini juga akan mempertahankan histori cabang pribadi setiap developer Looker setelah mereka menarik, menggabungkan, dan men-deploy. Untuk mempertahankan histori untuk semua cabang, lihat halaman Praktik Terbaik Bermigrasi ke repositori Git baru.

   

5. Di halaman Configure Git Looker, tempel URL HTTPS untuk repositori Git Anda di kolom Repository URL, lalu pilih Continue.

   Looker akan mendeteksi penyedia Git Anda dan memperbarui jendela dengan informasi tentang repositori Git Anda.

   Jika Looker tidak berhasil mendeteksi penyedia Git Anda, Looker akan meminta Anda untuk memilih dari menu drop-down.

6. Pilih opsi login Git Anda:

   • Gunakan satu kombinasi nama pengguna dan sandi/token yang konstan (lihat Autentikasi HTTPS akun tunggal).
   • Menggunakan atribut pengguna untuk nama pengguna dan sandi/token (lihat Autentikasi HTTPS atribut pengguna).

7. Di kolom Username dan Password/Personal Access Token, masukkan kredensial yang akan digunakan project LookML Anda untuk mengakses Git. Hal ini diperlukan terlepas dari setelan login Git Anda:

   • Jika Anda memilih Gunakan satu kombinasi nama pengguna dan sandi/token akses pribadi yang konstan, ini adalah nama pengguna dan sandi Git (atau token akses) yang akan digunakan instance Looker Anda untuk semua operasi Git. Akun pengguna Git ini harus memiliki akses baca dan tulis ke repositori Git Anda.
   • Jika Anda memilih Gunakan atribut pengguna untuk nama pengguna dan sandi/token akses pribadi, ini adalah nama pengguna dan sandi Git (atau token akses) yang akan digunakan instance Looker Anda untuk mengambil versi produksi repositori. Akun pengguna Git ini harus memiliki setidaknya akses baca ke repositori Git Anda.

   Jika akun Git Anda menggunakan autentikasi 2 langkah, atau jika Anda menggunakan GitHub (yang memerlukan token akses pribadi, bukan sandi), Anda dapat membuka penyedia Git dan membuat token akses untuk digunakan, bukan sandi. Buka postingan Komunitas Menyiapkan koneksi git HTTPS dengan 2FA Aktif untuk melihat petunjuk membuat token akses pribadi untuk penyedia Git umum.

8. Jika Anda memilih Gunakan atribut pengguna untuk nama pengguna dan sandi/token akses pribadi, Looker akan menampilkan menu drop-down Atribut Pengguna Nama Pengguna dan Atribut Pengguna Token Akses Pribadi di bagian Kredensial Mode Pengembangan. Gunakan menu drop-down untuk memilih atribut pengguna untuk kredensial Git setiap developer.

   

   (Pengguna Looker dapat mengedit nilai untuk kolom atribut pengguna di halaman Akun, atau admin Looker dapat mengedit nilai atribut pengguna untuk pengguna di halaman admin Pengguna.)

9. Pilih tombol Lanjutkan Penyiapan.

Git kini dikonfigurasi untuk project LookML Anda. Dari sini, Anda dapat memvalidasi LookML, lalu membuat commit awal dan men-deploy ke produksi untuk membuat project tersedia dalam Mode Produksi. Anda juga dapat:

• Gunakan menu Git untuk mengakses perintah Git.
• Gunakan menu Git untuk menguji koneksi Git Anda.
• Jika Anda adalah admin Looker, buka setelan project untuk mewajibkan validasi LookML dan mengonfigurasi opsi integrasi Git.

Menghubungkan ke Git menggunakan SSH

Dengan autentikasi SSH, Anda membuat kunci deployment untuk penyedia Git. Looker membuat pasangan kunci SSH dan menampilkan kunci publik di UI, seperti yang terlihat pada langkah 4. Looker menggunakan kunci deployment tersebut untuk login ke penyedia Git Anda guna melakukan perubahan atas nama developer Looker. Looker membuat commit menggunakan nama pengguna Looker developer sehingga Anda dapat mengetahui developer mana yang membuat setiap commit. Anda dapat melihat histori commit project di antarmuka penyedia Git atau dengan memilih opsi History dari menu Git di Looker IDE. Lihat Menjalankan perintah Git di Looker untuk mengetahui informasi selengkapnya tentang menu Git di Looker.

Untuk mengonfigurasi project LookML dengan autentikasi SSH Git, ikuti langkah-langkah berikut:

1. Buka project Anda atau buat project LookML baru.
2. Di project Anda, pilih ikon Setelan dari menu ikon sebelah kiri untuk membuka halaman Project Configuration.

3. Di halaman Project Configuration, lakukan salah satu tindakan berikut untuk membuka halaman Configure Git:

   • Untuk project tanpa koneksi Git, pilih tombol Configure Git.
   • Untuk project yang sudah dikonfigurasi dengan koneksi Git, pilih tombol Reset Git Connection.

   Mereset koneksi Git akan mempertahankan histori Git untuk cabang utama. Tindakan ini juga akan mempertahankan histori cabang pribadi setiap developer Looker setelah mereka menarik, menggabungkan, dan men-deploy. Untuk mempertahankan histori untuk semua cabang, lihat halaman Praktik Terbaik Bermigrasi ke repositori Git baru.

   

4. Dapatkan URL SSH untuk repositori Git Anda. Berikut adalah format untuk penyedia Git umum:

   • GitHub: [e-mail]:<organization-name>/<repository-name>.git
   • GitHub Enterprise: [e-mail]:<organization-name>/<repository-name>.git
   • Cloud Source Repositories: ssh://[e-mail]@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
   • GitLab: [e-mail]:<organization-name>/<repository-name>.git
   • Bitbucket: [e-mail]:<organization-name>/<repository-name>.git
   • Phabricator: ssh://[e-mail]/diffusion/MYCALLSIGN/<repository-name>.git

   Untuk GitHub, untuk repositori baru (repositori yang belum berisi file apa pun), GitHub akan menampilkan URL SSH di tab Code sebagai bagian dari penyiapan awal. Pastikan untuk memilih tombol SSH agar Anda mendapatkan URL SSH, lalu pilih ikon papan klip untuk menyalinnya ke papan klip.

   

   Untuk repositori GitHub yang ada (repositori yang sudah berisi file), Anda dapat melihat URL SSH dengan membuka tab Code repositori dan memilih tombol Code. Pastikan untuk memilih link Gunakan SSH. Anda dapat memilih ikon papan klip untuk menyalin ke papan klip.

   

5. Di halaman Configure Git Looker, tempel URL SSH untuk repositori Git Anda di kolom Repository URL, lalu pilih Continue.

   URL dengan port Git kustom atau non-standar dapat digunakan dengan Looker dengan menambahkan nomor port non-standar ke URL Git. Contoh: ssh://[e-mail]:22/myorganization/myproject.git

   Anda harus menyertakan ssh:// agar berfungsi dengan benar.

6. Looker akan mendeteksi penyedia Git Anda dan menampilkan kunci deployment untuk repositori Anda. (Jika Looker tidak berhasil mendeteksi penyedia Git Anda, Looker akan meminta Anda untuk memilih dari menu drop-down.) Salin kunci deploy ke papan klip, lalu pilih link Setelan Kunci Deploy untuk repositori Anda untuk membuka halaman Kunci deploy GitHub untuk repositori GitHub Anda.

7. Di tab Setelan GitHub, di halaman Kunci deploy, pilih tombol Tambahkan kunci deploy:

   

   GitHub akan menampilkan halaman Deploy keys / Add new.

8. Tambahkan judul untuk kunci deployment. Namanya tidak penting, tetapi Anda dapat menyertakan "Looker" dan judul project untuk melacaknya di masa mendatang.

9. Tempel kunci deployment yang Anda salin dari Looker .

10. Pilih opsi Izinkan akses tulis.

    Catatan: Ini adalah langkah penting, karena Looker memerlukan setelan ini untuk membuat dan men-deploy perubahan pada model LookML Anda.

11. Pilih tombol Tambahkan kunci. (Pada tahap ini, penyedia Git Anda mungkin meminta Anda untuk memasukkan sandi. Jika ya, masukkan sandi Anda, lalu pilih Konfirmasi sandi.)

12. GitHub akan menampilkan semua kunci deployment yang telah ditambahkan untuk repositori Anda.

13. Kembali ke jendela Looker, dan di halaman Configure Git, pilih Test and Finalize Setup.

Dari sini, Anda dapat mencoba lagi untuk menyiapkan kunci deployment, atau Anda dapat memilih Lewati Pengujian dan Selesaikan Penyiapan untuk mempertahankan setelan saat ini.

Git kini dikonfigurasi untuk project LookML Anda. Dari sini, Anda dapat memvalidasi LookML, lalu membuat commit awal dan men-deploy ke produksi untuk membuat project tersedia dalam Mode Produksi. Anda juga dapat:

• Gunakan menu Git untuk mengakses perintah Git.
• Gunakan menu Git untuk menguji koneksi Git Anda.
• Jika Anda adalah admin Looker, buka setelan project untuk mewajibkan validasi LookML dan mengonfigurasi opsi integrasi Git.

Mengonfigurasi repositori Git biasa

Jika belum membuat repositori Git jarak jauh, atau jika hanya ingin menyiapkannya dengan cepat agar orang lain dapat memanfaatkan LookML Anda, Anda dapat mengonfigurasi repositori Git biasa. Mengonfigurasi repositori Git bare akan membuat repositori Git lokal di instance Looker, bukan terhubung ke repositori jarak jauh.

Saat Anda memilih opsi untuk membuat repositori kosong, Looker akan membuat repositori di server Looker dan memulai histori Git untuk repositori tersebut.

Saat Anda membuat project baru selama proses membuat model, project akan otomatis dikonfigurasi dengan repositori kosong.

Peringatan: Jangan gunakan opsi repositori kosong jika Anda ingin menghubungkan project LookML ke repositori Git yang memiliki histori Git. Jika Anda melakukannya, Looker tidak akan dapat merekonsiliasi dua histori Git dan Anda tidak akan dapat melakukan tindakan Git apa pun.

Untuk mengonfigurasi project LookML dengan repositori Git biasa:

1. Buka project Anda atau buat project LookML baru.
2. Di project Anda, pilih ikon Setelan dari menu ikon sebelah kiri untuk membuka halaman Project Configuration.

3. Di halaman Project Configuration, lakukan salah satu tindakan berikut untuk membuka halaman Configure Git:

   • Untuk project tanpa koneksi Git, pilih tombol Configure Git.
   • Untuk project yang sudah dikonfigurasi dengan koneksi Git, pilih tombol Reset Git Connection.

   Mereset koneksi Git akan mempertahankan histori Git untuk cabang utama. Tindakan ini juga akan mempertahankan histori cabang pribadi setiap developer Looker setelah mereka menarik dan menggabungkan, lalu men-deploy. Untuk mempertahankan histori untuk semua cabang, lihat halaman Praktik Terbaik Bermigrasi ke repositori Git baru.

4. Pilih Siapkan repositori kosong di bagian bawah halaman Konfigurasi Git.

   

5. Pada dialog Configure Bare Git Repository, pilih Create Repository.

   Setelah repositori Git dibuat, Looker akan menampilkan dialog Bare Repository Created.

Git kini dikonfigurasi untuk project LookML Anda. Dari sini, Anda dapat memvalidasi LookML, lalu membuat commit awal dan men-deploy ke produksi untuk membuat project tersedia dalam Mode Produksi. Anda juga dapat:

• Gunakan menu Git untuk mengakses perintah Git.
• Gunakan menu Git untuk menguji koneksi Git Anda.
• Jika Anda adalah admin Looker, buka setelan project untuk mewajibkan validasi LookML dan mengonfigurasi opsi integrasi Git.

Untuk project yang dikonfigurasi dengan repositori bare, Anda kemudian dapat menggunakan Reset Git Connection jika ingin menghubungkan project ke penyedia Git (lihat prosedur untuk menggunakan HTTPS atau SSH). Namun, jangan terhubung ke repositori Git yang sudah memiliki histori Git. Jika Anda telah menyiapkan project LookML dengan repositori kosong, Looker akan membuat repositori di server Looker dan memulai histori Git untuk repositori tersebut. Jika kemudian Anda menghubungkan project LookML ke repositori Git yang memiliki histori Git, Looker tidak akan dapat merekonsiliasi kedua histori Git dan Anda tidak akan dapat melakukan tindakan Git apa pun.

Menghubungkan project LookML baru ke repositori Git yang tidak kosong

Mengonfigurasi Git untuk kontrol versi adalah langkah utama dalam membuat project LookML baru. Biasanya, setiap project harus memiliki repositorinya sendiri. Namun, Anda mungkin perlu mengonfigurasi project dengan repositori Git yang berisi LookML yang ada, seperti dalam situasi berikut:

• Saat Anda memindahkan project LookML yang ada antar-instance
• Saat Anda menghidupkan kembali kode dari project LookML yang rusak atau tidak berfungsi untuk digunakan dalam project baru

Peringatan: Jangan gunakan prosedur ini jika Anda telah mengonfigurasi project dengan repositori kosong. Jika Anda telah menyiapkan project LookML dengan repositori kosong, Looker akan membuat repositori di server Looker dan memulai histori Git untuk repositori tersebut. Jika kemudian Anda menghubungkan project LookML ke repositori Git yang memiliki histori Git, Looker tidak akan dapat merekonsiliasi kedua histori Git tersebut dan Anda tidak akan dapat melakukan tindakan Git apa pun.

Bagian ini menjelaskan praktik terbaik untuk mengonfigurasi project LookML baru dengan repositori Git yang ada dan tidak kosong untuk pengembangan LookML lebih lanjut.

Catatan: Alur kerja ini hanya untuk repositori yang akses tulisnya Anda miliki.

1. Buat project LookML baru dengan memilih Blank Project sebagai titik awal. Project kosong adalah titik awal karena akan diisi dengan objek LookML dari repositori yang ada, bukan dari skema database atau kueri SQL.
2. Konfigurasikan Git untuk project Anda menggunakan HTTPS atau SSH, menggunakan URL untuk project yang tidak kosong di bagian Repository URL di halaman Configure Git.
3. Setelah mengonfigurasi Git untuk project, pull dari produksi dari panel Git Actions.
4. Setelah mengambil dari produksi, pilih Deploy to Production.

Perubahan yang Anda buat pada LookML di project tidak akan memengaruhi repositori asli; perubahan tersebut akan disimpan di repositori versi lokal Anda.

Jika Anda ingin menggunakan repositori publik tertentu sebagai dasar project LookML kosong, tetapi tidak memiliki akses tulis ke repositori tersebut, ikuti petunjuk yang diuraikan di bagian Meng-clone repositori Git publik di halaman dokumentasi Membuat project LookML baru.

Jika Anda menyiapkan alur kerja Git menggunakan satu repositori di beberapa instance, lihat postingan Komunitas tentang Alur kerja Git menggunakan satu repositori di beberapa instance — pengembangan, staging, dan produksi untuk mengetahui informasi selengkapnya.

Menguji koneksi Git

Looker menyediakan pengujian koneksi Git untuk memverifikasi koneksi Git Anda. Pengujian koneksi Git memverifikasi bahwa Anda telah menyiapkan URL Git yang benar dan host Git dapat dijangkau oleh Looker . Pengujian koneksi Git juga memverifikasi bahwa Anda telah memberikan kunci deployment Git yang valid dan kunci deployment tersebut memiliki akses tulis ke repositori Git Anda.

Jika Looker tidak dapat terhubung ke repositori Git Anda, tombol Git akan menampilkan teks Uji Koneksi Git untuk meminta Anda memecahkan masalah koneksi.

Anda juga dapat mengakses alat pengujian koneksi Git dengan memilih Test Git Connection di panel Git actions:

Alat pengujian koneksi Git kemudian akan menampilkan langkah-langkah yang dilakukan untuk menguji koneksi Git:

1. Memeriksa remote git
2. Nama host untuk layanan git akan di-resolve
3. Jaringan ke layanan git beroperasi
4. Memverifikasi kredensial otorisasi
5. Memastikan kredensial mengizinkan akses tulis

Jika langkah berhasil, Looker akan menampilkan tanda centang hijau di sebelah kiri langkah. Jika langkah tidak berhasil, Looker akan menampilkan tanda centang merah di sebelah kiri langkah dan juga menampilkan pesan error.

Contoh berikut menunjukkan pengujian yang berhasil:

Dalam contoh berikut, repositori Git tidak memiliki kunci deployment yang dikonfigurasi untuk koneksi Looker. Tanda centang hijau di sebelah kiri tiga langkah pertama menunjukkan bahwa langkah-langkah ini berhasil:

• Examine git remote
• Host name for git service will resolve
• Networking to the git service is operational

Tanda centang merah di sebelah kiri dua langkah terakhir menunjukkan bahwa langkah-langkah ini gagal:

• Verify authorization credentials
• Ensure credentials allow write access