Rayfin CLI ile Fabric uygulaması oluşturma

Bu öğreticide, rayfin CLI kullanarak proje oluşturma, yerel olarak çalıştırma ve 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 Fabric oturum açın.
  • Uygulamayı bir Fabric çalışma alanına dağıtın.
  • Dağıtım durumunu doğrulayın.

Prerequisites

  • Fabric’e erişim.
  • 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ü.

Bir yapay zeka istemiyle uygulama oluşturun

GitHub Copilot veya başka bir kodlama ajanı ile aşağıdaki promptu kullanarak bir Fabric uygulaması oluşturun, keşfedin, çalıştırın, özelleştirin ve dağıtın:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

Ajan, komutları etkileşimli olarak çalıştırır ve gerekli proje veya çalışma alanı ayarlarını ister. Dağıtımdan önce oluşturulan dosyaları ve komut çıktısını gözden geçirin. Eğer Fabric Apps iş yükü henüz etkin değilse, bir Fabric yöneticisine OneLakekatalogunda Yönetici>Yapılandırmalar>İş Yüklerikatalogunda>Fabric Apps'ı (önizleme) açmasını isteyin.

CLI'den yeni bir uygulama oluşturun

Ş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 .

Oluşturulan projeyi gözden geçirin

İ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.

Uygulamayı yerel olarak çalıştırma

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

npx rayfin 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.

Uygulamayı Fabric'e dağıtın

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

Dağıtımı doğrulayın.

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.

Sadece veritabanı veya statik içerik 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

Fonksiyon ekle

Fonksiyonlar, Fabric uygulamanızın içindeki sunucuda çalışan TypeScript fonksiyonlarıdır. Tarayıcıda çalışmaması gereken mantık fonksiyonlarını kullanın; örneğin sırlarla çalışmak, ayrıcalıklı verilere erişmek ve giriş yapan kullanıcı adına aşağı akış hizmetlerini çağırmak gibi.

npx rayfin functions init

GitHub Copilot, gerekli dosyaları ve bileşenleri oluşturup güncelleyebilir. Ayrıca ajandan uygulamayı çalıştırmasını, fonksiyonları yerel olarak hata ayıklamasını ve uygulamayı dağıtmasını da talep edebilirsiniz. Örneğin, fonksiyonları kullanarak bir yapay zeka çekme talebi inceleme asistanı oluşturmak için aşağıdaki istemi kullanabilirsiniz:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

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

  • Son güncelleştirme: