Hızlı başlangıç: İş yükü örneği çalıştırma (önizleme)

  • Makale

Bu hızlı başlangıç kılavuzu, örnek bir iş yükü kullanarak Microsoft Fabric iş yükü oluşturmayı ve çalıştırmayı gösterir.

Önkoşullar

Başlamadan önce, sisteminizde aşağıdakilerin yüklü olduğundan emin olun:

Adım adım kılavuz

Özel iş yüklerini etkinleştirme

Yönetici portalını aşağıdaki gibi yapılandırın:

  1. Bir Yönetici hesabıyla Doku'da oturum açın.

  2. Ayarlar'dan Yönetim portalına gidin.

    Doku Yöneticisi portalına nasıl ulaşacaklarını gösteren ekran görüntüsü.

  3. Ek iş yükleri (önizleme) bölümünde Kapasite yöneticilerinin ve katkıda bulunanların ek iş yükleri kiracı ayarı ekleyip kaldırabilmesini etkinleştirin. Tüm kuruluş veya belirli gruplar için etkinleştirebilirsiniz.

Örnek projeyi ayarlama

  1. Depoyu kopyalama: Burada bulunan depoyu kopyalayın: Örnek Proje Dizini

  2. Bağımlılıkları yükleme: Kopyalanan depodaki dizine Frontend gidin ve aşağıdaki komutu yürütür:

    npm install

  3. Yerel sunucuyu başlatma: Komutunu çalıştırarak webpack kullanarak yerel bir Node.js sunucusu başlatın:

    npm start

    Sunucu genellikle bağlantı noktasında 60006çalışır. Ön uç klasöründeki .env.dev yapılandırma dosyasına erişip 127.0.0.1:60006/manifests denetleyerek sunucunun çalışır durumda olduğunu onaylayın.

  4. Ön uç geliştirici modunu etkinleştirme: Yönetici portalındaki kiracı ayarlarında, Ek iş yükleri (önizleme) bölümünün altında kapasite yöneticileri ek iş yükleri geliştirebilir. Kiracı ayarı. Bu ayar, yerel sunucunuza bağlantılara izin verir ve tarayıcı oturumlarında kalıcı olarak kalır.

Örnek iş yükü çalıştırma

Yerel sunucu çalıştırıldıktan ve Geliştirici Modu etkinleştirildikten sonra, menüde yeni örnek iş yükü görüntülenir.

  1. Örnek iş yüküne erişme: Oluşturma deneyimini başlatmak için örnek iş yükü giriş sayfasına gidin.

Geliştirme ortamını hazırlama

  1. Ortak yapıyı kopyalama: Burada bulunan ortak projeyi kopyalayın: Örnek Proje Dizini

  2. Çözümü açın: Net7 ile uyumluluğu sağlamak için çözümü Visual Studio 2022'de açın.

  3. Uygulama kaydı: Mimari içindeki güvenli etkileşimler için Microsoft Entra ID kimlik doğrulamasını ayarlamak için kimlik doğrulama kılavuzunu izleyin.

  4. OneLake DFS temel URL'siniEnvironmentConstants.cs güncelleştirme: Klasördeki src/Constants/ dosyayı ortamınızla eşleşecek şekilde değiştirin.

  5. İş yükü ayarlarını yapılandırma: Ve'yi kendi yapılandırma ayrıntılarınızla güncelleştirin src/Config/workload-dev-mode.json src/appsettings.json :

    • src/Config'den C:\ workload-dev-mode.json kopyalayın ve aşağıdaki alanları yapılandırmanızla eşleşecek şekilde güncelleştirin:

    Not

    Bunu başka bir yola kopyalayabilir ve yolu belirtmek için projenizde "-DevMode:LocalConfigFilePath" komut satırı bağımsız değişkenini ayarlayabilirsiniz.

    • CapacityGuid: Kapasite kimliğiniz Doku portalında yönetici portalının Kapasite Ayarları altında bulunabilir.

    • ManifestPackageFilePath: Bildirim paketinin konumu. Çözümü oluşturduğunuzda, bildirim paketini src\bin\Debug içine kaydeder. Bildirim paketi hakkında daha fazla ayrıntıyı sonraki adımlarda bulabilirsiniz.

    • WorkloadEndpointURL: İş yükü uç noktası URL'si.

    • src/appsettings.json dosyasında aşağıdaki alanları yapılandırmanızla eşleşecek şekilde güncelleştirin:

      • PublisherTenantId: İş yükü yayımcısı kiracısının kimliği.
      • ClientId: Microsoft Entra uygulamasının iş yükünün İstemci Kimliği (AppID).
      • ClientSecret: İş yükü Microsoft Entra uygulamasının gizli dizisi.
      • Hedef kitle: Gelen Microsoft Entra belirteçleri için hedef kitle, oluşturduğunuz uygulama kaydınızda "API'yi kullanıma sunma" bölümünde bulunabilir. Bu, Uygulama Kimliği URI'si olarak da adlandırılır.

  6. WorkloadManifest.xml dosyasını yapılandırma: WorkloadManifest.xml dosyasını aşağıdaki Microsoft Entra uygulaması ayrıntılarıyla yapılandırın:

    • AppID
    • ResourceID
    • Yeniden YönlendirmeURI'si

  7. Bildirim paketi oluşturma: Gerekli XML ve JSON dosyalarını doğrulamayı ve paketlemeyi içeren bildirim paketi dosyasını oluşturmak için çözümü oluşturun.

    • Packages\manifest\files\ içindeki workloadManifest.xml Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe tetikleyin (doğrulama işleminin kodunu \workloadManifestValidator dizininde bulabilirsiniz). Doğrulama başarısız olursa, başarısız doğrulamayı belirten bir hata dosyası oluşturulur.
    • Hata dosyası varsa, derleme "WorkloadManifest doğrulama hatası" ile başarısız olur. VS Studio'da hataya çift tıklayarak hata dosyasını görebilirsiniz.
    • Doğrulama başarılı olduktan sonra WorkloadManifest.xml ve FrontendManifest.json dosyalarını ManifestPackage.1.0.0.nupkg içine paketle. Sonuçta elde edilen paket src\bin\Debug içinde bulunabilir.

    ManifestPackage.1.0.0.nupkg dosyasını workload-dev-mode.json yapılandırma dosyasında tanımlanan yola kopyalayın.

  8. DevGateway'i çalıştırın: 'Microsoft.Fabric.Workload.DevGateway.exe' yürütür ve kapasite yöneticisi olarak kimlik doğrulaması yapar.

  9. Projeyi Başlat: 'Ortak' projesini Visual Studio'da başlangıç projesi olarak ayarlayın ve çalıştırın.

Ek adımlar

  • İş yükü yapılandırma dosyalarını gerektiği gibi güncelleştirin.
  • Tüm bağımlılıkların doğru şekilde bağlandığından emin olmak için çözümü oluşturun.
  • Doku arka ucuyla iletişim kurmak için ön ucu ve geliştirmeyi çalıştırın.
  • İş yükünüzün tüm özelliklerini test etmek için öğeler oluşturun ve işleri çalıştırın.

İlgili içerik