Bir Fabric uygulamasını Fabric'e dağıtın

Oturum açarak, CLI dağıtım akışını çalıştırarak ve npx rayfin up'ın uygulamanız için yapılandırdığı yapılandırmaları gözden geçirerek Fabric için bir Fabric uygulaması dağıtın. Bu makalede, dağıtım sırasında ne olacağı kavramı gösterilmektedir.

Prerequisites

Uygulamanızı dağıtın

Proje kökünden aşağıdaki komutu çalıştırın:

npx rayfin up

Oturum açmadıysanız, CLI otomatik olarak etkileşimli bir oturum açma akışı başlatır.

Dağıtımın işlevi

komutu rayfin up şu adımları sırayla gerçekleştirir:

  1. Fabric çalışma alanınızda bir Fabric Uygulamaları öğesi oluşturur (veya mevcut olanı sonraki dağıtımlarda yeniden kullanabilir).
  2. Uzak hizmetten yayımlanabilir anahtarı alır.
  3. rayfin.yml’nizden çalışma zamanı ayarlarını, kimlik doğrulama yapılandırması ve hizmet bayrakları dahil, uzak hizmetle senkronize eder.
  4. TypeScript veri modeli dekoratörlerinizden oluşturulan veritabanı şemasını uygular.
  5. staticHosting rayfin.yml içinde etkinleştirilmişse statik içeriği oluşturur ve dağıtır—derleme komutunuzu çalıştırır, çıktı klasörünü ZIP dosyası olarak paketler ve karşıya yükler.
  6. Dağıtım ayrıntılarını, sonraki dağıtımlar için rayfin.yml ve .env.fabric-* dosyalarına kalıcı olarak yazar.

Dağıtımdan sonra CLI şunları yazdırır:

  • Uygulamanızın canlı olduğu barındırma URL'si
  • Dağıtımı yönetmek için bir Fabric portalı bağlantısı
  • Referans için dağıtım kimliği

Kimlik doğrulamasını yapılandırma

Dağıtılan uygulamalarda yalnızca Fabric aracılı kimlik doğrulaması (Entra SSO) desteklenir. Yerel geliştirme sırasında e-posta ve parola kimlik doğrulaması kullanılabilir ancak Fabric dağıtıldıktan sonra çalışmaz.

rayfin.yml çalıştırmadan önce rayfin up Fabric kimlik doğrulamasının etkinleştirildiğinden emin olun:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Değişiklik olmadan dağıtımı önizleme

Kaynak oluşturmadan veya değiştirmeden CLI'nin neler yapabileceğini görmek için kullanın --dry-run :

npx rayfin up --dry-run

Veritabanı değişikliklerini uygulama

Veri modellerinizi güncelleştirdikten sonra, şema değişikliklerini tüm yığını yeniden dağıtmadan uzak veritabanına gönderebilirsiniz:

npx rayfin up db apply

Şema değişikliği yıkıcı olabilecek işlemleri (sütunları bırakma, tabloları yeniden adlandırma) içeriyorsa, CLI sizi uyarır ve devam etmeyi reddeder. Güvenlik denetimini geçersiz kılmak için kullanın --force :

npx rayfin up db apply --force

Caution

kullanmak --force veri kaybına neden olabilir. Listelenen işlemleri dikkatle gözden geçirin ve devam etmeden önce sonuçları kabul ettiğinizi onaylayın.

Statik içeriği yeniden dağıtma

Yalnızca ön uç kodunu değiştirdiğinizde, statik içeriği daha hızlı bir yineleme döngüsü için bağımsız olarak yeniden dağıtabilirsiniz:

npx rayfin up staticapp deploy

Bu komut, yapılandırılan buildCommandkomutunu çalıştırır, çıkışı paketler ve uzak hizmete yükler.

Derleme adımını atlayıp mevcut çıktının dağıtımını yapmak için:

npx rayfin up staticapp deploy --skip-build

Dağıtım durumunu denetleme

Fabric dağıtımınızın geçerli durumunu görüntüleyin:

npx rayfin up status

Makine tarafından okunabilir çıkış için ekleyin --json :

npx rayfin up status --json

Mevcut dağıtımları güncelleştirme

İlk dağıtımdan sonra dağıtım rayfin.yml ayrıntılarını (rayfinItemId, fabricWorkspaceIdve öğe uç noktasını) depolar. Yeniden çalıştırmak npx rayfin up , yeni bir dağıtım oluşturmak yerine aynı dağıtımı güncelleştirir.

Hedeflenen güncelleştirmeler için aşağıdaki alt komutları kullanın:

Komut Neleri güncelleştirir?
npx rayfin up Her şey: ayarlar, veritabanı ve statik içerik.
npx rayfin up db apply Yalnızca veritabanı şeması.
npx rayfin up staticapp deploy Yalnızca statik içerik.

Dağıtım sorunlarını giderme

Dağıtım 401 veya 403 hatasıyla başarısız oluyor

Oturumunuzun süresi dolmuş olabilir. Komutunu çalıştırarak npx rayfin login yeniden kimlik doğrulaması yapın ve yeniden deneyin npx rayfin up.

Veritabanı uygulama raporları yıkıcı değişiklikleri bildirir

Rayfin CLI, veri kaybına neden olabilecek şema değişikliklerini engeller. Listelenen işlemleri gözden geçirin ve yalnızca veri kaybını kabul ettiğinizi onayladıktan sonra kullanın npx rayfin up db apply --force .

Statik dağıtım boyut sınırını aşıyor

Sıkıştırılmış arşiv 100 MB'ı aşmamalıdır. Kaynak eşlemeleri ve büyük geliştirme varlıklarını hariç tutarak derleme çıkışınızı iyileştirin veya ikili dosyaları Fabric Apps depolama alanına taşıyın.

uygulamanızı Fabric portalında yönetme

Dağıtımdan sonra Fabric uygulamanızı doğrudan Fabric portalında yönetebilirsiniz.

Öğe özelliklerini görüntüleme

aşağıdakileri görmek için Fabric portalında Fabric uygulamasını açın:

  • Uygulama URL'si — Statik içeriğinizin barındırıldığı genel URL.
  • Uygulama arka uç URL'si — Tüm arka uç hizmetlerinin temel URL'si.

Alt hizmetleri yönetin

Alt hizmetlerini görmek için Fabric uygulamasını seçin:

  • SQL Veritabanı — Fabric SQL sorgu düzenleyicisini açar. Verilerinizde okuma sorguları çalıştırabilirsiniz. Fabric portalında doğrudan yapılan şema değişiklikleri, bir sonraki rayfin up dağıtımında üzerine yazılır.
  • Kimlik doğrulaması — Alt SQL Veritabanı'ndaki Kullanıcılar tablosunda kimliği doğrulanmış kullanıcıları görüntüleyin ve yönetin.

Uygulama izinleri

Fabric uygulamasına katkıda bulunan herkesin, bir Fabric uygulamasını dağıtabilmesi için öğe üzerinde en az Edit iznine sahip olması gerekir.

İlgili içerik

  • Last updated on