# 部署管道配置

您通过导入包含 YAML 配置文件的 ZIP 文件来部署管道配置。您可以使用 UI 或导入 API 来创建新项目或更新现有项目。两者都支持精简 YAML 和传统 JSON 格式。

使用版本控制时，您可以提交更改并执行从远程应用以将其获取到Qlik Talend Data Integration。

## 在开始之前

导入之前:

* 验证 YAML 文件中引用的所有连接都存在于目标空间中。YAML 文件中的连接名称必须完全匹配。

* 如果管道包含跨项目引用，例如，一个管道任务从另一个项目中的一个登陆任务读取数据，请首先导入上游项目。

* 验证配置文件以确认没有错误。请参阅[验证管道配置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)。

## 从用户界面导入

### 创建新项目

从配置文件创建新项目：

1. 在数据集成 > 流水线项目中，单击新建。

2. 选择导入项目。

3. 选择目标空间。

4. 上传包含配置的 ZIP 文件。

5. 单击搭配。

如果导入成功，项目将打开。如果存在错误，将显示验证消息列表。更正配置文件中的错误，然后重试。

### 更新现有项目

要使用新配置更新现有项目：

1. 在数据集成 > 管道项目中，单击项目上的the 导入 icon，然后选择。

2. 上传包含更新配置的 ZIP 文件。

3. 单击搭配。

信息注释导入配置会用 YAML 文件中的值覆盖当前项目设置。导入文件中不存在的设置，如果您以最小化格式导出，则保持不变；如果您以完整格式导出，则重置为默认值。

## 使用 API 导入

导入 API 接受一个 ZIP 文件和目标空间 ID。成功时返回更新后的项目，如果验证失败则返回错误列表。

导入 API 支持 YAML（最小化或完整）和旧版 JSON 导出。您无需在导入前转换现有的 JSON 导出文件。

提示注释在 CI/CD 流水线中，在 Import API 之前使用 Validate-project-definitions API，以区分验证失败和部署失败。请参阅[验证管道配置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)。

## 从版本控制应用更改

如果项目已连接到版本控制储存库，您可以直接从项目中应用远程更改。当您应用更改时，Qlik Talend Data Integration 会读取已连接分支中的当前 YAML 文件并导入它们。

验证在更改应用之前运行。如果出现错误，您会收到与手动导入相同的错误消息。

有关设置版本控制的详细信息，请参阅 [使用版本控制管理您的管道项目](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm)。

## 处理导入错误

当导入失败时，Qlik Talend Data Integration 会返回一个验证错误列表。每个错误都包含错误类型以及发现问题的文件或属性的路径。

每次导入最多返回 50 个错误。修复报告的错误并重新导入以检查其他问题。

有关每种错误类型及其解决方法，请参阅[验证管道配置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)。

## 相关主题

* [验证管道配置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

* [检索和编辑管道配置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

* [导出和导入数据管道](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm)