# 部署管道組態

您可以透過匯入包含 YAML 組態檔案的 ZIP 檔案來部署管道組態。您可以使用 UI 或匯入 API 來建立新專案或更新現有專案。兩者都接受最小化 YAML 和舊版 JSON 格式。

當使用版本控制時，您可以提交您的變更並執行從遠端套用以將其納入Qlik Talend Data Integration。

## 開始之前

匯入之前:

* 驗證在 YAML 檔案中參考的所有連線都存在於目標空間中。YAML 檔案中的連線名稱必須完全相符。

* 如果管道包含跨專案參考，例如，一個管道任務從另一個專案中的一個登陸任務讀取，請先匯入上游專案。

* 驗證組態檔以確認沒有錯誤。請參閱 [驗證管道組態](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm).

## 從使用者介面匯入

### 建立新的專案

若要從組態檔建立新專案：

1. 在Data Integration > Pipeline projects中，按一下Create new。

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-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm).

## 從版本控制套用變更

如果專案已連線到版本控制存放庫，您可以直接從專案套用遠端變更。當您套用變更時，Qlik Talend Data Integration 會從已連線的分支讀取目前的 YAML 檔案並匯入。

驗證會在變更套用之前執行。如果發生錯誤，您會收到與手動匯入相同的錯誤訊息。

如需設定版本控制的詳細資訊，請參閱[使用版本控制管理您的管道專案](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm)。

## 處理匯入錯誤

當匯入失敗時，Qlik Talend Data Integration 會傳回驗證錯誤清單。每個錯誤都包含錯誤類型以及發現問題的檔案或屬性路徑。

每次匯入嘗試最多會回報 50 個錯誤。修正回報的錯誤並重新匯入，以檢查是否有其他問題。

如需每種錯誤類型及其解決方法的說明，請參閱[驗證管道組態](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)。

## 相關主題

* [驗證管道組態](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

* [擷取和編輯管道設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

* [匯出並匯入資料管道](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm)