配置和使用 mvn - Amazon CodeCatalyst

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

配置和使用 mvn

您可以使用mvn命令來運行 Maven 構建。您必須設定mvn為使用套件儲存庫,並提供個人存取權杖 (PAT) 以進行驗證。

從中獲取依賴關係 CodeCatalyst

mvn要配置從 CodeCatalyst 存儲庫獲取依賴關係,您必須編輯 Maven 配置文件,settings.xml並可選擇編輯項目的項目模型對象(POM)文件。該POM文件包含有關 Maven 構建項目,如依賴關係,構建目錄,源目錄,測試源目錄,插件和目標的項目和配置信息的信息。

mvn要使用從 CodeCatalyst 套件存放庫擷取相依性
  1. 請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

  2. 在專案的概觀頁面上,選擇 [套件]。

  3. 從套裝程式儲存區域清單中選擇套裝程式儲存區域。

  4. 選擇「Connect 至儲存庫」。

  5. 在 [Connect 到儲存庫] 對話方塊中,從套件管理員用戶端清單中選擇 mvn

  6. 您將需要一個個人訪問令牌(PAT)來進行身份驗證mvn CodeCatalyst。如果你已經有一個,你可以使用它。如果沒有,您可以在此處創建一個。

    1. 選擇 [建立權杖]。

    2. 選擇「複製」以複製您的PAT.

      警告

      關閉對話方塊後,您將無法PAT再次看到或複製您的內容。

  7. 將包含存放庫的設定檔新增至您的settings.xml檔案。取代下列值。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) space_name 使用您的 CodeCatalyst空間名稱。

    • Replace (取代) proj_name 使用您的 CodeCatalyst項目名稱。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

    <profiles> <profile> <id>repo_name</id> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <repository> <id>repo_name</id> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </repositories> </profile> </profiles>
  8. 將伺服器新增至settings.xml檔案中的伺服器清單。取代下列值。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

    • Replace (取代) username 使用您的 CodeCatalyst 使用者名稱。

    • Replace (取代) PAT 與您的 CodeCatalystPAT.

    <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT</password> </server> </servers>
  9. (選擇性) 在settings.xml檔案中設定鏡像,以擷取所有連線,並將它們路由到您的儲存庫,而不是閘道儲存庫。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) space_name 使用您的 CodeCatalyst空間名稱。

    • Replace (取代) proj_name 使用您的 CodeCatalyst項目名稱。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

    <mirrors> <mirror> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> <mirrorOf>*</mirrorOf> </mirror> </mirrors>
重要

您可以在<id>元素中使用任何值,但在<server>和元<repository>素中必須相同。這可讓指定的認證包含在要求中 CodeCatalyst。

進行這些配置更改後,您可以構建項目。

mvn compile

從外部套裝程式儲存區域擷取套裝程式 CodeCatalyst

您可以使用代表閘道儲 CodeCatalyst存庫之閘道的上游連線來設定儲存庫,透過儲存庫從公用儲存庫安裝 Maven 套件。從閘道儲存庫安裝的套件會擷取並儲存在您的存 CodeCatalyst放庫中。

目前, CodeCatalyst 支持以下公共 Maven 軟件包存儲庫。

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • 通用网关

若要從公用 Maven 套件儲存庫安裝套件
  1. 如果您尚未設定,請依照中mvn的步驟使用 CodeCatalyst套件儲存庫進行設定從中獲取依賴關係 CodeCatalyst

  2. 確定您的存放庫已新增要從中安裝的閘道儲存庫作為上游連線。若要檢查新增哪些上游來源,或將閘道存放庫新增為上游來源,請遵循. 新增上游存放庫

如需有關從上游存放庫要求套件的詳細資訊,請參閱請求具有上游存儲庫的軟件包版本

將套件發佈至 CodeCatalyst

要發布一個 Maven 包mvn到一個 CodeCatalyst 存儲庫,你還必須編輯~/.m2/settings.xml和項目POM。

mvn於將套裝程式發行至您的 CodeCatalyst 套裝程式儲存庫
  1. 請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

  2. 在專案的概觀頁面上,選擇 [套件]。

  3. 從套裝程式儲存區域清單中選擇套裝程式儲存區域。

  4. 選擇「Connect 至儲存庫」。

  5. 在 [Connect 到儲存庫] 對話方塊中,從套件管理員用戶端清單中選擇 mvn

  6. 您將需要一個個人訪問令牌(PAT)來進行身份驗證mvn CodeCatalyst。如果你已經有一個,你可以使用它。如果沒有,您可以在此處創建一個。

    1. 選擇 [建立權杖]。

    2. 選擇「複製」以複製您的PAT.

      警告

      關閉對話方塊後,您將無法PAT再次看到或複製您的內容。

  7. 使用您的PAT. 您將在setting.xml檔案中使用此環境變數。

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
  8. <servers>部分添加到CodeCatalyst_ARTIFACTS_TOKEN環境變量的引settings.xml用,以便 Maven 在HTTP請求中傳遞令牌。

    <settings> ... <servers> <server> <id>repo-name</id> <username>username</username> <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password> </server> </servers> ... </settings>
  9. 添加一個<distributionManagement>部分到您的項目pom.xml

    <project> ... <distributionManagement> <repository> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </distributionManagement> ... </project>

進行這些組態變更後,您可以建置專案並將其發佈到指定的存放庫。

mvn deploy

您可以瀏覽至 CodeCatalyst 主控台中的套裝程式儲存區域,以檢查套件是否已成功發佈。

發佈第三方套件

您可以將第三方 Maven 套件發佈到mvn deploy:deploy-file. CodeCatalyst 這對於想要發佈套件且只有JAR檔案且無法存取套件原始程式碼或檔POM案的使用者來說,這會很有幫助。

mvn deploy:deploy-file命令將根據在命令行中傳遞的信息生成一個POM文件。

首先,PAT如果您沒有,請創建一個。

若要建立個人存取權杖 (PAT)
  1. 在頂端選單列中,選擇您的設定檔徽章,然後選擇 [我的設定]

    提示

    您還可以通過轉到項目或空間的成員頁面並從成員列表中選擇您的名稱來查找您的用戶個人資料。

  2. PAT名稱中,輸入您的PAT.

  3. 到期日中,保留預設日期,或選擇行事曆圖示以選取自訂日期。到期日預設為從目前日期算起一年。

  4. 選擇 Create (建立)。

    當您為來源儲存庫選擇複製儲存庫時,也可以建立此權杖。

  5. 將PAT秘密保存在安全的位置。

    重要

    PAT密碼只會顯示一次。關閉視窗之後,您無法擷取它。

若要發佈第三方 Maven 套件
  1. 建立包含下列內容的~/.m2/settings.xml檔案:

    <settings> <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT}</password> </server> </servers> </settings>
  2. 執行 mvn deploy:deploy-file 命令:

    mvn deploy:deploy-file -DgroupId=commons-cli \ -DartifactId=commons-cli \ -Dversion=1.4 \ -Dfile=./commons-cli-1.4.jar \ -Dpackaging=jar \ -DrepositoryId=repo-name \ -Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/
    注意

    上述範例會發佈commons-cli 1.4。修改groupId、文件 ID、版本和檔案引數以發佈不同的參數。JAR

這些說明基於從 Apache Maven 文檔第三方部署JARs到遠程存儲庫指南中的示例。

如需詳細資訊,請參閱 Apache Maven 專案網站上的下列主題: