配置 Artifactory

DevOps Insights 將於 2026 年 8 月 31 日結束服務並停止提供。Continuous Delivery 將於 2027 年 2 月 12 日在以下地區停止提供：au-syd、ca-mon、ca-tor、us-east。 Code Risk Analyzer 也將於該日於所有地區停止提供服務。若某個區域未實際使用這些功能，該區域中的功能可能會提前停用，並停止接受新的實例。了解更多

設定 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 整合支援下列配置參數，您可在建立、讀取及更新工具整合時，透過工具鏈 HTTP API 與 SDK 使用這些參數。

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

Artifactory工具整合參數
參數	用法	類型	Terraform 引數	說明
dashboard_url	選用，可更新	字串	dashboard_url	此工具整合的 Artifactory 伺服器 URL 儀表板。在圖形化使用者介面中，當您點擊工具 Artifactory 整合卡片時，瀏覽器會跳轉至此儀表板。
鏡像網址	選用，可更新	字串	鏡像網址	您的 Artifactory 虛擬儲存庫 URL，您可在其中檢視私人儲存庫及公共儲存庫的快取。
名稱	必要，可更新	字串	名稱	此工具整合的名稱。
發佈網址	選用，可更新	字串	發佈網址	您的 Artifactory 釋出儲存庫的 URL
儲存庫名稱	選用，可更新	字串	儲存庫名稱	Docker 映像檔所在 Artifactory 儲存庫的名稱。
儲存庫網址	選用，可更新	字串	儲存庫網址	存放您 Docker 圖像的 Artifactory 儲存庫 URL 路徑。
快照網址	選用，可更新	字串	快照網址	您的 Artifactory 快照儲存庫的 URL
記號	選用，可更新	密碼	記號	Artifactory 儲存庫的存取記號。您可以對此參數使用工具鏈密鑰參照。如需工具鏈密鑰參照的相關資訊，請參閱在 Continuous Delivery。
類型	必要，可更新	字串	類型	Artifactory 工具整合的儲存庫類型。
user_id	選用，可更新	字串	user_id	Artifactory 儲存庫的使用者 ID 或電子郵件位址。