Rayfin CLI ile Fabric uygulaması oluşturma

Bu öğreticide, rayfin CLI kullanarak proje oluşturma, yerel olarak çalıştırma ve Microsoft Fabric dağıtma işlemi gösterilmektedir. Yeni uygulamalar ve şemanızda veya ön ucunuzda daha sonraki güncelleştirmeler için aynı CLI iş akışını kullanırsınız.

Bu eğitimde, siz:

  • Şablondan bir Fabric Apps projesi oluşturun.
  • Uygulamayı yerel olarak başlatın.
  • CLI'dan Microsoft Fabric oturum açın.
  • Uygulamayı bir Fabric çalışma alanına dağıtın.
  • Dağıtım durumunu doğrulayın.

Prerequisites

  • Microsoft Fabric erişimi.
  • Katkıda Bulunan, Üye veya Yönetici izinlerine sahip olduğunuz bir Fabric çalışma alanı.
  • Kiracınızda etkin olan Fabric Uygulamaları iş yükü.
  • Node.js ve npm yüklü.

Fabric Apps iş yükü henüz etkinleştirilmediyse, Fabric yöneticisinden Fabric yönetici portalında Fabric Apps (önizleme) açmasını isteyin.

1. Adım: Yeni proje oluşturma

Şablondan yeni bir uygulamanın iskelesini oluşturmak için kullanın npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Bu komut uygulama şablonu, rayfin yapılandırma ve ön uç kaynak kodu ile yeni bir proje klasörü oluşturur.

Proje dizinine gidin:

cd my-app

Tavsiye

Zaten boş bir proje klasörünüz veya mevcut kaynak kodunuz varsa yerine kullanın npx rayfin initnpm create.

npx rayfin init .

2. Adım: Oluşturulan projeyi gözden geçirme

İskelet oluşturulduktan sonra proje, geliştirmeye başlamanız için gereken dosyaları içerir:

  • rayfin/rayfin.yml uygulama hizmetlerini ve dağıtım ayarlarını depolar.
  • rayfin/.env CLI tarafından kullanılan ortam değerlerini depolar.
  • rayfin/data/ veri modeli dosyalarınızı içerir.
  • Ön uç uygulamanız, seçili şablon tarafından oluşturulan kök proje yapısında yer alır.

Ayrıntılı dosya dökümü için bkz. Proje yapısını anlama.

3. Adım: Uygulamayı yerel olarak çalıştırma

Yerel geliştirme ortamını başlatın:

npm run dev

Bu komut, oluşturulan uygulama için ön uç geliştirme sunucusunu başlatır ve arka ucu Fabric’e dağıtır. Uygulamanın doğru şekilde başladığını onaylamak için terminalde gösterilen yerel URL'yi açın.

4. Adım: Uygulamayı Fabric dağıtma

Uygulamanızda daha fazla özellik oluşturun. Değişikliklerinizi test ettikten sonra yeniden Fabric’e dağıtın.

npx rayfin up

Değişiklik yapmadan dağıtımın önizlemesini görüntülemek için şunu çalıştırın:

npx rayfin up --dry-run

5. Adım: Dağıtımı doğrulama

Geçerli dağıtım durumunu denetleyin:

npx rayfin up status

Makine tarafından okunabilir bir yanıt için JSON çıkışını kullanın:

npx rayfin up status --json

Başarılı bir dağıtımdan sonra CLI, barındırılan uygulama URL'sini ve dağıtılan öğenin Fabric portalı bağlantısını yazdırır.

6. Adım: Yalnızca veritabanını veya statik içeriği dağıtın

Yalnızca veri modellerini değiştirdiyseniz, veritabanı değişikliklerini tam yeniden dağıtmadan uygulayın:

npx rayfin up db apply

Yalnızca ön uç kodunu değiştirdiyseniz statik varlıkları yeniden dağıtın:

npx rayfin up staticapp deploy

Yaygın sorunları giderme

Oturum açma başarısız oluyor veya dağıtım 401 veya 403 değerini döndürüyor

Komutunu yeniden çalıştırın npx rayfin login ve yeniden deneyin npx rayfin up.

CLI'nın ne yapacağını incelemeniz gerekir

Değişiklikleri dağıtmadan önce npx rayfin up --dry-run komutunu çalıştırın.

Uygulama dağıtılır, ancak yalnızca şemayı değiştirirsiniz

Şema değişikliklerini bağımsız olarak göndermek için kullanın npx rayfin up db apply. Bir sütunun türünü değiştirme veya sütunu kaldırma gibi yıkıcı değişiklikler yaparsanız, bu komut başarısız olur. Değişikliklerinizi zorla uygulamak için --force bayrağını kullanabilirsiniz. Bu eylem, hataya neden olan bir değişiklik olabilir.

Sonraki Adımlar

  • Last updated on