Create and Configure Deployment Build Jobs and Pipelines

To deploy extensions to other Oracle Cloud Applications instances, you need to set up or create a packaging job, one or more deploy jobs, and a pipeline. Specifically:

  • A packaging job packages the extension and creates a build artifact. Instead of creating new packaging jobs, you can use the extensionName-Package job that was created with the project. (If you created this project manually, the package job is called Application-Extension-Package.) This job packages the extension and creates a build artifact from the same branch your team members used to deploy to the primary Oracle Cloud Applications Development instance. Remember, this packaging job is configured to trigger a build on every SCM commit.
  • Create one deploy job for each Oracle Cloud Applications instance you plan to deploy to. You'll also need a user's credentials who can deploy to each Oracle Cloud Applications instance. To create the job, see Create a Deployment Build Job.
  • After you've created deployment jobs, create pipelines to run the package job and deployment jobs in sequence. You can create either of these pipelines:
    • A pipeline to deploy the extension to the primary and other Oracle Cloud Applications instances.

      Instead of creating a new pipeline, configure the existing extensionName-Package and Deploy pipeline to deploy to other instances as well. (If you created this project manually, this pipeline's name is Application-Extension Package and Deploy.) See Configure the Default Pipeline to Deploy to Other Oracle Cloud Applications Instances. Remember, the default pipeline runs automatically when a code change is pushed to the main branch. After you've configured the pipeline, it deploys the extension to all development and test instances on every SCM commit to the main branch.

      After creating this pipeline, you'll have one pipeline in your project that deploys to all DEV and TEST instances.

      Here's an example of what this pipeline could look like:


      Description of build_appextn_main_pipeline.png follows
      Description of the illustration build_appextn_main_pipeline.png

    • A pipeline to deploy the extension to other DEV and TEST Oracle Cloud Applications instances manually. See Create and Configure a Pipeline to Deploy to Other Oracle Cloud Applications Instances.

      Create this pipeline if you don't want to deploy the extension to other instances on every SCM commit, but only after your team members have validated the extension on the primary development instance.

      After creating this pipeline, you'll have two pipelines in the project: 1) Your primary pipeline, which deploys to the primary development instance, and 2) this pipeline, which deploys to other DEV and TEST instances.

      Here's an example of what these pipelines could look like:


      Description of build_appextn_main_and_other_pipeline.png follows
      Description of the illustration build_appextn_main_and_other_pipeline.png

Create a Deployment Build Job

The deployment job deploys the extension's artifact that was generated in the default packaging job to the Oracle Cloud Application's instance. Before you create the job, make sure you have credentials that VB Studio can use to access the instance.

  1. In the left navigator, click Builds Builds.
  2. In the Jobs tab, click + Create Job.
  3. In the New Job dialog box, in Name, enter a unique name.
  4. In Description, enter the job's description.
  5. Select the Copy From Existing check box.
  6. From the Copy From drop-down list, select the deployment job that you'd like to copy.
  7. In Template, make sure that the System Default OL7 for Visual Builder template is selected.
  8. Click Create.
  9. From the Job Configuration page, click the Steps tab.
    The Application Extension Deployment section is displayed.
  10. In Target Instance, select the environment with the target Oracle Cloud Applications instance.
  11. In the Authorization section, select Use OAuth or Use Basic to specify the type of authorization used to run this build step.

    • If you selected Use OAuth, the Authorization is required message indicates that this build step needs to be authorized. Click Authorize and enter credentials to access the target Oracle Cloud Applications instance; you can also run the job manually and enter the credentials when prompted. Either way, it is recommended that you authorize your OAuth connection during initial configuration. If you skip this step, developers will need to complete the required authorization before attempting to deploy changes again.

      Once authorized, the Authorization has been provided message shows. If the OAuth token used to authorize the connection expires during extended periods of inactivity (say, when you're away on vacation), you can click Renew Authorization to renew the token (or you can run the job manually, so you're prompted to authorize any expired OAuth tokens).

    • If you selected Use Basic, in Username and Password, enter the credentials of a user who can deploy to the Oracle Cloud Applications instance. These credentials must belong to a local IDCS user, not a federated identity, and must not require multi-factor authentication.
  12. The Build Artifact field should show the same artifact name that was used in the packaging build step. Confirm this value, especially if the packaging job used an artifact name other than the default, extension.vx.
  13. Click Save.

Configure the Default Pipeline to Deploy to Other Oracle Cloud Applications Instances

If you want to deploy to other DEV and TEST instances along with your primary Oracle Cloud Applications instance, you can configure the default pipeline to deploy to other instances as well.

  1. In the left navigator, click Builds Builds.
  2. Click the Pipelines tab.
  3. In the extensionName-- Package and Deploy pipeline row, click the Actions menu and select Configure Pipeline. (If you created the project manually, the pipeline name is Application Extension - Package and Deploy.)
  4. Right-click the extensionName-Package job and select Add, then Add New On Success Jobs.
  5. Click in the Select new on success job(s) field, select the jobs that you want to add from the list, and click Save.
  6. Click Save.

Create and Configure a Pipeline to Deploy to Other Oracle Cloud Applications Instances

  1. In the left navigator, click Builds Builds.
  2. Click the Pipelines tab.
  3. Click + Create Pipeline.
  4. In the Create Pipeline dialog box, in Name and Description, enter a unique name and description.
  5. Deselect the Auto start when pipeline jobs are built externally check box.
  6. Click Create.
  7. On the Pipeline Configuration page, right-click the Start node and select Add New Start jobs.
  8. Click in the Select new on success job(s) field, select extensionName-Package, and click Save.
  9. Right-click the extensionName-Package job and select Add, then Add New On Success Jobs.
  10. Click in the Select new on success job(s) field, select the jobs that you want to add from the list, and click Save.
  11. Click Save.

Deploy Changes from a Different Branch

At some point, you'll likely want to create a separate branch to host your new feature development work. You can package those changes from your new branch and deploy them to an Oracle Cloud Applications instance for testing. To do this, you need to create a packaging job, a deployment job, and a pipeline.

Create a Packaging Job for the New Branch

Create a packaging job following the same steps to create a production packaging build job, but when configuring the job, select the new branch instead of the default main branch:

  1. In the left navigator, click Builds Builds.
  2. Create a job using the System Default OL7 for Visual Builder template.
  3. Click Configure Configure.
  4. Click the Git tab.
  5. From the Add Git list, select Git.
  6. In Repository, select the Git repository. In Branch or Tag, select the new branch.

Finish configuring the packaging job as usual. See Create the Production Packaging Build Job.

Create a Deployment Job

Create a deployment job following the same steps to create a production deployment build job, but when configuring the job, select the packaging job that you just created.

Create and Configure a Pipeline for the New Branch

After you've created the packaging and deployment jobs for the new branch, create a pipeline to run the packaging job and deployment jobs in sequence. See Create and Configure a Pipeline to Deploy to Other Oracle Cloud Applications Instances.