mvn の設定と使用 - Amazon CodeCatalyst

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

mvn の設定と使用

mvn コマンドを使用して Maven ビルドを実行します。パッケージリポジトリを使用し、認証用の個人用アクセストークン (PAT) を提供するmvnように を設定する必要があります。

からの依存関係の取得 CodeCatalyst

CodeCatalyst リポジトリから依存関係を取得するmvnように を設定するには、Maven 設定ファイル、settings.xmlおよびオプションでプロジェクトのプロジェクトモデルオブジェクト (POM) ファイルを編集する必要があります。POM ファイルには、依存関係、ビルドディレクトリ、ソースディレクトリ、テストソースディレクトリ、プラグイン、目標など、Maven がプロジェクトを構築するためのプロジェクトと設定情報が含まれています。

mvn を使用して CodeCatalyst パッケージリポジトリから依存関係を取得するには
  1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

  2. プロジェクトの概要ページで、「パッケージ」を選択します。

  3. パッケージリポジトリのリストからパッケージリポジトリを選択します。

  4. Connect to repository を選択します。

  5. リポジトリに接続ダイアログボックスで、パッケージマネージャークライアントのリストから mvn を選択します。

  6. mvn で認証するには、個人用アクセストークン (PAT) が必要です 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

    • 置換 username CodeCatalyst ユーザー名を使用します。

    • 置換 PAT を使用します CodeCatalystPAT。

    <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

Maven パッケージは、 CodeCatalystゲートウェイリポジトリを表すゲートウェイへのアップストリーム接続を使用して設定することで、リポジトリを介してパブリックリポジトリからインストールできます。ゲートウェイリポジトリからインストールされたパッケージは、リポジトリに CodeCatalyst取り込まれて保存されます。

現在、 は、次の Maven パッケージリポジトリ CodeCatalyst をサポートしています。

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • commonsware-gateway

パブリック Maven パッケージリポジトリからパッケージをインストールするには
  1. まだ設定していない場合は、「」の手順に従って、パッケージリポジトリmvnで CodeCatalyst を設定しますからの依存関係の取得 CodeCatalyst

  2. リポジトリがアップストリーム接続としてインストールするゲートウェイリポジトリを追加していることを確認します。どのアップストリームソースが追加されているかをチェックしたり、ゲートウェイリポジトリをアップストリームソースとして追加するには、「」の手順に従いますアップストリームリポジトリの追加

アップストリームリポジトリからのパッケージのリクエストの詳細については、「」を参照してくださいアップストリームリポジトリを持つパッケージバージョンのリクエスト

へのパッケージの発行 CodeCatalyst

Maven パッケージを CodeCatalyst リポジトリmvnに発行するには、 ~/.m2/settings.xmlと プロジェクト も編集する必要がありますPOM。

mvn を使用してパッケージリポジトリに CodeCatalyst パッケージを発行するには
  1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

  2. プロジェクトの概要ページで、「パッケージ」を選択します。

  3. パッケージリポジトリのリストからパッケージリポジトリを選択します。

  4. Connect to repository を選択します。

  5. リポジトリに接続ダイアログボックスで、パッケージマネージャークライアントのリストから mvn を選択します。

  6. mvn で認証するには、個人用アクセストークン (PAT) が必要です CodeCatalyst。既にお持ちの場合は、これを使用できます。そうでない場合は、ここで作成できます。

    1. トークンの作成 を選択します。

    2. コピーを選択して をコピーしますPAT。

      警告

      ダイアログボックスを閉じると、 PAT を再度表示またはコピーできなくなります。

  7. でローカルマシンの環境変数を設定しますPAT。ファイルでこの環境変数を使用しますsetting.xml

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
  8. Maven がHTTPリクエストでトークンを渡すように、CodeCatalyst_ARTIFACTS_TOKEN環境変数settings.xmlを参照して <servers> セクションを に追加します。

    <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)
  1. 上部のメニューバーでプロファイルバッジを選択し、[My 設定] を選択します。

    ヒント

    ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。

  2. PAT 名前 に、 の説明的な名前を入力しますPAT。

  3. 有効期限 で、デフォルトの日付を残すか、カレンダーアイコンを選択してカスタム日付を選択します。有効期限は、デフォルトで現在の日付から 1 年間です。

  4. [Create] (作成) を選択します。

    このトークンは、ソースリポジトリの [クローンリポジトリC] を選択したときにも作成できます。

  5. PAT シークレットを安全な場所に保存します。

    重要

    PAT シークレットは 1 回のみ表示されます。ウィンドウを閉じると取得できません。

サードパーティーの 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 プロジェクトウェブサイトの以下のトピックを参照してください。