İş yüklerine giriş

Bu bölümde, sistemimizin temel bileşenleri tanıtılmaktadır ve mimariye genel bir bakış sağlanmaktadır. Bu bileşenler birlikte çalışarak geliştirme gereksinimleriniz için sağlam ve esnek bir platform oluşturur. Şimdi bu bileşenleri ve mimarimizdeki rollerini ele alalım.

Doku iş yükü mimarisi

Doku iş yükü mimarisinin önemli yönlerinden bazıları şunlardır:

• Veri işlemeyi, depolamayı ve yönetimi işler. Microsoft Entra ID belirteçlerini işlemeden önce doğrular ve Lakehouse gibi dış Azure hizmetleriyle etkileşim kurar.

• İş yükü Ön Ucu (FE), iş oluşturma, yazma, yönetim ve yürütme için bir kullanıcı arabirimi sunar.

• FE aracılığıyla yapılan kullanıcı etkileşimleri, doğrudan veya dolaylı olarak Doku Arka Ucu (Fabric BE) aracılığıyla BE'ye yönelik istekleri başlatır.

Çeşitli bileşenlerin iletişimini ve kimlik doğrulamasını gösteren daha ayrıntılı diyagramlar için bkz . Arka uç kimlik doğrulamasına ve yetkilendirmeye genel bakış ve Kimlik doğrulamasına genel bakış diyagramları.

Ön uç (FE)

Ön uç, Doku portalındaki bir iframe içinde çalışan kullanıcı deneyiminin (UX) ve davranışının temelini oluşturur. Yapı iş ortağına öğe düzenleyicisi de dahil olmak üzere belirli bir kullanıcı arabirimi deneyimi sağlar. Uzantı istemcisi SDK'sı, normal bir web uygulamasını Doku portalında sorunsuz bir şekilde çalışan bir Mikro Ön Uç web uygulamasına dönüştürmek için gerekli arabirimleri, API'leri ve bootstrap işlevlerini donatıyor.

Arka uç (BE)

Arka uç, veri işleme ve meta veri depolama için kullanılan güç merkezidir. Meta verilerle birlikte iş yükü öğeleri oluşturmak ve yönetmek için CRUD işlemlerini kullanır ve depolamadaki verileri doldurmak için işleri yürütür. Ön uç ve arka uç arasındaki iletişim köprüsü genel API'ler aracılığıyla kurulur.

İş yükleri iki ortamda çalıştırılabilir: yerel ve bulut. Yerel (devmode) içinde iş yükü geliştiricinin makinesinde çalışır ve API çağrıları DevGateway yardımcı programı tarafından yönetilir. Bu yardımcı program, Doku ile iş yükü kaydını da işler. Bulut modunda iş yükü iş ortağı hizmetlerinde çalışır ve API çağrıları doğrudan bir HTTPS uç noktasına yapılır.

Geliştirme ortamı

• Geliştirme modu iş yükü paketi: Visual Studio'da arka uç çözümü oluştururken Hata Ayıklama derleme yapılandırmasını kullanarak DevGateway uygulaması kullanılarak Doku kiracısına yüklenebilen bir BE NuGet paketi oluşturun.

• Bulut modu iş yükü paketi: Visual Studio'da BE çözümünü oluştururken, tek başına iş yükü paketi (BE ve FE) oluşturmak için Sürüm derleme yapılandırmasını kullanın. Bu paket doğrudan kiracıya yüklenebilir.

• Hata Ayıklama ve Sürüm derleme yapılandırmaları hakkında daha fazla bilgi için bkz . Derleme yapılandırmasını değiştirme

İş yükü NuGet paket yapısı

İş yükü, arka uç ve ön uç bileşenlerini birleştiren bir NuGet paketi olarak paketlenmiştir. Yapı belirli adlandırma kurallarına bağlıdır ve karşıya yükleme senaryolarında tutarlılık sağlamak için Doku tarafından zorlanır. İş yüklerini temsil etmek için tasarlanan NuGet paketi hem arka uç hem de ön uç bileşenlerini içerecek şekilde yapılandırılmıştır.

Arka uç yapısı

Arka uç kesimi, dokuya kayıt için gerekli olan iş yükünü ve ilişkili öğelerini tanımlayan .xml dosyalardan oluşur.

Anahtar bileşenler

• WorkloadManifest.xml - Doku doğrulaması için tam olarak bu ada sahip olması gereken iş yükü yapılandırma dosyası.
• Item1.xml, Item2.xml, ... - XML biçimini izleyerek esnek adlandırmaya sahip tek tek öğeler için bildirimler.

Ön uç yapısı

Ön uç bölümü, ön uç için ürün ve öğeleri ayrıntılı olarak gösteren .json dosyalarının yanı sıra simgeler için bir 'assets' dizini içerir.

Anahtar bileşenler

• Product.json - Ürününüzün ön ucu için ana bildirimdir ve bu bildirim, Fabric'in doğrulaması için tam olarak adlandırılmalıdır.
• Item1.json, Item2.json, ... - JSON biçimini izleyerek esnek adlandırmaya sahip tek tek öğeler için bildirimler. Her json bir arka uç bildirimine karşılık gelir (örneğin, Item1.xml Item1.json).
• assets folder - Ön uç tarafından kullanılan tüm simgeleri icon1.jpg, icon2.pngdepolar ... .

Zorunlu yapı uyumluluğu

Belirli alt klasör adları ('BE', 'FE', 'assets' dahil olmak üzere yapı, test ve geliştirme paketleri de dahil olmak üzere tüm karşıya yükleme senaryoları için Fabric tarafından zorunludur ve uygulanır. Yapı, dizinin altındaki .nuspec depoda bulunan dosyalarda belirtilirBackend/src/Packages/manifest.

Sınırlar

Aşağıdaki sınırlar hem geliştirme modunda hem de bulut modundaki tüm NuGet paketleri için geçerlidir:

• Yalnızca BE ve FE alt klasörlere izin verilir. Bu klasörlerin dışında bulunan diğer alt klasörler veya dosyalar karşıya yükleme hatasına neden olur.
• Klasör BE yalnızca .xml dosyaları kabul eder. Diğer tüm dosya türleri karşıya yükleme hatasıyla sonuçlanır.
• En fazla 10 öğe dosyası kullanılmasına izin verilir; başka bir deyişle BE klasör bir WorkloadManifest.xml ve en çok 10 Item.xml dosya içerebilir. Klasörde 10'dan fazla öğe dosyası olması karşıya yükleme hatasına neden olur.
• Assets Alt klasör klasörün altında FE bulunmalıdır. En fazla 15 dosya içerebilir ve her dosya 1,5 MB'tan büyük değildir.
• Alt klasörde yalnızca aşağıdaki dosya türlerine Assets izin verilir: .jpeg, .jpg, .png.
• Klasör en FE fazla 10 öğe dosyası ve bir product.json dosya içerebilir.
• boyutunun product.json 50 KB'ı aşmaması gerekir.
• Klasördeki Assets her varlığa öğe dosyaları içinde başvurulmalıdır. Klasörde eksik Assets olan bir öğe dosyasından başvuruda bulunılan tüm varlıklar karşıya yükleme hatasına neden olur.
• Öğelerin dosya adları benzersiz olmalıdır. Yinelenen dosya adları karşıya yükleme hatasıyla sonuçlanır.
• Dosya adları yalnızca alfasayısal (İngilizce) karakter veya kısa çizgi içermelidir ve 32 karakter uzunluğundan fazla olamaz. Diğer karakterlerin kullanılması veya bu uzunluğun aşılması karşıya yükleme hatasına neden olur.
• Toplam paket boyutu 20 MB'ı aşmamalıdır.
• Bildirime özgü sınırlamalar için lütfen iş yükü bildirimine bakın.

Yerel geliştirme modu (devmode)

İş yükü arka ucu (BE), geliştiricinin makinesinde çalışır. İş yükü API'leri çağrıları, Azure Relay kanalının iş yükünün tarafı DevGateway adlı özel bir komut satırı yardımcı programı tarafından yönetilir. İş yükü denetimi API çağrıları, Azure Relay kanalı atlayarak doğrudan iş yükünden Doku'ya gönderilir. DevGateway yardımcı programı, belirli bir çalışma alanı bağlamında iş yükünün yerel geliştirme örneğinin Fabric ile kaydını da denetler. DevGateway yardımcı programının sonlandırılmasına bağlı olarak iş yükü örneğinin kaydı otomatik olarak yeniden kaldırılır. Daha fazla bilgi için bkz . Arka uç uygulama kılavuzu.

DevMode BE şeması

Bulut geliştirme modu (bulut modu)

İş yükü arka ucu (BE), iş ortağının hizmetleri içinde çalışır. İş yükü API'si çağrıları, iş yükü bildiriminde belirtildiği gibi doğrudan HTTPS uç noktasına yapılır. Bu senaryoda DevGateway yardımcı programı gerekli değildir. İş yükünün Doku ile kaydı, iş yükü NuGet paketini Doku'ya yükleyerek ve ardından kiracı için iş yükünü etkinleştirerek gerçekleştirilir. Daha fazla bilgi için bkz . Dokuda iş yükünü yönetme.

CloudMode BE şeması

İlgili içerik

• Öğe yaşam döngüsü
• Ortamınızı ayarlama
• Dokuda iş yükünü yönetme