共用方式為

開始使用 Azure Artifacts 中的 Maven 套件

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Artifacts 可讓開發人員從單一來源管理其依賴項，同時控制套件分享。 使用 Azure Artifacts 摘要，您可以發佈和還原 Maven 套件，並設定上游來源，從 Maven Central、Google Maven 存放庫、Gradle 外掛程式和 JitPack 等公用登錄取用套件。 本文將引導您設定 Maven 專案，連線到 Azure Artifacts 饋送，以及發佈和還原 Maven 套件。

必要條件

建立資訊來源

  1. 登入您的 Azure DevOps 組織，並流覽至您的專案。

  2. 選取 工件，然後選取 建立饋送。

  3. 為您的 Feed 提供 名稱，選擇 Visibility 選項以定義誰可以查看您的套件，若您希望包含來自一般公共來源如 nuget.org 或 npmjs.com的套件，請勾選 [包含來自一般公用來源的套件]，針對 範圍，請決定摘要應限定於您的專案或整個組織。

  4. 完成後，選擇「建立」。

    此螢幕快照顯示在 Azure DevOps Services 中建立新摘要的選項。

  1. 登入您的 Azure DevOps 伺服器，然後移至您的專案。

  2. 選取 [ 構件]，然後選取 [ 建立資料流]。

  3. 為您的 Feed 提供 名稱，選擇 Visibility 選項以定義誰可以查看您的套件，若您希望包含來自一般公共來源如 nuget.org 或 npmjs.com的套件，請勾選 [包含來自一般公用來源的套件]，針對 範圍，請決定摘要應限定於您的專案或整個組織。

  1. 完成後，選取建立。

    此螢幕快照顯示在 Azure DevOps 2022 中建立新摘要的選項。

  1. 完成後，選取 [建立]。

    此螢幕快照顯示在 Azure DevOps 2020 中建立新摘要的選項。

注意

根據預設，新建立的摘要會將其專案的 [建置服務] 值設定為 [摘要] 和 [上游讀取器] （共同作業者）。

連接到資訊來源

  1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

  2. 選取 [ 成品]，然後從下拉功能表中選取您的摘要。

  3. 選取 連線至資料饋送，然後從左側導覽區域選取 Maven。

  4. 如果這是您第一次搭配 Maven 使用 Azure Artifacts，請確定您已安裝必要條件。 否則，請選取 右上角的 [取得工具 ] 加以安裝。

  5. 請遵循 [項目設定] 區段中的指示來設定pom.xml和settings.xml檔案。 您的檔案應該類似下列範例：

    • pom.xml：

        <repositories>
    <repository>
      <id>MavenDemo</id>
      <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>MavenDemo</id>
      <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

    • settings.xml：

        <servers>
    <server>
      <id>MavenDemo</id>
      <username><ORGANIZATION_NAME></username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>

  6. 產生個人存取令牌，範圍設定為封裝讀取和寫入，然後將它貼到<password>。

  1. 登入您的 Azure DevOps 集合，然後流覽至您的專案。

  2. 選取 [ 成品]，然後從下拉功能表中選取您的摘要。

  3. 選取 [ 連接到摘要]，然後從左側瀏覽窗格中選取 [Maven ]。

  4. 如果這是您第一次搭配 Maven 使用 Azure Artifacts，請確定您已安裝必要條件，否則請選取 右上角的 [取得工具 ] 加以安裝。

  5. 請遵循 [項目設定] 區段中的指示來設定pom.xml和settings.xml檔案。 您的檔案應該類似下列範例：

    • pom.xml：

        <repositories>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

    • settings.xml：

        <servers>
    <server>
      <id>MavenDemo</id>
      <username><COLLECTION_NAME></username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>

  6. 產生具有封裝讀取和寫入範圍的個人存取令牌，然後將它貼到<password>。

發佈套件

  1. 開啟命令提示字元視窗，並流覽至pom.xml檔案所在的專案目錄，然後執行下列命令來封裝您的專案。 此命令會編譯您的程式代碼、執行包含的測試，並將專案封裝成可散發的格式（例如 JAR 檔案）。

    mvn package

  2. 從專案目錄運行以下命令，將您的套件發布至您的饋送：

    mvn deploy

  3. 成功部署套件之後，將很快在您的佇列中可用。

    顯示部署至饋送之 Maven 套件的螢幕截圖。

注意

如果您的組織使用防火牆或 Proxy 伺服器，請確定您允許 Azure Artifacts 網域 URL 和 IP 位址。

還原套件

  1. 流覽至 Azure DevOps 專案中的 [成品]，從下拉功能表中選取您的摘要，然後選取您想要安裝的套件。

  2. 流覽至 [概觀>Maven]，然後複製相依性代碼段。

  3. 開啟您的 pom.xml 檔案，並將代碼段貼到 <dependencies> 標記內。

  4. 從pom.xml檔案所在的目錄執行下列命令，以還原套件：

    mvn install