Akışkan kapsayıcılarını yönetme
Kapsayıcı, Azure Fluid Relay hizmetindeki atomik depolama birimidir ve işlemler ve anlık görüntüler de dahil olmak üzere Bir Fluid oturumundan depolanan verileri temsil eder. Fluid çalışma zamanı, bir kullanıcı ilk kez katıldığında veya ayrıldıktan sonra yeniden katıldığında Fluid oturumunun durumunu yeniden doldurması için kapsayıcıyı kullanır.
Akıcı Çerçeve ile bir uygulama oluştururken, bu diyagramda özetlenen kapsayıcı oluşturma ve yönetimiyle ilgili olarak dikkate almanız gereken birkaç şey vardır.
Önemli kavramlar
Kapsayıcı izinleri
Çoğu durumda, geliştiriciler kapsayıcıların ve kapsayıcı izinlerinin envanterini yönetmek isteyecektir. Bu, kapsayıcılara kimlerin erişimi olduğu hakkında bilgilerin yanı sıra kapsayıcının kolay adı gibi meta verileri de içerir.
Kapsayıcılara erişme
Kapsayıcılara kapsayıcı kimliği tarafından başvurulur. Bir kullanıcının kapsayıcı oluşturabilmesi veya açabilmesi için önce Fluid Runtime'ın Azure Fluid Relay hizmetiyle iletişim kurarken kullanacağı bir JWT istemesi gerekir. Geçerli bir JWT içeren tüm işlemler bir kapsayıcıya erişebilir. Kapsayıcı erişimi için JWT'ler oluşturmak geliştiricinin sorumluluğundadır ve bu da erişimi senaryolarına uygun şekilde denetlemek için iş mantığının denetimine sahip olmasını sağlar. Azure Fluid Relay hizmeti, hangi kullanıcıların bir kapsayıcıya erişmesi gerektiği konusunda bilgi sahibi değildir. Bu konu hakkında daha fazla bilgi için bkz . Azure Fluid Relay belirteç sözleşmesi
Dekont
JWT alanı documentID değeri Akışkan kapsayıcı kimliğine karşılık gelir.
Kapsayıcı adlandırma
Kapsayıcılar, kapsayıcı oluşturma zamanında Azure Fluid Relay hizmeti tarafından adlandırılır. Oluştur eylemi, daha sonra kapsayıcıyı açmak için kullanılması gereken GUID biçiminde bir kapsayıcı adı döndürür. Çoğu durumda, geliştiriciler kapsayıcı bulma akışlarını kolaylaştırmak için bu kapsayıcı kimliği GUID'sini kolay bir adla birlikte kendi veri depolarında depolamak isteyecektir.
Kapsayıcı bulma
Geliştiriciler, mevcut kapsayıcıların kullanıcı tarafından bulunmasıyla ilgili tüm deneyimlerden ve iş mantığından sorumludur. Bu, Akıcı oturumda kullanıcı katılımına, kullanıcılar arasında kapsayıcıların doğrudan paylaşılmasına veya kapsayıcıların mevcut yapıtlara veya işlemlere programlı olarak atanmalarına bağlı olarak göz atılabilir bir kapsayıcı listesi biçiminde olabilir.
Örnek kapsayıcı oluşturma akışı
Bu örnekte uygulama/sayfa, istemci uygulamasının yeni bir kapsayıcı oluşturma zamanı geldiğinde kullanacağı genel bir JWT (belirli bir kapsayıcıya bağlı değildir) ile yüklenir.
İstemci tarafı uygulaması, Azure Fluid Relay hizmetinde yeni bir kapsayıcı oluşturmak için Akıcı Çerçeve API'sini kullanır ve bu da yeni atanan kapsayıcı kimliğine sahip bir kapsayıcı nesnesine neden olur. Kapsayıcıyla daha fazla etkileşim için kapsayıcı kimliğini içeren yeni bir JWT gerekir.
İstemci yeni kapsayıcıyı oluşturduktan sonra kapsayıcı kimliğini kapsayıcıları ve kullanıcıları izinleri yönetmek üzere eşleyen bir sisteme kaydeder. Bu sistem, geliştiricinin kullanıcıları için oluşturmak istediği kapsayıcı bulma/gözatma deneyimini yönlendirir.
Kapsayıcıyla etkileşim kurmadan önce istemci, Akıcı Çerçeve çalışma zamanından Azure Fluid Relay hizmetine sonraki çağrılar için kullanılacak kapsayıcıya özgü bir JWT isteyecektir.
Kapsayıcı içeriğini dışarı aktarma
Bir uygulama son kullanıcılar tarafından dışarı aktarılması gerekebilecek verileri depolarsa uygulama geliştiricisi, kapsayıcıda tanımlanan Dağıtılmış Veri Yapıları tarafından temsil edilen Akışkan kapsayıcısının geçerli durumunu kullanarak bu işlevi kendi uygulamasına dışarı aktaran derlemeden sorumludur. Akışkan kapsayıcılarına bağlanma ve açma hakkında daha fazla bilgi için bkz. Kapsayıcılar (fluidframework.com). Denetim düzlemi API'si ile kapsayıcıları listeleme ve silme hakkında daha fazla bilgi için bkz. Microsoft Azure Fluid Relay Server'da Akışkan kapsayıcılarını silme.