Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Pelajari cara kerja integrasi Git dan alur penyebaran dengan API untuk GraphQL di Microsoft Fabric. Artikel ini membantu Anda memahami cara menyiapkan koneksi ke repositori Anda, mengelola API untuk GraphQL, dan menyebarkannya di berbagai lingkungan.
Nota
API untuk pengendalian sumber dan penyebaran GraphQL saat ini dalam pratinjau.
Prasyarat
- Anda harus memiliki API untuk GraphQL di Fabric. Untuk informasi selengkapnya, lihat Membuat API untuk GraphQL di Fabric dan menambahkan data.
Gambaran Umum
Fabric menawarkan alat yang kuat untuk CI/CD (integrasi berkelanjutan dan penyebaran berkelanjutan) dan manajemen siklus hidup pengembangan melalui dua komponen utama: integrasi Git (CI) dan alur penyebaran (CD). Ruang kerja berfungsi sebagai komponen pusat untuk tahap sinkronisasi dan penyebaran Git.
Integrasi Git (CI): Menyinkronkan item ruang kerja (misalnya, kode, konfigurasi, API) dengan repositori kontrol versi, memungkinkan kontrol versi dan pelacakan perubahan melalui Git.
Alur penyebaran (CD): Memungkinkan pembuatan tahapan (misalnya, Pengembangan, Pengujian, Produksi) dengan ruang kerja yang ditautkan. Item yang didukung di setiap tahap secara otomatis direplikasi ke tahap berikutnya, dan perubahan dalam ruang kerja memicu penyebaran dalam alur rilis. Anda dapat mengonfigurasi alur untuk memastikan bahwa perubahan diuji dan disebarkan secara efisien di seluruh lingkungan.
Fabric mendukung berbagai alur kerja CI/CD yang disesuaikan dengan skenario umum. Untuk detail selengkapnya, lihat opsi alur kerja CI/CD di Fabric.
Nota
Hanya metadata yang disalin selama penyebaran; dan data tidak disalin.
Item dari ruang kerja disimpan di repositori Git terkait sebagai Infrastruktur sebagai Kode (IaC). Perubahan kode di repositori dapat memicu penyebaran dalam jalur pipa. Metode ini memungkinkan Anda memiliki perubahan kode yang direplikasi secara otomatis di seluruh tahap untuk tujuan pengujian dan rilis produksi.
Metode autentikasi sumber data
Di bagian ini, Anda mempelajari tentang metode autentikasi untuk menghubungkan sumber data ke API Anda untuk GraphQL dan memahami dampaknya pada pengikatan otomatis antara API untuk GraphQL dan sumber data yang terhubung dalam alur pengembangan. Anda dapat mempelajari selengkapnya tentang pengikatan otomatis dalam proses alur penyebaran.
Ada dua opsi yang tersedia untuk menyambungkan sumber data ke API Anda untuk GraphQL:
Menyambungkan ke sumber data Fabric dengan autentikasi Single Sign-On (SSO)
Menyambungkan ke Fabric ATAU sumber data eksternal menggunakan Kredensial Tersimpan
Opsi pertama, Single Sign-On (SSO), memungkinkan koneksi ke sumber data dalam Fabric. Dalam hal ini, ketika Anda menyambungkan sumber data ke GraphQL menggunakan metode Akses menyeluruh di ruang kerja asli (misalnya, tahap Dev), sumber data dan item GraphQL akan disebarkan ke ruang kerja target (misalnya, tahap Pengujian) di alur, dan GraphQL di ruang kerja target akan secara otomatis terhubung ke sumber data lokal yang disebarkan di ruang kerja target (lihat diagram di bawah). Ada batasan khusus saat menggunakan SSO dan menyambungkan ke sumber data melalui Titik Akhir Analitik SQL, untuk detail selengkapnya, lihat **Batasan Saat Ini.
Opsi kedua, Kredensial Tersimpan, memungkinkan koneksi ke sumber data eksternal di luar Fabric dan sumber data dalam Fabric. Namun, pengikatan otomatis tidak didukung untuk pendekatan Kredensial Tersimpan. Ini berarti bahwa jika Anda menyambungkan sumber data ke GraphQL menggunakan Kredensial Tersimpan di ruang kerja asli (tahap Dev), sumber data akan disebarkan ke ruang kerja target (Tahap pengujian) di alur. Namun, item GraphQL di ruang kerja target akan tetap terhubung ke sumber data di ruang kerja asli (tahap Dev) melalui Kredensial Tersimpan, daripada pengikatan otomatis ke sumber data lokal di ruang kerja target. (lihat diagram di bawah)
Selain itu, jika metode Kredensial Tersimpan digunakan untuk menyambungkan ke sumber data, pengembang harus memiliki akses ke informasi Kredensial Tersimpan agar berhasil menyebarkan item GraphQL.
Nota
Jika API untuk GraphQL di ruang kerja asli (tahap Dev) terhubung ke sumber data yang berada di ruang kerja yang berbeda, API yang disebarkan untuk GraphQL di ruang kerja target (Tahap pengujian) akan tetap terhubung ke sumber data yang terletak di ruang kerja yang berbeda terlepas dari metode autentikasi mana yang digunakan untuk menghubungkan sumber data ke API Anda untuk GraphQL. (lihat diagram di bawah)
API untuk integrasi Git dengan GraphQL
Fabric API untuk GraphQL menawarkan integrasi Git untuk kontrol sumber. Dengan integrasi Git, Anda dapat mencadangkan dan membuat versi API untuk GraphQL, kembali ke tahap sebelumnya sesuai kebutuhan, berkolaborasi, atau bekerja sendiri menggunakan cabang Git, dan mengelola API Anda untuk siklus hidup GraphQL sepenuhnya dalam Fabric.
Siapkan Koneksi:
Dari pengaturan Ruang Kerja, Anda dapat dengan mudah menyiapkan koneksi ke repositori Anda untuk menerapkan dan menyinkronkan perubahan. Untuk menyiapkan koneksi, lihat Mulai menggunakan integrasi Git. Setelah tersambung, item Anda, termasuk API untuk GraphQL, muncul di panel Kontrol sumber .
Setelah Anda berhasil menerapkan API untuk instans GraphQL ke repositori Git, Anda akan melihat struktur folder GraphQL di repositori. Anda sekarang dapat menjalankan operasi di masa mendatang, seperti Membuat permintaan pull.
Representasi GraphQL di Git:
Gambar berikut adalah contoh struktur file setiap API untuk item GraphQL di repositori Git:
Saat Anda menerapkan API untuk item GraphQL ke repositori Git, definisi API untuk GraphQL disimpan. Pendekatan ini mendukung pemulihan yang tepat saat Anda menyinkronkan kembali ke ruang kerja Fabric:
Anda dapat menemukan informasi selengkapnya tentang format definisi API GraphQL, sintaksis, dan contoh pada dokumentasi API sarana kontrol Fabric:
API untuk GraphQL dalam jalur penerapan
Gunakan langkah-langkah berikut untuk menyelesaikan API Anda untuk penyebaran GraphQL menggunakan alur penyebaran.
Buat alur penyebaran baru atau buka alur penyebaran yang ada. Untuk informasi selengkapnya, lihat Mulai menggunakan alur penyebaran.
Alokasikan ruang kerja ke tahap yang berbeda sesuai dengan tujuan deployment Anda.
Pilih, lihat, dan bandingkan item termasuk API untuk GraphQL di antara berbagai tahap, seperti yang ditunjukkan dalam contoh berikut. Area yang disorot menunjukkan jumlah item yang diubah antara tahap sebelumnya dan tahap saat ini.
- Pilih item yang perlu disebarkan. Pilih Sebarkan untuk menyebarkan item yang Anda pilih (API untuk GraphQL dan sumber Data Terhubungnya) di seluruh tahap Pengembangan, Pengujian, dan Produksi.
Pesan berikutnya muncul mengonfirmasi item yang akan Anda sebarkan. Pilih Sebarkan untuk mengonfirmasi dan melanjutkan proses penyebaran.
Batasan saat ini
Fabric CI/CD tidak menyediakan pengikatan otomatis untuk item turunan. Ini berarti bahwa jika API untuk GraphQL terhubung ke Titik Akhir Analitik SQL sebagai anak dari sumber data di ruang kerja asli (misalnya, tahap Dev), silsilah data tidak ditransfer ke ruang kerja target (misalnya, tahap Pengujian). Akibatnya, API yang disebarkan untuk GraphQL di ruang kerja target (misalnya, tahap Pengujian) tetap terhubung ke Titik Akhir Analitik SQL di ruang kerja asli (misalnya, tahap Dev).
Pengikatan otomatis tidak didukung saat pendekatan Kredensial Tersimpan digunakan untuk koneksi sumber data. Untuk informasi selengkapnya, lihat bagian metode autentikasi sumber data yang dijelaskan di atas.