Hızlı Başlangıç: Zar rulosu

Makale
03/14/2023

Bu hızlı başlangıçta, Azure Fluid Relay hizmetini kullanan bir zar rulosu uygulaması oluşturma işlemini inceleyeceğiz. Hızlı başlangıç iki bölüme ayrılmıştır. Birinci bölümde uygulamanın kendisini oluşturacak ve yerel bir Akıcı sunucuya karşı çalıştıracağız. 2. bölümde uygulamayı yerel geliştirme sunucusu yerine Azure Fluid Relay hizmetinde çalışacak şekilde yeniden yapılandıracağız.

Bu hızlı başlangıçta kullanılan örnek koda buradan ulaşabilirsiniz.

Geliştirme ortamınızı kurma

Bu hızlı başlangıcı takip etmek için bir Azure hesabı ve Azure Fluid Relay'in sağlanması gerekir. Hesabınız yoksa Azure'ı ücretsiz olarak deneyebilirsiniz.

Ayrıca bilgisayarınızda aşağıdaki yazılımların yüklü olması gerekir.

Kod düzenleyicisi -- Visual Studio Code öneririz.
Git
Node.js sürüm 12.17 veya üzeri

Yerel Olarak Başlarken

İlk olarak, örnek uygulamayı GitHub'dan indirmeniz gerekir. Yeni bir komut penceresi açın ve kodu indirmek istediğiniz klasöre gidin ve Git'i kullanarak FluidHelloWorld deposunu kopyalayıp dala main-azure göz atın. Kopyalama işlemi, içinde proje dosyaları bulunan FluidHelloWorld adlı bir alt klasör oluşturur.

git clone -b main-azure https://github.com/microsoft/FluidHelloWorld.git

Yeni oluşturulan klasöre gidin, bağımlılıkları yükleyin ve uygulamayı başlatın.

cd FluidHelloWorld
npm install
...
npm start

Komutu çalıştırdığınızda npm start iki şey olur. İlk olarak, bir Akışkan sunucusu yerel bir işlemde başlatılır. Bu sunucu yalnızca geliştirme amaçlıdır. Daha sonra Azure tarafından barındırılan bir üretim sunucusuna yükselteceksiniz. İkinci olarak, zar rulosu uygulamasının yeni bir örneğini içeren sayfaya yeni bir tarayıcı sekmesi açılır. Zar rulosu uygulamasının ek örneklerini oluşturmak için aynı URL'ye sahip yeni sekmeler açabilirsiniz. Uygulamanın her örneği varsayılan olarak yerel Akıcı hizmetinizi kullanacak şekilde yapılandırılır. Uygulamanın herhangi bir örneğinde Yuvarla düğmesine tıklayın ve zarın durumunun her istemcide değiştiğini unutmayın.

Azure Fluid Relay'e yükseltme

Azure Fluid Relay hizmetinde çalıştırmak için uygulamanızın yapılandırmasını yerel sunucunuz yerine Azure hizmetinize bağlanacak şekilde güncelleştirmeniz gerekir.

Azure istemcisi yapılandırma ve oluşturma

"@fluidframework/test-client-utils paketlerini yükleyin @fluidframework/azure-client ve Azure client ile InsecureTokenProvider'ı içeri aktarabilirsiniz.

import { InsecureTokenProvider } from "@fluidframework/test-client-utils";
import { AzureClient } from "@fluidframework/azure-client";

Azure istemcisini yapılandırmak için içindeki app.js yerel bağlantı serviceConfig nesnesini Azure Akıcı Geçiş hizmeti yapılandırma değerlerinizle değiştirin. Bu değerler, Azure portal Akışkan Geçişi kaynağının "Erişim Anahtarı" bölümünde bulunabilir. Nesneniz serviceConfig , değiştirilen değerlerle birlikte aşağıdaki gibi görünmelidir. (Bu değerleri bulma hakkında bilgi için bkz. Nasıl yapılır: Azure Akıcı Geçiş hizmeti sağlama.) ve name alanlarının id rastgele olduğunu unutmayın.

const user = { id: "userId", name: "userName" };

const serviceConfig = {
    connection: {
        tenantId: "MY_TENANT_ID", // REPLACE WITH YOUR TENANT ID
        tokenProvider: new InsecureTokenProvider("" /* REPLACE WITH YOUR PRIMARY KEY */, user),
        endpoint: "https://myServiceEndpointUrl", // REPLACE WITH YOUR SERVICE ENDPOINT
        type: "remote",
    }
};

Uyarı

Geliştirme sırasında, Azure Fluid Relay hizmetinin kabul edeceği kimlik doğrulama belirteçlerini oluşturmak ve imzalamak için kullanabilirsiniz InsecureTokenProvider . Ancak adından da anlaşılacağı gibi, bu güvenli değildir ve üretim ortamlarında kullanılmamalıdır. Azure Fluid Relay kaynak oluşturma işlemi, güvenli istekleri imzalamak için kullanılabilecek bir gizli anahtar sağlar. Bu gizli dizinin açığa çıkarılmamasını sağlamak için, üretime sunulmadan önce belirteci güvenli, geliştirici tarafından sağlanan bir arka uç hizmetinden getiren başka bir ITokenProvider uygulamasıyla değiştirilmelidir.

Güvenli yaklaşımlardan biri "Nasıl yapılır: Azure İşlevi ile TokenProvider Yazma" bölümünde özetlenmiştir.

Yalnızca istemciyi derleme ve çalıştırma

Artık uygulamanızı yerel sunucu yerine Azure'ı kullanmaya işaret ettiğinize göre istemci uygulamanızla birlikte yerel Akıcı sunucuyu başlatmanız gerekmez. Bu komutla sunucuyu başlatmadan istemciyi başlatabilirsiniz.

npm run start:client

🥳Tebrikler🎉 Akıcı işbirliği dünyasının kilidini açma yolundaki ilk adımı başarıyla atmışsınız.

Aracılığıyla paylaş