配置 Nexus

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

設定 Nexus 儲存庫管理員，將建置產出儲存至您的 Nexus 儲存庫（repo）中。

  1. 如果您要在建立工具鏈時配置此工具整合，請按一下「可配置的整合」區段中的 Nexus。

  2. 若您已擁有工具鏈並欲將此工具整合至其中，IBM Cloud 請從控制台點擊選單圖示 （漢堡圖示 ）> 平台自動化 > 工具鏈。 在「工具鏈」頁面中，點擊該工具鏈以開啟其「概覽」頁面。

    a. 點擊「新增工具」。

    b. 在「工具整合」區段中，按一下 Nexus。

  3. 鍵入此 Nexus 工具整合實例的名稱。

  4. 鍵入當您從工具鏈按一下 Nexus 卡片時所要開啟的 Nexus 儲存庫 URL。

  5. 選取您要連接的儲存庫類型。

  6. 如果您已選取 npm 登錄，請遵循下列步驟：

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

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

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

    d. 鍵入您用來結合多個公用及專用 npm 登錄的「鏡映」或「公用」登錄 URL。 例如，此 URL 可能是 Nexus 伺服器上可存取專用登錄及 npm 廣域登錄快取的虛擬登錄 URL。

  7. 如果您已選取 Maven 儲存庫，請遵循下列步驟：

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

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

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

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

    e. 鍵入您用來結合多個公用及專用 Maven 儲存庫的「鏡映」或「公用」儲存庫 URL。 例如，此 URL 可能是 Nexus 伺服器上可存取專用儲存庫及 Maven 中央儲存庫快取的虛擬儲存庫 URL。

  8. 按一下建立整合。

  9. 從工具鏈的「概觀」頁面中，在 協力廠商工具 卡上，按一下您要使用的 Nexus 儲存庫。 即會開啟 Nexus 網站，您可以在其中檢視儲存庫的內容。

  10. 選用項目：如果您是在 IBM Cloud Public 上使用工具鏈，並且想要透過搭配使用 Nexus 與 npm 來建置應用程式，請配置管線來新增 npm 建置工作。 如需配置建置工作的指示，請參閱在管線中配置 Nexus npm 建置工作一節。

  11. 選用項目：如果您是在 IBM Cloud Public 上使用工具鏈，並且想要透過搭配使用 Nexus 與 Maven 來建置應用程式，請配置管線來新增 Maven 建置工作。 如需配置建置工作的指示，請參閱在管線中配置 Nexus Maven 建置工作一節。

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

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

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

  1. 建立階段，並設定適當 SCM 儲存庫的輸入。

  2. 在此階段上，新增建置工作。

  3. 配置建置工作:

    npm 建置作業
    npm 建置作業

    a. 對於建置器類型，請選取 npm（Artifactory 或 Nexus）。

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

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

    d. 針對建置指令，輸入指令來建置 npm 模組或將它發佈至登錄。 此範例顯示用來建置或發佈模組的指令。

    npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"

    您可以在 Nexus 工具整合的配置設定中，找到用來連接至登錄的 URL 及使用者認證。

    e. 如果您的建置工作發佈到 Nexus 登錄且您節點模組版本的格式為 x.y.z-SNAPSHOT.w，請選取遞增 Snapshot 模組版本勾選框。 建置工作會自動更新模組版本，然後才將工作發佈至 Nexus 登錄。 建置工作會從 npm 登錄及本端 package.json 檔案中選取最高版本的模組，並使用 semver 來增加模組版本。 建置工作不會將變更遞送至 SCM 儲存庫。

  4. 按一下儲存。 只要管線執行，此建置工作就會使用 Nexus 工具整合中的配置資訊來連接至 npm 登錄。

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

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

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

  1. 建立階段，並設定適當 SCM 儲存庫的輸入。

  2. 在此階段上，新增建置工作。

  3. 配置建置工作:

    Maven 建置作業
    Maven 建置作業

    a. 對於建置器類型，請選取 Maven（Artifactory、Nexus 或 SonarQube）。

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

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

    d. 針對建置指令，輸入指令來建置 Maven 模組或將它發佈至 Snapshot 登錄。 此範例顯示用來建置或發佈模組的指令。

    mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy

    您可以在 Nexus 工具整合的配置設定中，找到用來連接至登錄的 URL 及使用者認證。

  4. 按一下儲存。 只要管線執行，此建置工作就會使用 Nexus 工具整合中的配置資訊來連接至 Maven 儲存庫。

使用 API 來配置 Nexus

Nexus 工具整合支援下列配置參數，您 可在建立、讀取及 更新工具整合時，透過工具鏈 HTTP API 與 SDK 使用這些參數。

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

Nexus 工具整合參數
參數 用法 類型 Terraform 引數 說明
dashboard_url 選用，可更新 字串 伺服器網址 此 URL 工具整合的 Nexus 伺服器儀表板。 在圖形使用者介面中，當您按一下 Nexus 工具整合卡時，瀏覽器會移至此儀表板。
鏡像網址 選用，可更新 字串 鏡像網址 您的 Nexus 虛擬儲存庫 URL，您可在其中檢視私人儲存庫以及公共儲存庫的快取。
名稱 必要，可更新 字串 名稱 此工具整合的名稱。
發佈網址 選用，可更新 字串 發佈網址 您的 Nexus 發行儲存庫的 URL
快照網址 選用，可更新 字串 快照網址 您的 Nexus 快照儲存庫的 URL
記號 選用，可更新 密碼 記號 用於向 Nexus 儲存庫進行鑑別的密碼或記號。 您可以對此參數使用工具鏈密鑰參照。 如需密鑰參照的相關資訊，請參閱 在 Continuous Delivery中保護您的機密資料。
類型 必要，可更新 字串 類型 Nexus 工具整合的儲存庫類型。
user_id 選用，可更新 字串 user_id 用於向 Nexus 儲存庫進行鑑別的使用者 ID 或電子郵件位址。