共用方式為

開始使用 Azure Artifacts 中的 Maven 套件

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

Maven 套件是使用 Apache Maven 建置工具建置的 Java 二進位檔。 使用 Azure Artifacts 摘要，您可以將多個套件類型儲存在單一摘要中。 然後可以還原儲存的套件以建置您的專案，或與您的團隊和客戶共用。 Azure Artifacts 饋送也支援透過上游來源從公用存放庫中擷取套件，例如 Maven Central、Google Maven 存放庫、Gradle 插件和 JitPack。

本文將引導您設定 Maven 專案、將它連線到 Azure Artifacts 摘要，以及發佈和還原 Maven 套件。

必要條件

產品 要求
Azure DevOps - Azure DevOps 組織。
- Azure DevOps 項目。
- 下載 並 安裝 Apache Maven 。

建立資訊來源

如果您已有資訊流，可以跳至下一節。 否則，請建立新的摘要，如下所示：

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

  2. 選取 [工件]，然後選取 [建立提要]。

  3. 提供您的 饋送 名稱，選取 可見度 以定義誰可以檢視您的套件，然後選擇您的饋送 範圍。 如果您想要包含來自公用登錄 （例如 Maven Central 或 Google Maven Repository） 的套件，請核取 包含來自常見公用來源的套件。

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

連接到資訊來源

現在您有了資料流，您必須設定設定檔以使用資料流進行驗證，您還需要建立個人存取權杖以驗證 Azure DevOps。 請按照以下步驟進行驗證並連接您的資訊流：

  1. 產生具有封裝讀取>範圍的個人存取權杖。 複製您的 PAT 並將其保存在安全位置，因為您在後續步驟中需要這樣做。

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

  3. 選取工件，然後從下拉式選單中選取您的饋送。

  4. 選取 連接到資訊來源，然後從左側導覽窗格中選取 Maven 。

  5. 如果這是第一次在此電腦上搭配 Maven 使用 Azure Artifacts，請確定您已安裝必要條件。

  6. 開啟您的 pom.xml 檔案，並在 和 區段內的<repositories><distributionManagement>區段中新增提供的程式碼片段。 您的 pom.xml 應類似以下內容：

        <repositories>
        <repository>
            <id>FEED_NAME</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>FEED_NAME</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>

  7. 開啟您的使用者層級 settings.xml，並在 <password> 標籤中新增您的 PAT。 此檔案應保留在本機，因此請確定不要將其提交到原始程式碼中，以免暴露您的認證。 您的 settings.xml 檔案應類似下列內容：

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

發佈套件

現在您已使用摘要進行驗證，已準備好發佈和還原套件：

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

    mvn package

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

    mvn deploy

  3. 成功發佈套件之後，它很快就會在您的 Azure Artifacts 資源中可用。

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

注意

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

還原套件

若要從來源還原套件，請從專案目錄執行 mvn install 命令，以安裝 pom.xml 中列出的所有套件相依性。 如果您要從動態饋給安裝的套件不在您的 pom.xml中，請按照以下方式新增該套件並從動態饋給還原：

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

  2. 選取工件，然後從下拉式選單中選取您的饋送。

  3. 選取您要安裝的套件，導覽至 概觀>Maven，然後複製相依性程式碼片段。 它看起來應該類似於這樣：

    <dependency>
  <groupId>MyGroup</groupId>
  <artifactId>MavenQuickStartDemo</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

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

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

    mvn install

相關內容

  • Last updated on