Mengelola kontainer Fluid
Kontainer adalah unit atom penyimpanan dalam layanan Azure Fluid Relay dan mewakili data yang disimpan dari sesi Fluid, termasuk operasi dan rekam jepret. Runtime Fluid menggunakan kontainet untuk rehidrasi status sesi Fluid saat pengguna bergabung untuk pertama kalinya atau bergabung kembali setelah keluar.
Saat membuat aplikasi dengan Fluid Framework, ada beberapa hal yang perlu Anda pertanggungjawabkan mengenai pembuatan dan pengelolaan kontainer, sebagaimana dirangkum dalam diagram ini.
Konsep utama
Izin Kontainer
Dalam kebanyakan kasus, pengembang akan ingin mengelola inventaris kontainer dan izin kontainer. Ini akan mencakup informasi tentang siapa yang memiliki akses ke kontainer serta metadata seperti nama kontainer yang mudah diingat.
Mengakses kontainer
Kontainer direferensikan oleh ID kontainer. Sebelum pengguna dapat membuat atau membuka kontainer, mereka harus meminta JWT yang akan digunakan Fluid Runtime saat berkomunikasi dengan layanan Azure Fluid Relay. Setiap proses dengan JWT yang valid dapat mengakses kontainer. Merupakan tanggung jawab pengembang untuk membuat JWT untuk akses kontainer, yang membuat mereka memiliki kontrol atas logika bisnis guna mengontrol akses yang sesuai untuk skenario mereka. Layanan Azure Fluid Relay tidak memiliki pengetahuan tentang pengguna yang harus memiliki akses ke kontainer. Untuk informasi selengkapnya tentang topik ini, lihat kontrak token Azure Fluid Relay
Catatan
DocumentID bidang JWT sesuai dengan ID kontainer Fluid.
Penamaan Kontainer
Kontainer diberi nama oleh layanan Azure Fluid Relay pada waktu pembuatan kontainer. Tindakan Buat menampilkan nama kontainer dalam bentuk GUID yang harus digunakan nanti untuk membuka kontainer. Dalam kebanyakan kasus, pengembang akan ingin menyimpan GUID ID kontainer ini, bersama dengan nama yang mudah diingat, di toko data mereka sendiri untuk memfasilitasi alur penemuan kontainer.
Penemuan Kontainer
Pengembang bertanggung jawab atas pengalaman dan logika bisnis apa pun yang terkait dengan penemuan pengguna kontainer yang ada. Ini bisa berbentuk daftar kontainer yang dapat dijelajahi berdasarkan partisipasi pengguna dalam sesi Fluid, berbagi kontainer langsung antara pengguna, atau tugas kontainer terprogram ke artefak atau proses yang ada.
Contoh alur pembuatan kontainer
Dalam contoh ini, aplikasi/halaman dimuat dengan JWT generik (tidak terikat pada kontainer tertentu) yang akan digunakan aplikasi klien ketika tiba saatnya untuk membuat kontainer baru.
Aplikasi sisi klien menggunakan API Fluid Framework untuk membuat kontainer baru di layanan Azure Fluid Relay yang menghasilkan objek kontainer dengan ID kontainer yang baru ditetapkan. Interaksi lebih lanjut dengan kontainer memerlukan JWT baru yang berisi ID kontainer.
Setelah klien membuat kontainer baru, klien akan menyimpan ID kontainer di beberapa sistem yang memetakan kontainer dan pengguna untuk mengelola izin. Sistem ini akan mendorong setiap penemuan kontainer/pengalaman penelusuran yang ingin dibuat pengembang untuk pengguna mereka.
Sebelum berinteraksi dengan kontainer, klien akan meminta JWT khusus kontainer yang akan digunakan untuk panggilan berikutnya dari runtime Fluid Framework ke layanan Azure Fluid Relay.
Mengekspor konten kontainer
Jika aplikasi menyimpan data yang mungkin perlu diekspor oleh pengguna akhir, pengembang aplikasi bertanggung jawab untuk membangun fungsi ekspor tersebut ke dalam aplikasinya, menggunakan status saat ini dari kontainer Fluid seperti yang ditunjukkan oleh Struktur Data Terdistribusi yang ditentukan dalam kontainer. Untuk informasi selengkapnya tentang menghubungkan dan membuka kontainer Fluid, lihat: Kontainer (fluidframework.com). Untuk informasi selengkapnya tentang mencantumkan dan menghapus kontainer dengan API sarana kontrol, lihat: Menghapus kontainer Fluid di Microsoft Azure Fluid Relay Server.