Mengelola cabang di ruang kerja Microsoft Fabric
Tujuan dari artikel ini adalah untuk menyajikan pengembang Fabric dengan opsi yang berbeda untuk membangun proses CI/CD di Fabric, berdasarkan skenario pelanggan umum. Artikel ini lebih berfokus pada bagian integrasi berkelanjutan (CI) dari proses CI/CD. Untuk diskusi tentang bagian pengiriman berkelanjutan (CD), lihat mengelola alur penyebaran.
Artikel ini menguraikan beberapa opsi integrasi yang berbeda, tetapi banyak organisasi menggunakan kombinasinya.
Prasyarat
Untuk mengintegrasikan Git dengan ruang kerja Microsoft Fabric, Anda perlu menyiapkan prasyarat berikut untuk Fabric dan Git.
Prasyarat Fabric
Untuk mengakses fitur integrasi Git, Anda memerlukan salah satu hal berikut:
- Lisensi Power BI Premium. Lisensi premium Power BI hanya mendukung semua item Power BI.
- Kapasitas fabric. Kapasitas Fabric diperlukan untuk menggunakan semua item Fabric yang didukung. Jika Anda belum memilikinya, daftar untuk uji coba gratis.
Selain itu, sakelar penyewa berikut harus diaktifkan dari portal Admin:
- Pengguna dapat membuat item Fabric
- Pengguna dapat menyinkronkan item ruang kerja dengan repositori Git mereka
- Hanya untuk pengguna GitHub: Pengguna dapat menyinkronkan item ruang kerja dengan repositori GitHub
Sakelar ini dapat diaktifkan oleh admin penyewa, admin kapasitas, atau admin ruang kerja, tergantung 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:
- Akun Azure aktif yang terdaftar untuk pengguna yang sama yang menggunakan ruang kerja Fabric. Buat akun gratis.
- Akses ke repositori yang ada.
Proses pengembangan
Ruang kerja Fabric adalah lingkungan bersama yang mengakses item langsung. Setiap perubahan yang dilakukan langsung di ruang kerja mengambil alih dan memengaruhi semua pengguna ruang kerja lainnya. Oleh karena itu, praktik terbaik Git adalah agar pengembang bekerja dalam isolasi di luar ruang kerja bersama. Ada dua cara bagi pengembang untuk bekerja di ruang kerja mereka sendiri yang dilindungi.
- Kembangkan menggunakan alat klien, seperti Power BI Desktop untuk laporan dan model semantik, atau Visual Studio Code for Notebooks.
- Kembangkan di ruang kerja Fabric terpisah. Setiap pengembang memiliki ruang kerja mereka sendiri di mana mereka menghubungkan cabang terpisah mereka sendiri, menyinkronkan konten ke ruang kerja tersebut, lalu berkomitmen kembali ke cabang.
Untuk bekerja dengan cabang menggunakan integrasi Git, pertama-tama sambungkan ruang kerja tim pengembangan bersama ke satu cabang bersama. Misalnya, jika tim Anda menggunakan satu ruang kerja bersama, sambungkan ke cabang utama di repositori tim Anda, dan sinkronkan antara ruang kerja dan repositori. Jika alur kerja tim Anda memiliki beberapa cabang bersama seperti cabang Dev/Test/Prod , setiap cabang dapat dihubungkan ke ruang kerja yang berbeda.
Kemudian, setiap pengembang dapat memilih lingkungan yang terisolasi untuk bekerja.
Skenario 1 - Mengembangkan menggunakan alat klien
Jika item yang Anda kembangkan tersedia di alat lain, Anda dapat mengerjakan item tersebut langsung di alat klien. Tidak semua item tersedia di setiap alat. Item yang hanya tersedia di Fabric perlu dikembangkan di Fabric.
Alur kerja untuk pengembang yang menggunakan alat klien seperti Power BI Desktop akan terlihat seperti ini:
Kloning repositori ke komputer lokal. (Anda hanya perlu melakukan langkah ini sekali.)
Buka proyek di Power BI Desktop menggunakan salinan lokal PBIProj.
Buat perubahan dan simpan file yang diperbarui secara lokal. Terapkan ke repositori lokal.
Setelah siap, dorong cabang dan terapkan ke repositori jarak jauh.
Uji perubahan terhadap item lain atau lebih data dengan menghubungkan cabang baru ke ruang kerja terpisah, dan mengunggah model semantik dan laporan menggunakan tombol perbarui semua di panel kontrol sumber. Lakukan pengujian atau perubahan konfigurasi di sana sebelum menggabungkan ke cabang utama .
Jika tidak ada pengujian yang diperlukan di ruang kerja, pengembang dapat menggabungkan perubahan langsung ke cabang utama , tanpa perlu ruang kerja lain.
Setelah perubahan digabungkan, ruang kerja tim bersama diminta untuk menerima penerapan baru. Perubahan diperbarui ke ruang kerja bersama dan semua orang dapat melihat perubahan pada model dan laporan semantik tersebut.
Untuk panduan khusus tentang cara menggunakan format file Power BI Desktop baru di git, lihat Format kode sumber.
Skenario 2 - Mengembangkan menggunakan ruang kerja lain
Untuk pengembang yang bekerja di web, alurnya adalah sebagai berikut:
Dari tab Cabang dari menu Kontrol sumber, pilih Keluar cabang ke ruang kerja baru.
Tentukan nama cabang dan ruang kerja. Cabang baru yang dibuat berdasarkan cabang yang tersambung ke ruang kerja saat ini.
Pilih Cabang keluar.
Fabric membuat ruang kerja dan cabang baru. Anda secara otomatis dibawa ke ruang kerja baru.
Ruang kerja disinkronkan dengan cabang fitur Anda, dan menjadi lingkungan terisolasi untuk bekerja, seperti yang diilustrasikan. Anda sekarang dapat bekerja di lingkungan baru yang terisolasi ini. Sinkronisasi mungkin memakan waktu beberapa menit. Lihat tips pemecahan masalah untuk informasi selengkapnya tentang percabangan.
Simpan perubahan Anda dan terapkan ke cabang fitur.
Setelah siap, buat PR ke cabang utama . Proses peninjauan dan penggabungan dilakukan melalui Azure Repos berdasarkan konfigurasi yang ditentukan tim Anda untuk repositori tersebut.
Setelah peninjauan dan penggabungan selesai, penerapan baru dibuat ke cabang utama . Penerapan ini meminta pengguna untuk memperbarui konten di ruang kerja tim Dev dengan perubahan yang digabungkan.
Lihat batasan percabangan untuk informasi selengkapnya.
Proses rilis
Proses rilis dimulai setelah pembaruan baru menyelesaikan proses Permintaan Pull dan bergabung ke cabang bersama tim (seperti Utama, Dev, dll.). Dari titik ini, kita akan menguraikan berbagai opsi untuk membangun proses rilis di Fabric. Anda dapat menemukan berbagai pertimbangan untuk proses rilis dalam mengelola alur penyebaran.
Beralih cabang
Jika ruang kerja Anda tersambung ke cabang Git dan Anda ingin beralih ke cabang lain, Anda dapat melakukannya dengan cepat dari panel Kontrol sumber tanpa memutuskan sambungan dan menyambungkan kembali.
Saat Anda beralih cabang, ruang kerja disinkronkan dengan cabang baru dan semua item di ruang kerja ditimpa. Jika ada versi yang berbeda dari item yang sama di setiap cabang, item akan diganti. Jika item berada di cabang lama, tetapi bukan yang baru, item akan dihapus.
Untuk beralih antar cabang, ikuti langkah-langkah berikut:
Dari tab Cabang dari menu Kontrol sumber, pilih Beralih cabang.
Tentukan cabang yang ingin Anda sambungkan atau buat cabang baru. Cabang ini harus berisi direktori yang sama dengan cabang saat ini.
Pilih Beralih cabang.
Anda tidak dapat beralih cabang jika Anda memiliki perubahan yang tidak dikomit di ruang kerja. Pilih Batal untuk kembali dan terapkan perubahan Anda sebelum beralih cabang.
Untuk menyambungkan ruang kerja saat ini ke cabang baru sambil mempertahankan status ruang kerja yang ada, pilih Periksa cabang baru. Pelajari selengkapnya tentang memeriksa cabang baru di Mengatasi konflik di Git.