mvn の設定と使用 - Amazon CodeCatalyst

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

mvn の設定と使用

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

からの依存関係の取得 CodeCatalyst

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

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

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

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

  4. リポジトリに接続 を選択します。

  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 を 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

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. リポジトリに接続 を選択します。

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

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

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

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

      警告

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

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

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
  8. Maven がHTTPリクエストsettings.xmlでトークンを渡すように、CodeCatalyst_ARTIFACTS_TOKEN環境変数を参照して <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 プロジェクトウェブサイトの以下のトピックを参照してください。