Menyiapkan dan menguji koneksi Git

Saat Anda membuat project baru, project tersebut hanya ada dalam Mode Pengembangan sehingga Anda dapat mengembangkan model di lingkungan aman yang tidak akan memengaruhi pengguna lain. Setelah 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, membangun dasbor, dan menambahkan LookML ke model Anda. Untuk penyiapan yang lebih cepat, gunakan repositori kosong. Untuk integrasi Git yang lebih tangguh, buat repositori Git Anda sendiri dan ikuti petunjuk di halaman ini untuk menghubungkannya ke instance Looker Anda.

Mengintegrasikan Looker dengan Git

Looker menggunakan Git untuk merekam perubahan dan mengelola versi file. Setiap project LookML sesuai dengan repositori Git, dan setiap kali pengguna berada dalam Mode Pengembangan, pengguna tersebut berada di cabang Git mereka sendiri. Repositori Git sering disebut repos.

Untuk pengelolaan file sumber LookML, Looker dapat dikonfigurasi dengan penyedia Git apa pun yang menggunakan kunci SSH atau HTTPS untuk autentikasi. Langkah-langkah umumnya tetap 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 dapat mengakses repositori Git Anda dengan nama pengguna dan sandi (atau token akses) yang Anda berikan, seperti yang dijelaskan dalam Menghubungkan ke Git Menggunakan HTTPS di bawah.
  • SSH: Secure Shell. Dengan SSH, Looker dapat mengakses repositori Git Anda menggunakan kunci deploy yang Anda buat melalui situs penyedia Git Anda, seperti yang dijelaskan dalam artikel Terhubung ke Git Menggunakan SSH di bawah.

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 Anda. 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 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 Enabled untuk melihat petunjuk cara membuat token akses pribadi bagi penyedia Git yang umum.

Dengan autentikasi HTTPS, Anda dapat mengonfigurasi project LookML agar menggunakan satu akun Git untuk seluruh project, atau Anda dapat mengonfigurasi project agar 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 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 yang mendetail milik 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 meng-commit 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 Anda di antarmuka penyedia Git atau dengan memilih opsi History dari menu Git Looker IDE. Lihat Mengeksekusi 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 sendiri.

Autentikasi HTTPS beberapa akun dengan atribut pengguna

Jika Anda menyiapkan project LookML dengan beberapa akun, project LookML Anda akan menggunakan setiap akun Git individual developer Looker untuk menjalankan operasi Git. Anda juga perlu mengonfigurasi satu akun pengguna Git umum, dengan setidaknya akses baca, yang akan digunakan Looker untuk mengambil file versi produksi.

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

  • Setiap developer LookML Anda harus memiliki akun pengguna mereka 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 token akses atau sandi, pilih Yes di bagian opsi Hide Values dan masukkan URL penyedia Git di kolom Domain Allowlist.
  • 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 menampilkan halaman Admin Atribut Pengguna, tempat admin Looker telah menyiapkan atribut pengguna untuk nama pengguna Git dan token akses pengguna.

Tabel di halaman Admin Atribut Pengguna yang menampilkan atribut pengguna jenis string github_token dan github_username.

Contoh berikut menampilkan halaman Account pengguna Looker tempat pengguna telah memasukkan kredensial Git 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. Dalam hal GitHub, untuk repositori baru (repositori yang belum berisi file apa pun), GitHub akan menampilkan URL tersebut kepada Anda sebagai bagian dari penyiapan awal. Pastikan untuk memilih tombol HTTPS pada tab Code sehingga Anda mendapatkan URL HTTPS, lalu pilih tombol salin 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 papan klip untuk menyalin URL HTTPS ke papan klip.

  2. Buka project LookML Anda, pilih ikon Settings dari menu navigasi, lalu buka halaman Configure Git dengan memilih tombol Configure Git (untuk project baru) atau tombol Reset Git Connection (untuk project yang sudah ada dan telah terhubung dengan Git sebelumnya).

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

  3. Di bagian 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.

  4. Pilih opsi login Git Anda:

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

    • Jika Anda memilih Gunakan kombinasi nama pengguna dan sandi/token akses pribadi tunggal 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 Use user attributes for username and password/personal access token, ini adalah nama pengguna dan sandi Git (atau token akses) yang akan digunakan instance Looker Anda untuk mengambil repositori versi produksi. Akun pengguna Git ini harus memiliki setidaknya akses baca ke repositori Git Anda.

    Jika akun Git 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 Enabled untuk melihat petunjuk cara membuat token akses pribadi bagi penyedia Git yang umum.

  6. Jika Anda memilih Use user attributes for username and password/personal access token, Looker akan menampilkan menu drop-down Username User Attribute dan Personal Access Token User Attribute di bagian Development Mode Credentials. Gunakan menu drop-down untuk memilih atribut pengguna untuk kredensial Git developer individu.

    (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.)

  7. Pilih tombol Lanjutkan Penyiapan.

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

Menghubungkan ke Git menggunakan SSH

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

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

  1. Buka project Anda lalu pilih Configuration di panel setelan project untuk melihat konfigurasi project. Selanjutnya, buka halaman Configure Git dengan melakukan salah satu tindakan berikut:

    • Untuk project baru, pilih tombol Configure Git di bagian konfigurasi project.
    • Untuk mengubah penyiapan Git bagi project yang ada, pilih Reset Git Connection di bagian konfigurasi project.

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

    Diagram yang menunjukkan progres dari halaman Project Settings ke halaman Configure Git. Project baru akan menampilkan tombol Configure Git, dan project yang ada akan menampilkan tombol Reset Git Connect, tetapi kedua tombol tersebut mengarah ke halaman Configure Git.

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

    • GitHub: git@github.com:<organization-name>/<repository-name>.git
    • GitHub Enterprise: git@example.com:<organization-name>/<repository-name>.git
    • Cloud Source Repositories: ssh://username@example.com@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
    • GitLab: git@gitlab.com:<organization-name>/<repository-name>.git
    • Bitbucket: git@bitbucket.org:<organization-name>/<repository-name>.git
    • Dokter: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Dalam kasus 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 sehingga 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 disalin ke papan klip.

  3. Di bagian 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://git@corporate.git.server.com:22/myorganization/myproject.git

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

  4. Looker akan mendeteksi penyedia Git Anda dan menampilkan kunci deploy untuk repo Anda. (Jika Looker tidak berhasil mendeteksi penyedia Git, Anda akan diminta untuk memilih dari menu drop-down.) Salin kunci deploy ke papan klip, lalu pilih link Deploy Key settings for your repository untuk membuka halaman Deploy keys GitHub untuk repositori GitHub Anda.

  5. Di tab Settings GitHub, di halaman Deploy keys, pilih tombol Add deploy key:

    GitHub menampilkan halaman Deploy keys / Add new.

  6. Tambahkan judul untuk kunci deploy. Nama ini tidak penting, tetapi Anda dapat menyertakan "Looker" dan judul project Anda agar dapat melacaknya di masa mendatang.

  7. Tempel kunci deploy yang Anda salin dari Looker.

  8. Pilih opsi Izinkan akses tulis.

  9. Pilih tombol Add key. (Pada tahap ini, penyedia Git mungkin akan meminta Anda untuk memasukkan sandi. Jika demikian, masukkan sandi Anda, lalu pilih Konfirmasi sandi.)

  10. GitHub akan menampilkan semua kunci deploy yang telah ditambahkan untuk repositori Anda.

  11. Kembali ke jendela Looker, lalu pilih Test and Finalize Setup di bagian Configure Git.

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

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

Mengonfigurasi repositori Git bare

Jika Anda belum membuat repositori Git jarak jauh, atau hanya ingin melakukan penyiapan dengan cepat agar orang lain dapat memanfaatkan LookML Anda, Anda dapat mengonfigurasi repositori Git secara sederhana. Mengonfigurasi repositori Git bare akan membuat repositori Git lokal pada instance Looker Anda, bukan terhubung ke repositori jarak jauh.

Untuk mengonfigurasi project LookML dengan repositori Git biasa:

  1. Buka project Anda lalu pilih Configuration di panel setelan project untuk melihat konfigurasi project. Selanjutnya, lakukan salah satu tindakan berikut:

    • Untuk project baru, pilih tombol Configure Git di bagian konfigurasi project.
    • Untuk mengubah penyiapan Git bagi project yang ada, pilih Reset Git Connection di bagian konfigurasi project.

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

  2. Pilih Set up a bare repository pengganti di bagian bawah kotak dialog Configure Git, yang terletak di atas tombol Continue.

  3. Di kotak dialog Configure Bare Git Repository, pilih Create Repository.

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

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

Menghubungkan project LookML baru ke repositori Git yang tidak kosong

Mengonfigurasi Git untuk kontrol versi adalah langkah penting dalam membuat project LookML yang baru. Biasanya, setiap project harus memiliki repositori 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 sudah ada antar-instance
  • Saat Anda mengaktifkan kembali kode dari project LookML yang rusak atau tidak berfungsi untuk digunakan dalam project baru

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

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 Repositori URL pada bagian Konfigurasi Git.
  3. Setelah mengonfigurasi Git untuk project Anda, ambil dari produksi dari panel Git Actions.
  4. Setelah Anda mengambil dari production, pilih Deploy to Production.

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

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

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

Menguji koneksi Git Anda

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

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

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

Alat uji koneksi Git kemudian menampilkan langkah-langkah yang diperlukan untuk menguji koneksi Git:

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

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

Contoh berikut menunjukkan pengujian yang berhasil:

Kotak dialog Git Connection Test yang menampilkan daftar langkah dengan tanda centang hijau di sampingnya untuk menunjukkan bahwa semua langkah berhasil.

Pada contoh berikut, repositori Git tidak memiliki kunci deploy 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 tersebut gagal:

  • Verify authorization credentials
  • Ensure credentials allow write access

Kotak dialog Git Connection Test yang menampilkan daftar langkah yang berhasil dan gagal. Error pada langkah Verifikasi kredensial otorisasi bertuliskan Tidak dapat AUTH ke jarak jauh (kunci deploy Looker).