Mulailah dengan integrasi Git

Artikel ini memandu Anda melalui tugas dasar berikut di alat integrasi Git Microsoft Fabric:

• Menyambungkan ke repositori Git
• Menerapkan perubahan
• Pembaruan dari Git
• Putuskan sambungan dari Git

Sebaiknya baca ringkasan integrasi Git sebelum Anda mulai.

Prasyarat

Untuk mengintegrasikan Git dengan ruang kerja Microsoft Fabric, Anda perlu menyiapkan prasyarat berikut untuk Fabric dan Git.

Prasyarat Kain

Untuk mengakses fitur integrasi Git, Anda memerlukan kapasitas Fabric. Kapasitas Fabric diperlukan untuk menggunakan semua elemen Fabric yang didukung. Jika Anda belum memilikinya, daftar untuk uji coba gratis. Pelanggan yang sudah memiliki kapasitas Premium Power BI, dapat menggunakan kapasitas tersebut, tetapi perlu diingat bahwa pastikan SKU Power BI hanya mendukung item Power BI.

Selain itu, sakelar berikut untuk penyewa harus diaktifkan dari portal Admin:

• Pengguna dapat membuat item Fabric - diperlukan jika menggunakan artefak Fabric
• Pengguna dapat menyinkronkan item ruang kerja dengan repositori Git mereka
• Buat ruang kerja (hanya jika Anda ingin bercabang ke ruang kerja baru.)
• Pengguna dapat menyinkronkan item ruang kerja dengan repositori GitHub: Hanya untuk pengguna GitHub

Fitur ini dapat diaktifkan oleh admin tenant, admin kapabilitas, atau admin ruang kerja, bergantung pada pengaturan organisasi Anda.

Prasyarat Git

Integrasi Git saat ini didukung untuk Azure DevOps dan GitHub. Untuk menggunakan integrasi Git dengan ruang kerja Fabric, Anda memerlukan hal berikut di Azure DevOps atau GitHub:

Azure DevOps

• Akun Active Azure DevOps terdaftar untuk pengguna Fabric yang sama (didukung bahkan jika organisasi Azure DevOps berada di penyewa yang berbeda dari penyewa Fabric). Buat akun gratis.
• Access ke repositori yang ada.

GitHub

• Akun GitHub aktif. Buat akun GitHub.

• Satutoken akses pribadi berikut:

  • Token fine-grained (disarankan) dengan izin baca dan tulis Contents di bawah izin repositori:

    

    Untuk menggunakan token ini dengan GitHub Enterprise, ikuti petunjuk arah .

  • Buat token klasik GitHub dengan cakupan repositori diaktifkan:

    

Menyambungkan ruang kerja ke repositori Git

Menyambungkan ke repositori Git

Hanya admin ruang kerja yang dapat menyambungkan ruang kerja ke repositori, tetapi setelah tersambung, siapa pun yang memiliki izin dapat bekerja di ruang kerja. Jika Anda bukan admin, mintalah bantuan admin untuk menyambungkan. Untuk menyambungkan ruang kerja ke repositori Azure atau GitHub, ikuti langkah-langkah berikut:

1. Masuk ke Fabric dan navigasi ke ruang kerja yang ingin Anda sambungkan.

2. Masuk ke pengaturan Ruang Kerja

   

3. Pilih Integrasi Git.

4. Pilih penyedia Git Anda. Saat ini, Azure DevOps dan GitHub didukung.

Azure DevOps Connect

Jika Anda memilih Azure DevOps, pilih Connect untuk masuk secara otomatis ke akun Azure Repos yang terdaftar ke pengguna Microsoft Entra yang masuk ke Fabric.

Jika Anda telah masuk ke Azure dari Fabric menggunakan akun lain, pilih akun Anda dari daftar dan pilih Connect.

Jika ini pertama kalinya Anda masuk dari Fabric, atau Anda ingin menambahkan akun baru, pilih Tambahkan akun.

Jika ini pertama kalinya terhubung, Anda perlu Mengotorisasi pengguna Anda. Berikan informasi berikut:

• Nama tampilan - harus unik untuk setiap pengguna
• URL Azure DevOps - URL repositori Azure DevOps. URL harus dalam format https://dev.azure.com/{organization}/{project}/_git/{repository} atau https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Autentikasi - Anda dapat mengautentikasi baik dengan OAuth2 atau Perwakilan Layanan. Untuk informasi selengkapnya, lihat Azure DevOps - Integrasi Git dengan perwakilan layanan

Setelah masuk, pilih Connect untuk mengizinkan Fabric access akun Anda

GitHub Connect

Jika Anda memilih GitHub, Anda harus masuk ke akun GitHub Anda. Jika Anda telah masuk ke GitHub, pilih akun Anda dari daftar dan pilih Connect.

Jika ini pertama kalinya Anda masuk dari Fabric, atau Anda ingin menambahkan akun baru, pilih Tambahkan akun.

Jika ini pertama kalinya terhubung, Anda perlu Mengizinkan pengguna GitHub Anda. Berikan informasi berikut:

• nama Display - harus unik untuk setiap pengguna GitHub
• Token akses pribadi - token akses pribadi klasik atau terperinci
• URL Repository (opsional untuk github.com, wajib untuk ghe.com) - Jika Anda tidak memasukkan URL, Anda dapat tersambung ke repo github.com apa pun yang Anda miliki aksesnya. Jika Anda memasukkan URL, Anda hanya dapat tersambung ke repositori ini.

Setelah masuk, pilih Connect untuk memungkinkan Fabric access akun GitHub Anda.

Sambungkan ke ruang kerja

Jika ruang kerja sudah tersambung ke Azure DevOps/GitHub, ikuti instruksi untuk Koneksi ke ruang kerja bersama.

Menghubungkan cabang Azure DevOps

1. Dari menu dropdown, tentukan detail berikut tentang cabang yang ingin Anda sambungkan:

   • Organization
   • Project
   • repositori Git.
   • Cabang (Pilih cabang yang ada menggunakan menu drop-down, atau pilih + Cabang Baru untuk membuat cabang baru. Anda hanya dapat tersambung ke satu cabang pada satu waktu.)
   • Folder (Ketik nama folder yang sudah ada atau masukkan nama untuk membuat folder baru. Jika Anda membiarkan nama folder kosong, konten dibuat di folder akar. Anda hanya bisa tersambung ke satu folder pada satu waktu.)

Koneksi cabang GitHub

1. Dari menu dropdown, tentukan detail berikut tentang cabang yang ingin Anda sambungkan:

   • URL Repository. Jika Anda tersambung ke GitHub menggunakan token tercakup, URL akan diisi secara otomatis dan Anda hanya dapat tersambung ke repositori tersebut.
   • Cabang (Pilih cabang yang ada menggunakan menu drop-down, atau pilih + Cabang Baru untuk membuat cabang baru. Anda hanya dapat tersambung ke satu cabang pada satu waktu.)
   • Folder (Ketik nama folder yang sudah ada atau masukkan nama untuk membuat folder baru. Jika Anda membiarkan nama folder kosong, konten dibuat di folder akar. Anda hanya bisa tersambung ke satu folder pada satu waktu.)

Pilih Sambungkan dan sinkronkan.

Selama sinkronisasi awal, jika ruang kerja atau cabang Git kosong, konten disalin dari lokasi yang tidak kosong ke yang kosong. Jika ruang kerja dan cabang Git memiliki konten, Anda akan ditanya ke arah mana sinkronisasi harus pergi. Untuk informasi selengkapnya tentang sinkronisasi awal ini, lihat Menyambungkan dan menyinkronkan.

Setelah Anda tersambung, Ruang Kerja menampilkan informasi tentang kontrol sumber yang memungkinkan pengguna melihat cabang yang tersambung, status setiap item di cabang dan waktu sinkronisasi terakhir.

Untuk menjaga ruang kerja Anda tetap sinkron dengan cabang Git, lakukan perubahan apa pun yang Anda buat di ruang kerja ke cabang Git, dan perbarui ruang kerja Anda setiap kali ada yang membuat penerapan baru ke cabang Git.

Menerapkan perubahan pada git

Setelah Anda berhasil tersambung ke folder Git, edit ruang kerja Anda seperti biasa. Perubahan apa pun yang Anda simpan hanya disimpan di ruang kerja. Setelah siap, Anda dapat menerapkan perubahan ke cabang Git, atau Anda dapat membatalkan perubahan dan kembali ke status sebelumnya.

Baca selengkapnya tentang komit.

Penerapan ke Git

Untuk menerapkan perubahan Anda ke cabang Git, ikuti langkah-langkah berikut:

1. Pergi ke ruang kerja.

2. Pilih ikon Source control. Ikon ini memperlihatkan jumlah perubahan yang tidak dilakukan.

3. Pilih Perubahan dari panel Sumber Kontrol. Daftar muncul dengan semua item yang Anda ubah, dan ikon yang menunjukkan apakah item baru , dimodifikasi , konflik , perubahan yang sama, atau dihapus .

4. Pilih item yang ingin Anda komitkan. Untuk memilih semua item, centang kotak atas.

5. Tambahkan komentar dalam kotak. Jika Anda tidak menambahkan komentar, pesan default ditambahkan secara otomatis.

6. Pilih Terapkan.

   

Setelah perubahan di-komit, item yang di-komit dihapus dari daftar, dan ruang kerja mengarah ke commit baru yang telah disinkronisasi.

Setelah penerapan berhasil diselesaikan, status item terpilih berubah dari Tidak Dikomit ke Disinkronkan.

Berkomitmen untuk cabang mandiri

Berkomitmen untuk cabang mandiri adalah fitur integrasi Git yang memungkinkan Anda membuat cabang baru dan menerapkan perubahan Anda saat ini dalam satu tindakan. Dengan kata lain, alih-alih melakukan commit ke cabang yang terhubung, Anda dapat bercabang secara langsung: sistem akan membuat cabang Git baru dan menyimpan pekerjaan Anda di sana tanpa perlu meninggalkan atau beralih dari cabang asli.

1. Pergi ke ruang kerja.
2. Pilih ikon Source control. Ikon ini memperlihatkan jumlah perubahan yang tidak dilakukan.
3. Pilih Perubahan dari panel Sumber Kontrol. Daftar muncul dengan semua item yang Anda ubah, dan ikon yang menunjukkan apakah item baru , dimodifikasi , konflik , perubahan yang sama, atau dihapus .
4. Pilih item yang ingin Anda komitkan. Untuk memilih semua item, centang kotak atas.
5. Tambahkan komentar dalam kotak. Jika Anda tidak menambahkan komentar, pesan default ditambahkan secara otomatis.
6. Pilih Terapkan ke cabang baru.

Penting

Perhatikan hal-hal berikut:

• cabang yang baru dibuat tidak akan tersambung ke ruang kerja yang ada.
• cabang yang baru dibuat akan didasarkan pada status sinkronisasi terakhir ruang kerja saat ini.
• fungsionalitas ini dapat dilakukan ketika ada pembaruan masuk (bahkan jika komitmen default dinonaktifkan).
• status ruang kerja saat ini tidak akan diubah karena penerapan ini dan tetap apa adanya.

Urungkan perubahan tersimpan

Setelah menyimpan perubahan ke ruang kerja, jika Anda memutuskan bahwa Anda tidak ingin menerapkan perubahan tersebut ke git, Anda dapat membatalkan perubahan dan mengembalikan item tersebut ke status sebelumnya. Untuk membatalkan perubahan Anda, ikuti langkah-langkah berikut:

1. Pergi ke ruang kerja.

2. Pilih tombol Kontrol sumber. Tombol ini juga menunjukkan jumlah perubahan yang tidak dilakukan.

3. Pilih Perubahan dari panel Kontrol sumber. Daftar muncul dengan semua item yang Anda ubah, dan ikon yang menunjukkan apakah item yang diubah baru , dimodifikasi , konflik , atau dihapus .

4. Pilih perubahan yang ingin Anda batalkan.

5. Tempatkan centang di kotak Saya memahami bahwa item ruang kerja mungkin dihapus dan tidak dapat dipulihkan dan pilih Batalkan.

   

6. Pilih Batalkan lagi untuk mengonfirmasi. Dialog yang Anda lihat mungkin bervariasi tergantung pada apakah item yang akan dihapus terdeteksi atau tidak. Cuplikan layar pertama tidak ada penghapusan apapun. Yang kedua, jika penghapusan terdeteksi.

   

   

Item-item yang dipilih di ruang kerja Anda akan kembali ke kondisi semula ketika ruang kerja terakhir kali disinkronkan.

Penting

Jika Anda menghapus item lalu membatalkan perubahan, item dibuat baru dan beberapa metadata mungkin hilang. Misalnya, label sensitivitas tidak dipertahankan dan harus disetel ulang, dan pemilik item diubah menjadi pengguna saat ini.

Membatalkan item yang ditambahkan akan menghapus item secara permanen.

Memperbarui ruang kerja dari Git

Setiap kali ada yang melakukan perubahan baru ke cabang Git yang terhubung, pemberitahuan akan muncul di ruang kerja yang relevan. Gunakan panel kontrol sumber untuk menarik perubahan terbaru, menggabungkan, atau kembali ke ruang kerja dan memperbarui item terbaru. Perubahan pada folder juga sudah diperbarui. Baca selengkapnya tentang memperbarui.

Untuk memperbarui ruang kerja, ikuti langkah-langkah berikut:

1. Pergi ke ruang kerja.
2. Pilih ikon Source control.
3. Pilih Updates dari control panel Sumber. Daftar muncul dengan semua item yang diubah di cabang sejak pembaruan terakhir.
4. Pilih Perbarui semua.

5. Pada dialog konfirmasi, pilih Perbarui.

Setelah berhasil diperbarui, daftar item dihapus, dan ruang kerja menunjuk ke ruang kerja baru yang disinkronkan.

Setelah pembaruan berhasil diselesaikan, status item berubah menjadi Disinkronkan.

Memutus sambungan ruang kerja dari Git

Hanya admin ruang kerja yang dapat memutuskan sambungan ruang kerja dari Git Repo. Jika Anda bukan admin, mintalah bantuan admin untuk memutuskan sambungan. Jika Anda adalah admin dan ingin memutuskan sambungan repositori Anda, ikuti langkah-langkah berikut:

1. Masuk ke pengaturan Ruang Kerja
2. Pilih integrasi Git
3. Pilih Putus koneksi ruang kerja
4. Pilih Putuskan sambungan lagi untuk mengonfirmasi.

Perizinan

Tindakan yang dapat Anda ambil di ruang kerja bergantung pada izin yang Anda miliki di ruang kerja dan repositori Git. Untuk diskusi izin yang lebih rinci, lihat Izin.

Konten terkait

• Memahami proses integrasi Git
• Mengelola cabang Git
• Praktik terbaik integrasi Git