Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Узнайте, как конвейеры интеграции и развертывания Git работают с API для GraphQL в Microsoft Fabric. В этой статье показано, как настроить подключение к репозиторию, управлять API для GraphQL и развертывать их в разных средах.
Замечание
API для системы контроля версий GraphQL и развертывания в настоящее время находится в предварительной версии.
Предпосылки
- Для работы в Fabric вам необходим API для GraphQL. Дополнительные сведения см. в статье Создание API для GraphQL в Fabric и добавление данных.
Обзор
Fabric предлагает мощные инструменты для CI/CD (непрерывная интеграция и непрерывное развертывание) и управления жизненным циклом разработки с помощью двух основных компонентов: интеграции Git (CI) и конвейеров развертывания (CD). Рабочие области служат центральными компонентами для этапов синхронизации и развертывания Git.
Интеграция Git (CI): синхронизирует элементы рабочей области (например, код, конфигурации, API) с репозиториями управления версиями, что позволяет управлять версиями и отслеживать изменения с помощью Git.
Конвейеры развертывания (CD): включает создание этапов (например, разработка, тестирование, производство) с связанными рабочими областями. Элементы, поддерживаемые на каждом этапе, автоматически реплицируются на последующие этапы, а изменения в рабочей области запускают развертывание в процессе выпуска. Конвейер можно настроить, чтобы убедиться, что изменения тестируются и развертываются эффективно в разных средах.
Fabric поддерживает различные рабочие процессы CI/CD, адаптированные к общим сценариям. Дополнительные сведения см. в разделе "Параметры рабочего процесса CI/CD" в Fabric.
Замечание
Во время развертывания копируются только метаданные; и данные не копируются.
Элементы рабочей области хранятся в ассоциированном репозитории Git как Инфраструктура как код (Infrastructure as Code, IaC). Изменения кода в репозитории могут активировать развертывание в конвейерах. Этот метод позволяет автоматически реплицировать изменения кода на этапах тестирования и выпуска рабочей среды.
Методы проверки подлинности источника данных
В этом разделе описаны методы проверки подлинности для подключения источников данных к API для GraphQL и их влияние на автоматическое связывание между API для GraphQL и подключенными источниками данных в конвейерах разработки. Дополнительные сведения об автоматической привязке можно узнать в процессе конвейера развертывания.
Существует два варианта подключения источников данных к API для GraphQL:
Подключение к источникам данных Fabric с аутентификацией SSO
Подключение к Fabric или внешним источникам данных с использованием сохраненных учетных данных
Первый вариант, single Sign-On (SSO) позволяет подключаться к источникам данных в Fabric. В этом случае при подключении источника данных к GraphQL с помощью метода единого входа в исходную рабочую область (например, этап разработки) источник данных и элемент GraphQL будут развернуты в целевой рабочей области (например, этап тестирования), а GraphQL в целевой рабочей области будет автоматически подключен к развернутму локальному источнику данных в целевой рабочей области (см. схему ниже). Существуют определенные ограничения при использовании единого входа и подключении к источнику данных через конечную точку аналитики SQL, дополнительные сведения см. в статье **Текущие ограничения.
Второй вариант, сохраненные учетные данные, позволяет подключаться к внешним источникам данных за пределами Fabric и источников данных в Fabric. Однако автоматическая привязка не поддерживается для подхода "Сохраненные учетные данные". Это означает, что при подключении источника данных к GraphQL с помощью сохраненных учетных данных в исходной рабочей области (этап разработки) источник данных будет развернут в целевой рабочей области (этап тестирования) в конвейере. Однако элемент GraphQL в целевой рабочей области будет оставаться подключенным к источнику данных в исходной рабочей области (этап разработки) через сохраненные учетные данные, а не автоматически привязывать к локальному источнику данных в целевой рабочей области. (см. схему ниже)
Кроме того, если для подключения к источникам данных используется метод сохраненных учетных данных , разработчики должны иметь доступ к сохраненным учетным данным, чтобы успешно развернуть элемент GraphQL.
Замечание
Если API для GraphQL в исходной рабочей области (этап разработки) подключен к источнику данных, который находится в другой рабочей области, развернутый API для GraphQL в целевой рабочей области (этап тестирования) останется подключенным к источнику данных, расположенному в другой рабочей области независимо от того, какой метод проверки подлинности используется для подключения источников данных к API для GraphQL. (см. схему ниже)
API для интеграции Git с GraphQL
API Fabric для GraphQL предлагает интеграцию Git для управления версиями. Интеграция с Git позволяет создавать резервные копии и версии API для GraphQL, возвращаться на предыдущие этапы по мере необходимости, работать в одиночку с помощью ветвей Git и управлять API для жизненного цикла GraphQL полностью в Fabric.
Настройка подключения:
В параметрах рабочей области можно легко настроить подключение к репозиторию для фиксации и синхронизации изменений. Сведения о настройке подключения см. в статье "Начало работы с интеграцией Git". После подключения элементы, включая API для GraphQL, отображаются на панели управления версиями .
После успешной фиксации API для экземпляров GraphQL в репозитории Git вы увидите структуру папок GraphQL в репозитории. Теперь можно выполнять будущие операции, такие как создание pull request.
Представление GraphQL в Git:
Ниже приведен пример структуры файлов каждого API для элемента GraphQL в репозитории Git:
При закоммитите элемента API для GraphQL, определение API для GraphQL сохраняется в репозитории Git. Этот подход поддерживает точное восстановление при синхронизации с рабочей областью Fabric:
Дополнительные сведения о формате определения API GraphQL, синтаксисе и примерах см. в документации по API уровня управления Fabric:
API для GraphQL в потоке развертывания
Выполните следующие действия, чтобы завершить развертывание API для GraphQL с помощью конвейера развертывания.
Создайте новый конвейер развертывания или откройте существующий конвейер развертывания. Для получения дополнительной информации см. Начало работы с конвейерами развертывания.
Распределите рабочие пространства по различным этапам в соответствии с целями развертывания.
Выберите, просматривайте и сравнивайте элементы, включая API для GraphQL между разными этапами, как показано в следующем примере. Выделенные области, указывающие количество измененных элементов между предыдущим этапом и текущим этапом.
- Выберите элементы, которые необходимо развернуть. Выберите "Развернуть", чтобы развернуть выбранные элементы (API для GraphQL и его подключенный источник данных) на этапах разработки, тестирования и производственной стадии.
Следующее сообщение появляется, подтверждая элементы, которые вы собираетесь развернуть. Выберите "Развернуть" , чтобы подтвердить и продолжить процесс развертывания.
Текущие ограничения
Fabric CI/CD не поддерживает автоматическую привязку дочерних элементов. Это означает, что если API для GraphQL подключается к узлу SQL Analytics как дочерний элемент источника данных в исходной рабочей области (например, на этапе разработки), то линейка не передается в целевую рабочую область (например, на этапе тестирования). В результате развернутый API для GraphQL в целевой рабочей области (например, этап тестирования) остается подключенным к конечной точке аналитики SQL в исходной рабочей области (например, этап разработки).
Автоматическая привязка не поддерживается, если для подключений к источнику данных используется подход "Сохраненные учетные данные ". Дополнительные сведения см. в разделе методов проверки подлинности источника данных , описанных выше.