1. Administering Visual Builder Studio
  2. Set Up VB Studio to Extend Oracle Cloud Applications
  3. Advanced Administrator Tasks
  4. Set Up the Project to Deploy to Other DEV and TEST Instances
  5. Create and Configure Deployment Build Jobs and Pipelines

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 plant 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 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 Application-Extension-Deploy job.
  7. In Template, make sure that the System Default OL7 for Visual Builder template is selected.
  8. Click Create.
  9. From the Job Configuration screen, click the Steps tab.
    The Oracle Deployment screen is displayed.
  10. In Target Instance, select the environment with the target Oracle Cloud Applications instance.
  11. In Username and Password, enter the credentials of a user who can deploy to the Oracle Cloud Applications instance.
  12. The Build Artifact field shows the same artifact name that was used in the packaging build step.
  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.