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: npx -y @microsoft/create-rayfin@latest --project-name rayfin-app-ws --template blankapp
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

scaffold komutu, etkileşimsiz yürütme için proje adını ve şablonu sağlar. Ajan, kalan çalışma alanı veya dağıtım ayarlarını talep edebilir. Dağıtımdan önce oluşturulan dosyaları ve komut çıktısını gözden geçirin.

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>

Varsayılan blankapp şablon Universal Uygulama olarak çözülür. rayfin/ altında arka uç yapılandırması, packages/frontend/ içinde ön uç kodu, packages/data/ içinde çalışma zamanı veri tanımları ve packages/shared/ içinde paylaşılan sözleşmeler bulunan yeni bir npm çalışma alanı oluşturur. Veri, siz izin verene kadar devre dışı kalıyor.

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.
  • packages/frontend/ arayüzü ve ön yüz yapısını içerir.
  • packages/data/, çalışma zamanı varlık sınıflarını ve şema kaydını içerir.
  • packages/shared/ müşteriye yönelik kayıt ve şema tanımlarını içerir.

Gerektiğinde kalıcı uygulama verilerini etkinleştirin:

npm run pack:add -- data-modeling

Bu özellik, Data özelliğini etkinleştirir ve başlangıç verisi ile paylaşılan tanımlar ekler. Dosya eklemeden önce rayfin/rayfin.yml içinde services.data.path ve services.staticHosting.path öğelerini kontrol edin. Diğer şablonlar düz kök src/ ve rayfin/data/ düzen kullanabilir; bu düzenler alternatiflerdir, varsayılan Evrensel Uygulama düzeni değildir.

CLI, aktif dağıtım değerlerini rayfin/.env içinde tutar ve dağıtımları rayfin/.deployments.json içinde kaydeder. Genel RAYFIN_PUBLIC_* değerler, ön tarafın oluşturulan .env.local değerlerine eşlenir; dağıtıma almadan yeniden oluşturmak için npx rayfin env --framework vite kullanın.

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 için işlevleri kullanın; örneğin sırlarla çalışmak, ayrıcalıklı verilere erişmek ve uygulama kimliğiyle harici hizmetleri çağırmak.

npx rayfin functions init

Başlatıcı, yapılandırıldığında services.functions.path kullanır, packages/functions gibi bir çalışma alanı konumunu algılar veya mevcut düz rayfin/functions paketini korur. Açıkça bir konum seçmek için --path <relative-path> kullanın.

Etkin Fonksiyonlar için services.functions.auth.type: application gereklidir. ctx.Tokens.* aracılığıyla yapılan dış çağrılar, çağrı yapan kullanıcının dış kaynak izinlerini değil, uygulama kimliğini ve izinlerini kullanır. Mevcut Fabric uygulamalarında bu kimlik uygulama öğesi sahibidir. Her kaynağa erişim izni ver. Buna karşılık, ctx.getDataClient() çağrının Rayfin tokenını kullanır ve arayanın veri politikalarını korur.

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 application
authentication to connect to Azure AI Foundry and Azure DevOps. Grant the
app identity the required resource permissions, and preserve the caller's
Rayfin data policies when using ctx.getDataClient().

Kimlik ve dağıtım detayları için Fonksiyonları Kullan ve Fonksiyonları harici kaynaklara bağlama bölümüne bakın.

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: