配置 Artifactory

配置Artifactory儲存庫管理員將建置工件儲存在Artifactory儲存庫 (repo) 中。

如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 Artifactory。
如果您有一個工具鏈並且要向其中添加此工具集成，請從IBM Cloud控制台單擊菜單圖標>平台自動化>工具鏈。在工具鏈頁面上，按一下工具鏈以開啟其概述頁面。或者，在應用程式之「概觀」頁面的「持續交付」卡片上，按一下檢視工具鏈。然後，按一下概觀。

a. 點選新增工具。

b. 在「工具整合」區段中，按一下 Artifactory。
鍵入當您按一下 Artifactory 卡片時所要開啟的 Artifactory 儲存庫 URL。
選取您要連接的儲存庫類型。
如果您使用的是 Artifactory npm 登錄，請遵循下列步驟：

a. 鍵入與您的登錄相關聯的電子郵件位址。

b. 鍵入與您的登錄相關聯的鑑別記號。

c. 鍵入 Artifactory 版本儲存庫的 URL，這是您在 Artifactory 伺服器上的專用登錄。

d. 鍵入您用來結合多個公用及專用 npm 登錄的「鏡映」或「公用」登錄 URL。例如，此 URL 可能是 Artifactory 伺服器上可存取專用登錄及 npm 廣域登錄快取的虛擬登錄 URL。
如果您使用的是 Artifactory Maven 儲存庫，請遵循下列步驟：

a. 鍵入與您的儲存庫相關聯的使用者 ID。

b. 鍵入與您的儲存庫相關聯的密碼。

c. 鍵入 Artifactory 版本儲存庫的 URL，這是您在 Artifactory 伺服器上的專用版本儲存庫。

d. 鍵入 Artifactory Snapshot 儲存庫的 URL，這是您在 Artifactory 伺服器上的專用 Snapshot 儲存庫。

e. 鍵入您用來結合多個公用及專用 Maven 儲存庫的「鏡映」或「公用」儲存庫 URL。例如，此 URL 可能是 Artifactory 伺服器上可存取專用儲存庫及 Maven 中央儲存庫快取的虛擬儲存庫 URL。
按一下建立整合。
在 協力廠商工具 卡上，按一下您要使用之 Artifactory 儲存庫的 Artifactory 工具整合。即會開啟 Artifactory 網站，您可以在其中檢視儲存庫的內容。
選用項目：如果您是在「IBM Cloud 公用」上使用工具鏈，並且想要透過搭配使用 Artifactory 與 npm 來建置應用程式，請配置管線來新增 npm 建置工作。如需配置建置工作的指示，請參閱在管線中配置 Artifactory npm 建置工作一節。
選用項目：如果您是在「IBM Cloud 公用」上使用工具鏈，並且想要透過搭配使用 Artifactory 與 Maven 來建置應用程式，請配置管線來新增 Maven 建置工作。如需配置建置工作的指示，請參閱在管線中配置 Artifactory Maven 建置工作一節。

在管線中配置 Artifactory npm 建置工作

您必須具有可使用建置 SCM 儲存庫作為輸入的可運作管線，然後才能在管線中配置 npm 建置工作。您也必須為工具鏈配置 Artifactory。如需配置 Artifactory 的指示，請參閱 Artifactory 一節。

配置 Delivery Pipeline 來新增 npm 建置工作：

建立階段，並設定適當 SCM 儲存庫的輸入。
在此階段上，新增建置工作。
配置建置工作:

npm 建置作業

a. 針對建置器類型，選取 NPM 建置。

b. 如果您已配置多個 Artifactory 工具整合實例，請輸入您要為其配置 npm 建置工作之 Artifactory 工具整合的名稱。

c. 針對工具整合類型，選取 Artifactory。

d. 針對建置指令，輸入指令來建置 npm 模組或將它發佈至登錄。此範例顯示用來建置或發佈模組的指令。
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
您可以在 Artifactory 工具整合的配置設定中，找到用來連接至登錄的 URL 及使用者認證。

e. 如果您的建置工作發佈至 Artifactory 登錄，而且 Node 模組版本的格式為 x.y.z-SNAPSHOT.w，請選取增加 Snapshot 模組版本勾選框。建置工作會自動更新模組版本，然後才將工作發佈至 Artifactory 登錄。工作會從 npm 登錄及本端 package.json 檔案中選取最高版本的模組，並使用 semver 來增加模組版本。建置工作不會將變更遞送至 SCM 儲存庫。
按一下儲存。只要管線執行，此建置工作就會使用 Artifactory 工具整合中的配置資訊來連接至 npm 登錄。

在管線中配置 Artifactory Maven 建置工作

您需要有可使用建置 SCM 儲存庫作為輸入的可運作管線，而且必須為工具鏈配置 Artifactory，然後才能在管線中配置 Maven 建置工作。如需配置 Artifactory 的指示，請參閱 Artifactory 一節。

配置 Delivery Pipeline 來新增 Maven 建置工作：

建立階段，並設定適當 SCM 儲存庫的輸入。
在此階段上，新增建置工作。
配置建置工作:

Maven 建置作業

a. 針對建置器類型，選取 Maven 建置。

b. 如果您已配置多個 Artifactory 工具整合實例，請輸入您要為其配置 Maven 建置工作之 Artifactory 工具整合的名稱。

c. 針對工具整合類型，選取 Artifactory。

d. 針對建置指令，輸入指令來建置 Maven 模組或將它發佈至 Snapshot 登錄。此範例顯示用來建置模組或將它發佈至 Snapshot 登錄的指令。
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
您可以在 Artifactory 工具整合的配置設定中，找到用來連接至登錄的 URL 及使用者認證。
按一下儲存。只要管線執行，此建置工作就會使用 Artifactory 工具整合中的配置資訊來連接至 Maven 儲存庫。

使用 API 來配置 Artifactory

當您建立、讀取及更新工具整合時，Artifactory 工具整合支援下列配置參數，可與 Toolchain HTTP API 及 SDK 搭配使用。

您必須在要求內文中以 artifactory 值指定 tool_type_id 內容。

Artifactory工具整合參數
參數	用法	類型	Terraform 引數	說明
dashboard_url	選用，可更新	字串	dashboard_url	此工具整合的 Artifactory 伺服器儀表板 URL。在圖形使用者介面中，當您按一下 Artifactory 工具整合卡時，瀏覽器會移至這個儀表板。
mirror_url	選用，可更新	字串	mirror_url	Artifactory 虛擬儲存庫的 URL，您可以在其中檢視專用儲存庫及公用儲存庫的快取。
名稱	必要，可更新	字串	名稱	此工具整合的名稱。
release_url	選用，可更新	字串	release_url	Artifactory 版本儲存庫的 URL。
repository_name	選用，可更新	字串	repository_name	Docker 映像檔所在 Artifactory 儲存庫的名稱。
repository_url	選用，可更新	字串	repository_url	Docker 映像檔所在 Artifactory 儲存庫的 URL。
snapshot_url	選用，可更新	字串	snapshot_url	Artifactory Snapshot 儲存庫的 URL。
記號	選用，可更新	密碼	記號	Artifactory 儲存庫的存取記號。您可以對此參數使用工具鏈密鑰參照。如需工具鏈密鑰參照的相關資訊，請參閱在 Continuous Delivery。
類型	必要，可更新	字串	類型	Artifactory 工具整合的儲存庫類型。
user_id	選用，可更新	字串	user_id	Artifactory 儲存庫的使用者 ID 或電子郵件位址。