# Развертывание конфигурации конвейера

Конфигурацию конвейера можно развернуть путем импорта ZIP-файла, содержащего файлы конфигурации YAML. Вы можете использовать пользовательский интерфейс или API импорта для создания новых проектов или обновления существующих. Оба принимают минимизированный YAML и устаревший формат JSON.

При использовании системы контроля версий вы можете зафиксировать свои изменения и выполнить Применить из удаленного, чтобы получить их в Qlik Talend Data Integration.

## Перед началом работы

Перед импортом:

* Проверьте, что все подключения, упомянутые в файлах YAML, существуют в целевом пространстве. Имена подключений в файле YAML должны совпадать точно.

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

* Проверьте файлы конфигурации, чтобы убедиться в отсутствии ошибок. См. [Проверка конфигурации конвейера](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm).

## Импорт из UI

### Создание нового проекта

Чтобы создать новый проект из файла конфигурации:

1. В разделе Интеграция данных > Проекты конвейера, нажмите Создать новый.

2. Выберите Импорт проекта.

3. Выберите целевое пространство.

4. Загрузите ZIP-файл, содержащий конфигурацию.

5. Щелкните Импорт.

Если импорт успешен, проект открывается. Если есть ошибки, отображается список сообщений валидации. Исправьте ошибки в ваших файлах конфигурации и повторите попытку.

### Обновление существующего проекта

Чтобы обновить существующий проект с новой конфигурацией:

1. Выберите Интеграция данных > Проекты конвейеров, щелкните the More icon на проекте и выберите Импорт.

2. Загрузите ZIP-файл, содержащий обновленную конфигурацию.

3. Щелкните Импорт.

Примечание к информацииИмпорт конфигурации перезаписывает текущие настройки проекта значениями из файлов YAML. Настройки, отсутствующие в импортированных файлах, остаются без изменений, если вы экспортировали в минимизированном формате, или сбрасываются до значений по умолчанию, если вы экспортировали в полном формате.

## Импорт с использованием API

API импорта принимает ZIP-файл и идентификатор целевого пространства. Он возвращает обновленный проект в случае успеха или список ошибок, если проверка не удалась.

API импорта поддерживает как экспорты YAML (минимизированные или полные), так и устаревшие экспорты JSON. Не нужно преобразовывать существующие экспорты JSON перед импортом.

Примечание к подсказкеИспользуйте API Validate-project-definitions перед API импорта в конвейерах CI/CD, чтобы отделить сбои валидации от сбоев развертывания. См. [Проверка конфигурации конвейера](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm).

## Применение изменений из системы контроля версий

Если проект подключен к репозиторию системы контроля версий, вы можете применить удаленные изменения непосредственно из проекта. Когда вы применяете изменения, Qlik Talend Data Integration считывает текущие YAML-файлы из подключенной ветви и импортирует их.

Проверка выполняется до применения изменений. Если возникнут ошибки, вы получите те же сообщения об ошибках, что и при ручном импорте.

Подробные сведения о настройке системы управления версиями см. [Управление проектами конвейера с контролем версий](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm).

## Обработка ошибок импорта

При сбое импорта Qlik Talend Data Integration возвращает список ошибок валидации. Каждая ошибка включает тип ошибки и путь к файлу или свойству, где была обнаружена проблема.

До 50 ошибок возвращается за одну попытку импорта. Исправьте обнаруженные ошибки и повторно импортируйте, чтобы проверить наличие дополнительных проблем.

Описание каждого типа ошибки и способов ее устранения см. [Проверка конфигурации конвейера](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm).

## Связанные темы

* [Проверка конфигурации конвейера](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

* [Получение и редактирование конфигурации конвейера](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

* [Экспорт и импорт конвейеров данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm)