Краткое руководство. Запуск примера рабочей нагрузки (предварительная версия)

  • Статья

В этом кратком руководстве показано, как создать и запустить рабочую нагрузку Microsoft Fabric с помощью примера рабочей нагрузки.

Необходимые компоненты

Прежде чем начать, убедитесь, что в системе установлено следующее:

Пошаговое руководство

Включение пользовательских рабочих нагрузок

Настройте портал администрирования следующим образом:

  1. Войдите в Fabric с учетной записью администратора .

  2. В разделе "Параметры" перейдите на портал администрирования.

    Снимок экрана, показывающий, как добраться до портала администрирования Fabric.

  3. В разделе "Дополнительные рабочие нагрузки( предварительная версия) включите администраторы емкости и участники могут добавлять и удалять дополнительные параметры клиента рабочих нагрузок. Его можно включить для всей организации или определенных групп.

Настройка примера проекта

  1. Клонирование репозитория: клонирование репозитория, найденного здесь: Пример каталога проекта

  2. Установите зависимости: перейдите к каталогу Frontend в клонированного репозитория и выполните следующую команду:

    npm install

  3. Запустите локальный сервер: запустите локальный сервер Node.js с помощью webpack :

    npm start

    Сервер обычно выполняется через порт 60006. Убедитесь, что сервер работает с помощью доступа 127.0.0.1:60006/manifests и проверки файла конфигурации env.dev в папке внешнего интерфейса.

  4. Включите режим внешнего разработчика: в параметрах клиента на портале администрирования в разделе "Дополнительные рабочие нагрузки ( предварительная версия) и активировать администраторы емкости могут разрабатывать дополнительные рабочие нагрузки. Этот параметр позволяет подключаться к локальному серверу и сохраняться в сеансах браузера.

Запуск примера рабочей нагрузки

После запуска локального сервера и включения режима разработчика в меню появится новая примерная рабочая нагрузка.

  1. Доступ к образцу рабочей нагрузки. Чтобы начать создание , перейдите на домашнюю страницу примера рабочей нагрузки.

Подготовка среды разработки

  1. Клонируйте шаблон: Клонируйте проект шаблонов, найденный здесь: Пример каталога проекта

  2. Откройте решение: откройте решение в Visual Studio 2022 , чтобы обеспечить совместимость с net7.

  3. Регистрация приложений. Выполните инструкции по проверке подлинности Microsoft Entra ID для безопасного взаимодействия в архитектуре.

  4. Обновите базовый URL-адрес OneLake DFS: измените EnvironmentConstants.cs файл в папке src/Constants/ , чтобы он соответствовал вашей среде.

  5. Настройка параметров рабочей нагрузки: обновление src/Config/workload-dev-mode.json и src/appsettings.json использование конкретных сведений о конфигурации:

    • Скопируйте workload-dev-mode.json из src/Config C:\ и обновите следующие поля, чтобы соответствовать конфигурации:

    Примечание.

    Его можно скопировать в любой другой путь и настроить аргумент командной строки "-DevMode:LocalConfigFilePath" в проекте, чтобы указать путь.

    • CapacityGuid: идентификатор емкости можно найти на портале Fabric в разделе "Параметры емкости" портала администрирования.

    • ManifestPackageFilePath: расположение пакета манифеста. При сборке решения он сохраняет пакет манифеста в src\bin\Debug. Дополнительные сведения о пакете манифеста можно найти на последующих шагах.

    • WorkloadEndpointURL: URL-адрес конечной точки рабочей нагрузки.

    • В файле src/appsettings.json обновите следующие поля, чтобы соответствовать конфигурации:

      • PublisherTenantId: идентификатор клиента издателя рабочей нагрузки.
      • ClientId: идентификатор клиента (AppID) рабочей нагрузки приложения Microsoft Entra.
      • ClientSecret: секрет для приложения Microsoft Entra рабочей нагрузки.
      • Аудитория: аудитория входящих токенов Microsoft Entra можно найти в регистрации приложения, созданной в разделе "Предоставление API". Это также называется URI идентификатора приложения.

  6. Настройте файл WorkloadManifest.xml: настройте файл WorkloadManifest.xml со следующими сведениями о приложении Microsoft Entra:

    • AppID
    • ResourceID
    • URI перенаправления

  7. Создайте пакет манифеста: создайте решение для создания файла пакета манифеста, который включает проверку и упаковку необходимых XML-файлов и JSON.

    • Триггер Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe на workloadManifest.xml в пакетах\manifest\files\ (код процесса проверки можно найти в каталоге \workloadManifestValidator). Если проверка завершается ошибкой, создается файл ошибки, указывающий неудачную проверку.
    • Если файл ошибки существует, сборка завершается ошибкой "Ошибка проверки WorkloadManifest". Вы можете дважды щелкнуть ошибку в VS Studio и открыть файл ошибки.
    • После успешной проверки упаковайте файлы WorkloadManifest.xml и FrontendManifest.json в ManifestPackage.1.0.0.nupkg. Полученный пакет можно найти в src\bin\Debug.

    Скопируйте файл ManifestPackage.1.0.0.nupkg в путь, определенный в файле конфигурации workload-dev-mode.json.

  8. Запустите DevGateway: выполните команду "Microsoft.Fabric.Workload.DevGateway.exe" и выполните проверку подлинности в качестве администратора емкости.

  9. Запустите проект: задайте проект "Стандартный" в качестве запускаемого проекта в Visual Studio и запустите его.

Дополнительные действия

  • При необходимости обновите файлы конфигурации рабочей нагрузки.
  • Создайте решение, чтобы убедиться, что все зависимости связаны правильно.
  • Запустите интерфейс и devgateway, чтобы установить связь с серверной частью Fabric.
  • Создайте элементы и запустите задания, чтобы проверить все возможности рабочей нагрузки.

Связанный контент