設定和使用 mvn - Amazon CodeCatalyst
從 CodeCatalyst 擷取相依性透過 CodeCatalyst 從外部套件儲存庫擷取套件將套件發佈至 CodeCatalyst發佈第三方套件

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

設定和使用 mvn

您可以使用 mvn命令來執行 Maven 組建。您必須mvn將 設定為使用套件儲存庫，並提供個人存取字符 (PAT) 進行身分驗證。

從 CodeCatalyst 擷取相依性

若要mvn設定 從 CodeCatalyst 儲存庫擷取相依性，您必須編輯 Maven 組態檔案，settings.xml以及選擇性的專案專案模型物件 (POM) 檔案。POM 檔案包含 Maven 建置專案的專案和組態資訊，例如相依性、建置目錄、來源目錄、測試來源目錄、外掛程式和目標。

使用 mvn 從 CodeCatalyst 套件儲存庫擷取相依性

  1. 開啟 CodeCatalyst 主控台，網址為 https：//https://codecatalyst.aws/。

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

  3. 從套件儲存庫清單中選擇套件儲存庫。

  4. 選擇連線至儲存庫。

  5. 在連線至儲存庫對話方塊中，從套件管理員用戶端清單中選擇 mvn。

  6. 您需要個人存取字符 (PAT) 才能mvn向 CodeCatalyst 驗證。如果您已經有 ，則可以使用它。如果沒有，您可以在這裡建立一個。

    1. 選擇建立字符。

    2. 選擇複製以複製您的 PAT。

      警告

      關閉對話方塊後，您將無法再次查看或複製您的 PAT。

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

    注意

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

    • 將 space_name 取代為您的 CodeCatalyst 空間名稱。

    • 將 proj_name 取代為您的 CodeCatalyst 專案名稱。

    • 將 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檔案中的伺服器清單。取代下列值。

    注意

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

    • 將 repo_name 取代為您的 CodeCatalyst 套件儲存庫名稱。

    • 將使用者名稱取代為您的 CodeCatalyst 使用者名稱。

    • 將 PAT 取代為您的 CodeCatalyst PAT。

    <servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>

  9. （選用） 在settings.xml檔案中設定鏡像，擷取所有連線並將其路由到您的儲存庫，而不是閘道儲存庫。

    注意

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

    • 將 space_name 取代為您的 CodeCatalyst 空間名稱。

    • 將 proj_name 取代為您的 CodeCatalyst 專案名稱。

    • 將 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

  • commonsware-gateway

從公有 Maven 套件儲存庫安裝套件

  1. 如果您尚未設定，請依照中的步驟mvn，使用 CodeCatalyst 套件儲存庫進行設定從 CodeCatalyst 擷取相依性。

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

如需從上游儲存庫請求套件的詳細資訊，請參閱使用上游儲存庫請求套件版本。

將套件發佈至 CodeCatalyst

若要將 Maven 套件發佈mvn至 CodeCatalyst 儲存庫，您還必須編輯 ~/.m2/settings.xml和專案 POM。

使用 mvn將套件發佈至 CodeCatalyst 套件儲存庫

  1. 開啟 CodeCatalyst 主控台，網址為 https：//https://codecatalyst.aws/。

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

  3. 從套件儲存庫清單中選擇套件儲存庫。

  4. 選擇連線至儲存庫。

  5. 在連線至儲存庫對話方塊中，從套件管理員用戶端清單中選擇 mvn。

  6. 您需要個人存取字符 (PAT) 才能mvn向 CodeCatalyst 驗證。如果您已經有 ，則可以使用它。如果沒有，您可以在這裡建立一個。

    1. 選擇建立權杖。

    2. 選擇複製以複製您的 PAT。

      警告

      關閉對話方塊後，您將無法再次查看或複製您的 PAT。

  7. 使用 PAT 在本機電腦上設定環境變數。您將在 setting.xml 檔案中使用此環境變數。

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT

  8. 將<servers>區段新增至 ，settings.xml並參考CodeCatalyst_ARTIFACTS_TOKEN環境變數，讓 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 套件發佈至 CodeCatalyst 儲存庫mvn deploy:deploy-file。這對於想要發佈套件且只有 JAR 檔案，且無法存取套件原始碼或 POM 檔案的使用者很有幫助。

mvn deploy:deploy-file 命令會根據在命令列中傳遞的資訊產生 POM 檔案。

首先，如果您沒有 PAT，請建立 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、artifactID、版本和檔案引數以發佈不同的 JAR。

這些指示是根據指南中從 Apache Maven 文件將第三方 JARs 部署到遠端儲存庫的範例。

如需詳細資訊，請參閱 Apache Maven 專案網站上的這些主題：