このページは機械翻訳したものです。

デプロイメント・ビルド・ジョブおよびパイプラインの作成および構成

他のOracle Cloud Applicationsインスタンスに拡張をデプロイするには、パッケージング・ジョブ、1つ以上のデプロイ・ジョブおよびパイプラインを設定または作成する必要があります。特に:

  • パッケージング・ジョブによって拡張がパッケージ化され、ビルド・アーティファクトが作成されます。新しいパッケージ・ジョブを作成するかわりに、プロジェクトで作成されたextensionName-パッケージ・ジョブを使用できます。(このプロジェクトを手動で作成した場合、パッケージ・ジョブはApplication-Extension-Packageと呼ばれます。)このジョブは拡張をパッケージ化し、チーム・メンバーがプライマリOracle Cloud Applications Developmentインスタンスへのデプロイに使用したのと同じブランチからビルド・アーティファクトを作成します。このパッケージング・ジョブは、すべてのSCMコミットでビルドをトリガーするように構成されています。
  • デプロイ先のOracle Cloud Applicationsインスタンスごとに1つのデプロイ・ジョブを作成します。また、各Oracle Cloud Applicationsインスタンスにデプロイできるユーザーの資格証明も必要です。ジョブを作成するには、「デプロイメント・ビルド・ジョブの作成」を参照してください。
  • デプロイメント・ジョブを作成したら、パッケージ・ジョブおよびデプロイメント・ジョブを順番に実行するためのパイプラインを作成します。次のいずれかのパイプラインを作成できます。
    • プライマリおよび他のOracle Cloud Applicationsインスタンスに拡張をデプロイするパイプライン。

      新しいパイプラインを作成するかわりに、既存のextensionName-パッケージおよびデプロイ・パイプラインを構成して、他のインスタンスにもデプロイします。(このプロジェクトを手動で作成した場合、このパイプラインの名前はApplication-Extensionパッケージおよびデプロイです。)他のOracle Cloud Applicationsインスタンスにデプロイするためのデフォルト・パイプラインの構成を参照してください。コード変更がmainブランチにプッシュされると、デフォルトのパイプラインが自動的に実行されます。パイプラインを構成すると、mainブランチへのすべてのSCMコミットのすべての開発およびテスト・インスタンスに拡張がデプロイされます。

      このパイプラインの作成後、プロジェクトには、すべてのDEVおよびTESTインスタンスにデプロイされるパイプラインが1つあります。

      次に、このパイプラインの例を示します。

    • 他のDEVおよびTEST Oracle Cloud Applicationsインスタンスに拡張を手動でデプロイするパイプライン。他のOracle Cloud Applicationsインスタンスにデプロイするためのパイプラインの作成および構成を参照してください。

      このパイプラインは、SCMコミットごとに他のインスタンスに拡張をデプロイせず、チーム・メンバーがプライマリ開発インスタンスで拡張を検証した後にのみ作成します。

      このパイプラインの作成後、プロジェクトに2つのパイプラインがあります。1)プライマリ開発インスタンスにデプロイされるプライマリ・パイプラインと、2)他のDEVおよびTESTインスタンスにデプロイされるこのパイプラインです。

      次に、これらのパイプラインの例を示します。

デプロイメント・ビルド・ジョブの作成

デプロイメント・ジョブは、デフォルトのパッケージング・ジョブで生成された拡張のアーティファクトをOracle Cloud Applicationのインスタンスにデプロイします。ジョブを作成する前に、VB Studioがインスタンスへのアクセスに使用できる資格証明があることを確認してください。

  1. 左側のナビゲータで、「ビルド」 ビルドをクリックします。
  2. 「ジョブ」タブで、「+ジョブの作成」をクリックします。
  3. 「新規ジョブ」ダイアログ・ボックスの「名前」に、一意の名前を入力します。
  4. 「説明」にジョブの説明を入力します。
  5. 「既存からコピー」チェック・ボックスを選択します。
  6. 「コピー元」ドロップダウン・リストから、コピーするデプロイメント・ジョブを選択します。
  7. 「テンプレート」で、「Visual Builderのシステム・デフォルトOL7」テンプレートが選択されていることを確認します。
  8. 「作成」をクリックします
  9. 「ジョブ構成」ページで、「ステップ」タブをクリックします。
    「アプリケーション拡張デプロイメント」セクションが表示されます。
  10. 「ターゲット・インスタンス」で、ターゲットのOracle Cloud Applicationsインスタンスを含む環境を選択します。
  11. 「認可」セクションで、このビルド・ステップを実行する認可タイプを指定します。「OAuthの使用」をデフォルトで選択すると、Authorization is requiredメッセージが表示されます。これは、このビルド・ステップでは、環境のOracle Cloud ApplicationsインスタンスへのOAuthリクエストを処理するために1回かぎりの認可が必要であることを示しています。「認可」をクリックし、資格証明を入力してOracle Cloud Applicationsインスタンスにアクセスします。ジョブを手動で実行し、プロンプトが表示されたら資格証明を入力することもできます。

    いずれの場合も、初期構成時にOAuth接続を承認することをお薦めします。このステップをスキップすると、デザイナから変更を公開できなくなり、変更のデプロイを試行する前に必要な承認を完了する必要があります。

    承認されると、Authorization has been providedメッセージが表示されます。

    ノート

    OAuthが推奨される認可タイプです。OAuth接続の設定で問題が発生した場合のみ、Basic認証を使用します。Basic認証を使用するには、「基本の使用」を選択し、「ユーザー名」および「パスワード」でOracle Cloud Applicationsインスタンスにアクセスできるユーザーの資格証明を入力します。これらの資格証明は、フェデレーテッド・アイデンティティではなくローカル・ユーザーの資格証明である必要があり、マルチファクタ認証を必要としません。

    OAuthトークン(アクセスおよびリフレッシュ)は、通常の使用中に循環されます。リフレッシュ・トークンは、ユーザーがターゲット・インスタンスにアクセスするたびにアクセス・トークンを取得するために使用されます。このリフレッシュ・トークンは通常、7日間有効です。(トークンの有効期限はIDCSリソース・アプリケーションで設定され、セキュリティ要件によって異なる場合があります。)ユーザーが7日以内にターゲット・インスタンスで認証すると、アクティブなリフレッシュ・トークンによって新しいアクセス・トークンと新しいリフレッシュ・トークンが生成されます。リフレッシュ・トークンが有効であるかぎり、このサイクルは無期限に継続されます。リフレッシュ・トークンが長時間非アクティブ状態(休暇中など)で期限切れになった場合は、「認可の更新」をクリックします(またはジョブを手動で実行するため、期限切れのOAuthトークンを認可するように求められます)。

  12. 「アーティファクトのビルド」フィールドには、パッケージング・ビルド・ステップで使用されたものと同じアーティファクト名が表示されます。特に、パッケージング・ジョブでデフォルトのextension.vx以外のアーティファクト名が使用された場合は、この値を確認します。
  13. 「保存」をクリックします。

他のOracle Cloud Applicationsインスタンスにデプロイするためのデフォルト・パイプラインの構成

プライマリOracle Cloud Applicationsインスタンスとともに他のDEVおよびTESTインスタンスにデプロイする場合は、他のインスタンスにもデプロイするようにデフォルト・パイプラインを構成できます。

  1. 左側のナビゲータで、「ビルド」 ビルドをクリックします。
  2. 「パイプライン」タブをクリックします。
  3. extensionName-- パッケージおよびデプロイ・パイプライン行で、「アクション」メニューをクリックし、「パイプラインの構成」を選択します。(プロジェクトを手動で作成した場合、パイプライン名は「アプリケーション拡張- パッケージおよびデプロイ」です。)
  4. extensionName-「パッケージ」ジョブを右クリックし、「追加」「成功時に新規ジョブの追加」の順に選択します。

    次の例は、次のとおりです:

  5. 「成功時に新規ジョブを選択」フィールドをクリックし、リストから追加するジョブを選択して、「保存」をクリックします。
  6. 「保存」をクリックします。

他のOracle Cloud Applicationsインスタンスにデプロイするためのパイプラインの作成および構成

  1. 左側のナビゲータで、「ビルド」 ビルドをクリックします。
  2. 「パイプライン」タブをクリックします。
  3. 「+パイプラインの作成」をクリックします。
  4. 「パイプラインの作成」ダイアログ・ボックスの「名前」および「摘要」に、一意の名前と摘要を入力します。
  5. 「パイプライン・ジョブが外部でビルドされる場合の自動開始」チェック・ボックスの選択を解除します。
  6. 「作成」をクリックします
  7. 「パイプライン構成」ページで、「開始」ノードを右クリックし、「新規開始の追加」ジョブを選択します。
  8. 「成功時に新規ジョブを選択」フィールドをクリックし、extensionName-「パッケージ」を選択して、「保存」をクリックします。
  9. extensionName-「パッケージ」ジョブを右クリックし、「追加」「成功時に新規ジョブの追加」の順に選択します。
  10. 「成功時に新規ジョブを選択」フィールドをクリックし、リストから追加するジョブを選択して、「保存」をクリックします。
    完成したパイプラインの例を次に示します。
  11. 「保存」をクリックします。

別のブランチからの変更のデプロイ

ある時点で、新しい機能開発作業をホストする別のブランチを作成します。これらの変更を新しいブランチからパッケージ化し、テストのためにOracle Cloud Applicationsインスタンスにデプロイできます。そのためには、パッケージング・ジョブ、デプロイメント・ジョブおよびパイプラインを作成する必要があります。

新規ブランチのパッケージング・ジョブの作成

同じステップに従ってパッケージ・ジョブを作成し、本番パッケージ・ビルド・ジョブを作成しますが、ジョブを構成するときは、デフォルトのmainブランチではなく新しいブランチを選択します。

  1. 左側のナビゲータで、「ビルド」 ビルドをクリックします。
  2. Visual Builderのシステム・デフォルトOL7テンプレートを使用して、ジョブを作成します。
  3. 「構成」 構成をクリックします。
  4. 「Git」タブをクリックします。
  5. 「Gitの追加」リストから、「Git」を選択します。
  6. 「リポジトリ」で、Gitリポジトリを選択します。「ブランチまたはタグ」で、新しいブランチを選択します。

通常どおりにパッケージング・ジョブの構成を終了します。Production Packaging Buildジョブの作成を参照してください。

デプロイメント・ジョブの作成

本番デプロイメント・ビルド・ジョブを作成するのと同じステップに従ってデプロイメント・ジョブを作成しますが、ジョブを構成するときは、作成したパッケージ・ジョブを選択します。

新規ブランチのパイプラインの作成および構成

新しいブランチのパッケージ・ジョブおよびデプロイメント・ジョブを作成したら、パッケージ・ジョブおよびデプロイメント・ジョブを順番に実行するパイプラインを作成します。他のOracle Cloud Applicationsインスタンスにデプロイするためのパイプラインの作成および構成を参照してください。