Oracle Cloud Infrastructure Documentation

Delete an Extension

Delete unnecessary extensions to restore your application to its original state and clean up your environment.

You have two options to delete an extension:

  • The best practice is to use the Manage Lifecycle Extension page to delete an extension. When you delete an extension from this page, all versions of that extension are deleted.
  • If you need to delete a specific extension version, you must configure a build job to delete it.

Delete an Extension Manually

Use the Manage Extension Lifecycle page to delete extensions deployed from any project and to any Oracle Cloud Applications instance.

  1. Access the Manage Extension Lifecycle page:
    • From the VB Studio left navigator, click Environments, then click Extension Lifecycle. You won't see this option if you haven't yet added an Oracle Cloud Applications instance to your environment.


      Description of mel-ui-envts.png follows
      Description of the illustration mel-ui-envts.png

    • Or, from the menu in the Designer's header, click Extension Lifecycle.
    You should now see the Manage Extension Lifecycle page, which lists all the environments that are available.
    Description of mel-ui-full-project.png follows
    Description of the illustration mel-ui-full-project.png

    You can work with an environment on this page as long as the authentication method for its Oracle Cloud Applications instance is OAuth. If there's an environment listed whose authentication method isn't OAuth, then you'll first need to add a new environment with the same base URL, but using OAuth as the authentication method, before you can work with it.

    Note

    If you see a Provide Credentials button next to an environment, you must first sign in before you can delete any extensions deployed to that instance.

    Expand each environment to view a list of the extensions already deployed. Use the Only Show Extensions for My Project checkbox to toggle between viewing extensions deployed from the current project only, or from all projects.

    Each entry includes the extension name plus additional details, such as extension version, deployment date, who deployed the extension, and project name.

  2. To delete an extension from an Oracle Cloud Applications instance, find the extension that you want to delete and click Delete Extension.

    All extension versions are deleted. If the extension was originally deployed via a CI/CD pipeline, the extension's build jobs and their artifacts remain; this is helpful in case you ever need to redeploy an earlier extension version.

    Tip:

    Before deleting an extension from your PROD instance, delete the extension from the DEV instance (or TEST instance, if applicable) and make sure there aren't any adverse effects.

Configure a Job to Delete an Extension

If you want to delete a specific extension version that's deployed to an Oracle Cloud Applications instance, you must configure a build job and run it.

You can also use the Manage Extension Lifecycle page to delete extensions, but keep in mind that deleting an extension from that page deletes the entire extension.

Note that there can be only one active extension version at a time. The recommended best practice is to avoid deleting the active extension version because, if you delete it, the extension will become inactive as if it wasn't installed at all. You can, however, delete inactive versions without impacting the currently active deployed extension.

Before you configure and run the job, delete the extension from the DEV instance (or TEST instance, if applicable) and make sure there aren't any adverse effects. For example, let's assume you have an attribute that's hidden in both the extension's business object and the user interface. After you delete the extension, the user interface shows the attribute that's still hidden in the business object. This may cause an error.

To configure the job, make sure you have valid administrator credentials for the Oracle Cloud Applications instance where the extension is deployed.

  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. In Template, select System Default OL7 for Visual Builder.
  6. Click Create.
    The Job Configuration page opens.
  7. Click the Steps tab.
  8. From Add Step, select Application Extension, and then select Delete.

    This image shows the Application Extension Delete build job page that's partially filled in.


    Description of app-ext-delete-build-step.png follows
    Description of the illustration app-ext-delete-build-step.png

  9. In Instance, select the Oracle Cloud Applications instance where the application is deployed.
  10. 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 displayed before authorization indicates that this build step needs to be authorized, either by clicking the Authorize button or by running the build manually and entering the credentials when you are prompted for them at that point. After authorization, the Authorization has been provided message and the Renew Authorization button are displayed.

    • If you selected Use Basic, in Username and Password, enter the credentials of an IDCS user who is not only an Oracle Cloud Applications user, but one who can access the Oracle Cloud Application's instance and undeploy from it. These credentials must be those of a local user, not a federated identity, and must not require multi-factor authentication.

  11. In Extension ID and Version, enter the extension ID and version of the extension you want to delete.
    You can find these items in the extension's details on the Manage Extension Lifecycle page.

    1. In the left navigator, click Environments, then click Extension Lifecycle.


      Description of mel-ui-envts.png follows
      Description of the illustration mel-ui-envts.png

    2. Find the extension you want to delete, and select Extension Details to obtain the extension ID and version.
  12. Click Save.
  13. To run a build, click Build Now.