Управление ветками в пространствах Microsoft Fabric

Цель этой статьи — представить разработчикам Fabric различные варианты создания процессов CI/CD в Fabric на основе распространенных сценариев клиента. В этой статье основное внимание уделяется части процесса CI/CD, касающейся непрерывной интеграции (CI). Обсуждение части непрерывной доставки (CD) см. в разделе "Управление конвейерами развертывания".

В этой статье описано несколько различных вариантов интеграции, но многие организации используют их сочетание.

Предварительные условия

Чтобы интегрировать Git с рабочей областью Microsoft Fabric, необходимо настроить следующие предварительные требования для Fabric и Git.

Предварительные условия для Fabric

Для доступа к функции интеграции Git требуется емкость Fabric. Чтобы использовать все поддерживаемые элементы системы Fabric, требуется её емкость. Если у вас еще нет пробной версии, зарегистрируйтесь на бесплатную пробную версию. Клиенты, у которых уже есть емкость Power BI Premium, могут использовать такую емкость, но помните, что некоторые номера SKU Power BI поддерживают только элементы Power BI.

Кроме того, на портале администрирования необходимо включить следующие коммутаторы клиента :

• Пользователи могут создавать элементы Fabric
• Пользователи могут синхронизировать элементы рабочей области с репозиториями Git
• Создайте рабочую область (только если вы хотите перейти в новую рабочую область.)
• Пользователи могут синхронизировать элементы рабочей области с репозиториями GitHub: только для пользователей GitHub

Эти параметры можно включить администратором клиента, администратором емкости или администратором рабочей области в зависимости от параметров вашей организации.

Предварительные требования Git

Интеграция Git в настоящее время поддерживается для Azure DevOps и GitHub. Чтобы использовать интеграцию Git с рабочей областью Fabric, вам потребуется следующее в Azure DevOps или GitHub:

Процесс разработки

Рабочая область Fabric — это общая среда, которая имеет доступ к активным элементам. Любые изменения, внесенные непосредственно в рабочую область, переопределяются и влияют на всех других пользователей рабочей области. Поэтому лучшая практика работы с Git для разработчиков - это трудиться в изоляции, за пределами общих рабочих областей. Разработчик может работать в своей защищенной рабочей области двумя способами.

• Разработка с помощью клиентских средств, таких как Power BI Desktop для отчетов и семантических моделей, или VS Code для записных книжек.
• Разработка в отдельной рабочей области Fabric. У каждого разработчика есть собственная рабочая область, в которой они подключают отдельную ветвь, синхронизируют содержимое с этой рабочей областью, а затем фиксируют ее в ветви.

Чтобы работать с филиалами с помощью интеграции Git, сначала подключите рабочую область группы разработки к одной общей ветви. Например, если ваша команда использует одну общую рабочую область, подключите ее к главной ветви в репозитории команды и синхронизируйте их между рабочей областью и репозиторием. Если рабочий процесс вашей команды содержит несколько общих ветвей, таких как Dev/Test/Prod , каждая ветвь может быть подключена к другой рабочей области.

Затем каждый разработчик может выбрать изолированную среду, в которой нужно работать.

Сценарий 1. Разработка с помощью клиентских средств

Если элементы, которые вы разрабатываете, доступны в других средствах, вы можете работать с этими элементами непосредственно в клиентском средстве. Не все элементы доступны в каждом инструменте. Элементы, доступные только в Fabric, необходимо разрабатывать в ней.

Рабочий процесс для разработчиков, использующих клиентское средство, например Power BI Desktop, должен выглядеть примерно так:

1. Клонируйте репозиторий на локальный компьютер. (Этот шаг нужно выполнить только один раз.)

2. Откройте проект в Power BI Desktop с помощью локальной копии PBIProj.

3. Внесите изменения и сохраните обновленные файлы локально. Закоммитить в локальный репозиторий.

4. Когда все готово, отправьте ветку и коммиты в удаленный репозиторий.

5. Проверьте изменения в других элементах или на наличие дополнительных данных. Чтобы протестировать изменения, подключите новую ветвь к отдельной рабочей области и загрузите семантическую модель и отчеты, используя кнопку «update all» на панели контроля версий. Перед слиянием в основную ветвь выполните любые тесты или внесите изменения в конфигурацию.

   Если в рабочей области не требуются тесты, разработчик может объединить изменения непосредственно в основную ветвь без необходимости в другой рабочей области.

6. После объединения изменений рабочей области общей команды будет предложено принять новый коммит. Изменения обновляются в общей рабочей области, и все могут видеть изменения этих семантических моделей и отчетов.

Инструкции по использованию нового формата файла Power BI Desktop в Git см. в формате исходного кода.

Сценарий 2. Разработка в другой рабочей области

Для разработчика, который работает в Интернете, поток будет следующим образом:

1. На вкладке "Ветви" меню "Управление исходным кодом" выберите "Создать ветку в другом рабочем пространстве".

   

2. Укажите, хотите ли вы создать новую рабочую область или переключиться на существующую. Укажите имена новой ветви и рабочей области или выберите существующую рабочую область из раскрывающегося списка. При выходе из рабочей области все элементы, которые не сохраняются в Git, могут потеряться. Рекомендуется зафиксировать все элементы, которые необходимо сохранить перед ветвлением.

   

3. Выберите «Разветвиться».

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

   Рабочая область синхронизируется с фича-веткой и становится изолированной средой для работы, как показано. Теперь вы можете работать в этой новой изолированной среде. Синхронизация может занять несколько минут. Для получения дополнительной информации о расширении см. советы по устранению неполадок.

   

4. Сохраните изменения и зафиксируйте их в ветви компонентов.

5. Когда будет готово, создайте PR-запрос в главную ветвь. Процессы проверки и слияния выполняются с помощью Azure Repos на основе конфигурации, определенной командой для этого репозитория.

После завершения проверки и слияния создается новый коммит в главной ветке. Эта фиксация предложит пользователю обновить содержимое в рабочей области команды разработки с объединенными изменениями.

Дополнительные сведения см. в разделе об ограничениях ветвления.

Процесс выпуска

Процесс выпуска начинается после завершения процесса pull request и слияния с общей ветвью команды (например, Main, Dev и так далее). С этого момента существуют различные варианты создания процесса выпуска в Fabric. Дополнительную информацию о различных вариантах, которые следует учитывать при проектировании вашего рабочего процесса, см. в разделе процесса выпуска .

Переключите ветви

Если рабочая область подключена к ветви Git и вы хотите переключиться на другую ветвь, вы можете сделать это быстро из области управления версиями без отключения и повторного подключения.
Когда вы переключаете ветви, рабочая область синхронизируется с новой ветвью, и все элементы в рабочей области заменяются. Если в каждой ветви есть разные версии одного и того же элемента, замените его. Если элемент находится в старой ветви, но не новый, он удаляется. Чтобы переключиться между ветвями, выполните следующие действия.

1. На вкладке "Ветви" меню "Система управления версиями" выберите "Смена ветви".

   

2. Укажите ветвь, к которой нужно подключиться или создать новую ветвь. Эта ветвь должна содержать тот же каталог, что и текущая ветвь.

3. Выберите "Переключить ветвь".

Вы не можете переключать ветви, если в рабочей области есть незафиксированные изменения. Нажмите кнопку "Отмена" , чтобы вернуться и зафиксировать изменения перед переключением ветвей.

Чтобы подключить текущую рабочую область к новой ветви при сохранении существующего состояния рабочей области, выберите "Проверить новую ветвь". Дополнительные сведения о проверке новой ветви см. в разделе "Устранение конфликтов" в Git.

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

• Устранение ошибок и конфликтов
• Рекомендации по интеграции с Git