IBM Cloud Docs
Artifactory の構成

Artifactory の構成

ビルド成果物を Artifactory リポジトリーに保管するように Artifactory リポジトリー・マネージャーを構成します。

  1. ツールチェーン作成時にこのツール統合を構成する場合は、「構成可能な統合」セクションで**「Artifactory」**をクリックします。

  2. ツールチェーンがあり、そこにこのツール統合を追加する場合、IBM Cloudコンソールから、メニューアイコンの ハンバーガーアイコン>Platform Automation>Toolchains をクリックします。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。 あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。 次に、「概要」**をクリックします。

    a. **「ツールの追加」**をクリックします。

    b. 「ツール統合」セクションで**「Artifactory」**をクリックします。

  3. Artifactory カードをクリックしたときに開くようにしたい Artifactory リポジトリーの URL を入力します。

  4. 接続先にするリポジトリーのタイプを選択します。

  5. Artifactory npm レジストリーを使用する場合は、以下のステップを実行します。

    a. レジストリーと関連付けられた E メール・アドレスを入力します。

    b. レジストリーと関連付けられた認証トークンを入力します。

    c. Artifactory サーバー上のプライベート・レジストリーである Artifactory リリース・リポジトリーの URL を入力します。

    d. 複数のパブリックおよびプライベート npm レジストリーを結合するために使用する Mirror または Public レジストリーの URL を入力します。 例えば、この URL は、プライベート・レジストリーと、npm グローバル・レジストリーのキャッシュの両方にアクセスできる、Artifactory サーバー上の仮想レジストリーの URL であることができます。

  6. Artifactory Maven リポジトリーを使用する場合は、以下のステップを実行します。

    a. リポジトリーと関連付けられたユーザー ID を入力します。

    b. リポジトリーと関連付けられたパスワードを入力します。

    c. Artifactory サーバー上のプライベート・リリース・リポジトリーである Artifactory リリース・リポジトリーの URL を入力します。

    d. Artifactory サーバー上のプライベート・スナップショット・リポジトリーである Artifactory スナップショット・リポジトリーの URL を入力します。

    e. 複数のパブリックおよびプライベート Maven リポジトリーを結合するために使用する Mirror または Public リポジトリーの URL を入力します。 例えば、この URL は、プライベート・リポジトリーと、Maven 中央リポジトリーのキャッシュの両方にアクセスできる、Artifactory サーバー上の仮想リポジトリーの URL であることができます。

  7. 「統合の作成」 をクリックします。

  8. **「サード・パーティー・ツール」**カードで、処理する Artifactory リポジトリーの Artifactory ツール統合をクリックします。 Artifactory の Web サイトが開きます。そこでリポジトリーの内容を表示できます。

  9. オプション: IBM Cloud Public でツールチェーンを使用していて、Artifactory を npm と共に使用してアプリをビルドしたい場合、パイプラインを構成して npm ビルド・ジョブを追加します。 ビルド・ジョブの構成手順については、『パイプラインに Artifactory npm ビルド・ジョブを構成する』セクションを参照してください。

  10. オプション: IBM Cloud Public でツールチェーンを使用していて、Artifactory を Maven と共に使用してアプリをビルドしたい場合、パイプラインを構成して Maven ビルド・ジョブを追加します。 ビルド・ジョブの構成手順については、『パイプラインに Artifactory Maven ビルド・ジョブを構成する』セクションを参照してください。

パイプラインに Artifactory npm ビルド・ジョブを構成する

パイプラインに npm ビルド・ジョブを構成する前に、ビルド SCM リポジトリーを入力として使用できる作業パイプラインが存在している必要があります。 また、ツールチェーンに Artifactory を構成しておく必要もあります。 Artifactory の構成手順については、Artifactory のセクションを参照してください。

Delivery Pipeline を構成して npm ビルド・ジョブを追加します。

  1. ステージを作成し、入力を適切な SCM リポジトリーに設定します。

  2. このステージでビルド・ジョブを追加します。

  3. ビルド・ジョブを構成します:

    npm build
    build

    a. ビルダー・タイプに**「NPM ビルド (NPM Build)」**を選択します。

    b. Artifactory ツール統合の複数インスタンスを構成した場合、npm ビルド・ジョブを構成する対象にしたい Artifactory ツール統合の名前を入力します。

    c. ツール統合タイプに**「Artifactory」**を選択します。

    d. ビルド・コマンドには、npm モジュールのビルドまたはレジストリーへのモジュールのパブリッシュを行うコマンドを入力します。 次の例は、モジュールのビルドまたはパブリッシュのいずれかを行うコマンドを示します。

    npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"

    レジストリーへの接続に使用した URL およびユーザー資格情報は、Artifactory ツール統合の構成設定で見つけることができます。

    e. ビルド・ジョブが Artifactory レジストリーへのパブリッシュを行い、かつ、ノード・モジュール・バージョンのフォーマットが x.y.z-SNAPSHOT.w である場合、**「スナップショット・モジュール・バージョンのインクリメント (Increment snapshot module version)」**チェック・ボックスにチェック・マークを付けます。 ビルド・ジョブは、モジュール・バージョンを自動的に更新した後で、Artifactory レジストリーにパブリッシュします。 ジョブは、npm レジストリーおよびローカル package.json ファイルから最高バージョンのモジュールを選択し、semver を使用してモジュール・バージョンを増やします。 ビルド・ジョブは、変更を SCM リポジトリーに配信しません。

  4. 保存 をクリックします。 パイプラインが実行されると、このビルド・ジョブは Artifactory ツール統合からの構成情報を使用して npm レジストリーに接続します。

パイプラインに Artifactory Maven ビルド・ジョブを構成する

パイプラインに Maven ビルド・ジョブを構成する前に、ビルド SCM リポジトリーを入力として使用できる作業パイプラインが存在している必要があり、また、ツールチェーンに Artifactory を構成しておく必要もあります。 Artifactory の構成手順については、Artifactory のセクションを参照してください。

Delivery Pipeline を構成して Maven ビルド・ジョブを追加します。

  1. ステージを作成し、入力を適切な SCM リポジトリーに設定します。

  2. このステージでビルド・ジョブを追加します。

  3. ビルド・ジョブを構成します:

    Mavenのビルドジョブ*
    の
    *

    a. ビルダー・タイプに**「Maven ビルド (Maven Build)」**を選択します。

    b. Artifactory ツール統合の複数インスタンスを構成した場合、Maven ビルド・ジョブを構成する対象にしたい Artifactory ツール統合の名前を入力します。

    c. ツール統合タイプに**「Artifactory」**を選択します。

    d. ビルド・コマンドには、Maven モジュールのビルドまたはスナップショット・レジストリーへのモジュールのパブリッシュを行うコマンドを入力します。 次の例は、モジュールのビルドまたはスナップショット・レジストリーへのモジュールのパブリッシュのいずれかを行うコマンドを示します。

    mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy

    レジストリーへの接続に使用した URL およびユーザー資格情報は、Artifactory ツール統合の構成設定で見つけることができます。

  4. 保存 をクリックします。 パイプラインが実行されると、このビルド・ジョブは Artifactory ツール統合からの構成情報を使用して Maven リポジトリーに接続します。

APIを使用したArtifactoryの設定

Artifactory ツール統合は、 、 read、および update の各ツール統合を作成する際に、 Toolchain HTTP API および SDK で使用できる以下の構成パラメーターをサポートします。

artifactory 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

Artifactoryツール統合パラメータ
パラメーター 使用法 タイプ Terraform 引数 説明
dashboard_url オプション、更新可能 ストリング dashboard_url このツール統合の Artifactory サーバー・ダッシュボードの URL。 グラフィカル UI では、 Artifactory ツール統合カードをクリックすると、ブラウザーがこのダッシュボードに移動します。
ミラー URL オプション、更新可能 ストリング ミラー URL Artifactory 仮想リポジトリーの URL。ここでは、プライベート・リポジトリーとパブリック・リポジトリーのキャッシュを表示できます。
名前 必須、更新可能 ストリング 名前 このツール統合の名前。
リリース URL オプション、更新可能 ストリング リリース URL Artifactory リリース・リポジトリーの URL。
リポジトリー名 (repository_name) オプション、更新可能 ストリング リポジトリー名 (repository_name) Docker イメージが格納されている Artifactory リポジトリーの名前。
リポジトリー URL (repository_url) オプション、更新可能 ストリング リポジトリー URL (repository_url) Docker イメージが格納されている Artifactory リポジトリーの URL。
スナップショット URL オプション、更新可能 ストリング スナップショット URL Artifactory スナップショット・リポジトリーの URL。
token オプション、更新可能 パスワード token Artifactory リポジトリーのアクセス・トークン。 このパラメーターには、ツールチェーン秘密参照を使用できます。 ツールチェーンのシークレット参照について詳しくは、 Continuous Delivery を参照してください。
タイプ 必須、更新可能 ストリング タイプ Artifactory ツール統合用のリポジトリー・タイプ。
user_id オプション、更新可能 ストリング user_id Artifactory リポジトリーのユーザー ID または E メール・アドレス。