Bagikan melalui


Alur build Proyek Power BI (PBIP) dan Azure DevOps untuk validasi

Menggabungkan Fabric Git Integration dengan Azure DevOps, memungkinkan Anda menyambungkan ruang kerja ke cabang di repositori Azure DevOps dan secara otomatis menyinkronkan di antara mereka.

Mengintegrasikan format PBIP dengan Azure DevOps memungkinkan Anda menggunakan Azure Pipelines untuk mengotomatiskan alur Integrasi Berkelanjutan/Penyebaran Berkelanjutan (CI/CD). Alur ini memproses file metadata PBIP dan menerapkan serangkaian pemeriksaan kualitas ke pengembangan Anda sebelum menyebarkannya ke sistem produksi.

Dalam artikel ini, kami berfokus pada integrasi berkelanjutan dan menjelaskan cara membuat alur Azure DevOps yang menjamin praktik terbaik untuk semua model dan laporan semantik dalam ruang kerja Fabric. Dengan menerapkan pengujian kualitas otomatis, Anda dapat mencegah kesalahan umum, dan meningkatkan efisiensi tim. Misalnya, pendekatan ini memastikan bahwa anggota tim baru mematuhi standar yang ditetapkan untuk model semantik dan pengembangan laporan.

Pelajari selengkapnya tentang Integrasi PBIP dan Fabric Git dalam gambaran umum proyek dan gambaran umum integrasi Fabric Git.

Diagram berikut mengilustrasikan skenario end-to-end dengan dua alur kerja pengembangan yang memicu alur Azure DevOps untuk memvalidasi kualitas pengembangan. Eksekusi alur melakukan tindakan berikut:

Diagram memperlihatkan alur kerja DevOps.

  1. Pengguna 1 mengembangkan menggunakan Power BI Desktop.

    1. Membuat cabang dari utama menggunakan Visual Studio Code (fitur/datasetchange)
    2. Membuat perubahan pada model semantik menggunakan Power BI Desktop
    3. Menerapkan perubahan pada cabang repositori jarak jauh menggunakan Visual Studio Code
    4. Membuat Permintaan Pull ke cabang utama menggunakan Azure DevOps
  2. Pada saat yang sama, Pengguna 2 mengembangkan menggunakan ruang kerja Fabric lain.

    1. Membuat cabang dari utama menggunakan Fabric Git (feature/reportchange)
    2. Membuat perubahan laporan di ruang kerja Fabric
    3. Menerapkan perubahan pada cabang repositori jarak jauh menggunakan Fabric Git
    4. Membuat Permintaan Pull ke cabang utama menggunakan Azure DevOps
  3. Pemimpin tim meninjau Permintaan Pull dan menyinkronkan perubahan pada ruang kerja tim menggunakan Fabric Git.

  4. Permintaan Pull memicu alur Azure DevOps untuk memeriksa model semantik dan melaporkan kualitas pengembangan.

Catatan

Dalam contoh ini, alur menggunakan dua alat komunitas sumber terbuka yang memungkinkan pengembang menerapkan aturan praktik terbaik (dapat disesuaikan) ke metadata model semantik dan laporan dalam folder Proyek Power BI:

Pendekatan yang mirip dengan contoh dalam artikel ini akan berlaku untuk alat komunitas lainnya. Artikel ini tidak mempelajari secara spesifik alat komunitas, atau pembuatan dan pengeditan aturan. Untuk informasi mendalam tentang topik-topik ini, lihat tautan yang disediakan. Fokus artikel ini adalah pada proses membangun gerbang kualitas antara kontrol sumber dan Ruang Kerja Fabric. Penting untuk dicatat bahwa alat komunitas yang dirujuk dikembangkan oleh kontributor pihak ketiga, dan Microsoft tidak menawarkan dukungan atau dokumentasi untuk mereka.

Langkah 1 - Menyambungkan ruang kerja Fabric ke Azure DevOps

Sambungkan ruang kerja Fabric Anda ke Azure DevOps:

Cuplikan layar memperlihatkan koneksi Git ke DevOps.

Saat integrasi Fabric Git selesai mengekspor item ruang kerja Anda, cabang Azure DevOps Anda berisi folder untuk setiap item di ruang kerja Anda:

Cuplikan layar memperlihatkan cabang Azure DevOps dengan folder untuk item ruang kerja yang berbeda.

Langkah 2 - Membuat dan menjalankan alur Azure DevOps

Untuk membuat alur baru:

  1. Dari tab Alur dari menu navigasi kiri, pilih Buat Alur :

    Cuplikan layar memperlihatkan cara membuat alur.

  2. Pilih Azure Repos Git dan pilih repositori pertama (repositori yang terhubung ke ruang kerja Fabric):

    Cuplikan layar memperlihatkan Git repositori Azure dipilih sebagai sumber kode untuk alur.

    Cuplikan layar memperlihatkan repositori Demo-ADObuild dipilih.

  3. Anda dapat memilih Alur pemula.

    Cuplikan layar memperlihatkan ikon alur pemula dipilih.

    Kode YAML berikut muncul di editor:

    Cuplikan layar memperlihatkan kode YAML default.

  4. Salin dan tempel kode YAML dari alur mode pengembang Power BI ke dalam alur yang Anda buat:

    Cuplikan layar memperlihatkan kode YAML yang akan ditambahkan.

    Cuplikan layar memperlihatkan bagian kedua dari kode YAML.

  5. Pilih Simpan dan Jalankan untuk menerapkan alur baru Anda ke repositori.

    Cuplikan layar ulasan kode YAML.

    Cuplikan layar memperlihatkan pilihan simpan dan jalankan.

Azure DevOps menjalankan alur dan memulai dua pekerjaan build secara paralel:

Cuplikan layar memperlihatkan Azure DevOps yang menjalankan alur.

  • Build_Datasets
    • Mengunduh biner Editor Tabular.
    • Unduh aturan default Penganalisis Praktik Terbaik. Untuk menyesuaikan aturan, tambahkan Rules-Dataset.json ke akar repositori.
    • Telusuri semua folder item model semantik dan jalankan Aturan BPA Editor Tabular.
  • Build_Reports
    • Unduh biner PBI Inspector.
    • Unduh aturan default PBI Inspector. Untuk menyesuaikan aturan, tambahkan Rules-Report.json ke akar repositori.
    • Telusuri semua folder item laporan dan jalankan aturan Pemeriksa Power BI.

Setelah selesai, Azure DevOps membuat laporan semua peringatan dan kesalahan yang ditemuinya:

Cuplikan layar memperlihatkan laporan kesalahan.

Pilih tautan untuk membuka tampilan yang lebih rinci dari dua pekerjaan:

Cuplikan layar memperlihatkan tombol tampilkan log.

Cuplikan layar memperlihatkan log kesalahan yang diperluas.

Jika laporan atau model semantik Anda gagal aturan dengan tingkat keparahan yang lebih tinggi, build gagal, dan kesalahan disorot:

Cuplikan layar memperlihatkan kesalahan penyorot.

Langkah 3 - Tentukan kebijakan cabang

Setelah alur aktif dan berjalan, aktifkan Kebijakan Cabang di cabang utama . Langkah ini memastikan bahwa tidak ada penerapan yang dapat dilakukan langsung ke utama. "Permintaan penarikan" selalu diperlukan untuk menggabungkan perubahan kembali ke utama dan Anda dapat mengonfigurasi alur untuk dijalankan dengan setiap permintaan pull.

  1. Pilih Cabang>kebijakan Cabang>utama:

    Cuplikan layar memperlihatkan kebijakan cabang.

  2. Konfigurasikan alur yang dibuat sebagai Kebijakan Build untuk cabang:

    Cuplikan layar memperlihatkan UI kebijakan build.

    Cuplikan layar memperlihatkan bagian kedua dari UI kebijakan build.

Langkah 4 - Buat permintaan pull

Jika Anda kembali ke Ruang Kerja Fabric Anda, lakukan modifikasi pada salah satu laporan atau model semantik, dan mencoba melakukan perubahan, Anda menerima kesalahan berikut:

Cuplikan layar memperlihatkan kesalahan perubahan yang tidak dapat dilakukan.

Anda hanya dapat membuat perubahan pada cabang utama melalui permintaan pull. Untuk membuat permintaan pull checkout cabang baru untuk membuat perubahan pada:

Buat cabang langsung dari Ruang Kerja Fabric:

  1. Di panel Kontrol Sumber, pilih pada Cabang baru Checkout dan berikan nama untuk cabang tersebut.

    Cuplikan layar memperlihatkan layar kontrol sumber untuk memeriksa cabang baru.

    Cuplikan layar memperlihatkan cara memeriksa cabang baru.

    Atau, Anda dapat memilih untuk mengembangkan dalam ruang kerja terpisah yang terisolasi atau di Power BI Desktop. Untuk informasi selengkapnya, lihat Mengelola cabang Git

  2. Terapkan perubahan Anda ke cabang baru ini.

    Cuplikan layar memperlihatkan penerapan perubahan pada cabang.

  3. Setelah penerapan, buat permintaan pull ke cabang utama dari portal Azure DevOps.

    Cuplikan layar memperlihatkan permintaan pull baru yang dibuat.

    Cuplikan layar memperlihatkan permintaan pull yang dibuat.

Alur kerja permintaan pull tidak hanya memungkinkan Anda untuk memvalidasi dan meninjau perubahan, tetapi juga secara otomatis memicu alur.

Cuplikan layar memperlihatkan perubahan laporan.

Jika ada kesalahan tingkat keparahan tinggi di salah satu aturan, Anda tidak dapat menyelesaikan permintaan pull dan menggabungkan perubahan kembali ke cabang utama.

Cuplikan layar menyelesaikan permintaan pull.