Deploy an Extension From Your Local System

After an extension is packaged as a .vx archive, you can use a REST request to install the extension on an Oracle Cloud Applications environment instead of using a Visual Builder Studio deploy build job.

For example, you might want to deploy an extension to an Oracle Cloud Applications production environment that has restricted IP access, so the environment is not accessible from Visual Builder Studio. To get around this, you can use cURL to install the extension from an IP address that's able to access the environment. To install the extension, you'll need a valid .vx extension archive and the URL and credentials for the Oracle Cloud Applications environment.

The Package build job for your extension in VB Studio will build a valid extension archive for you. After running the build job, you can download the archive to your local system.

Note:

You can also package your .vx extension archive locally using Grunt.

To install an extension from your local system:

Make sure you have cURL installed on your local system, and that the system can access the Oracle Cloud Applications environment.
Download the extension archive to your local system.
1. On the project's Builds tab, open the Package build job for the extension.
  You can use the same Package build job used to build the extension for testing.
2. Click Artifacts to open the Artifacts Archived page.
  
  Description of the illustration package-job-artifacts.png
3. Click the extension archive to automatically download it to the default location on your local system.
  
  The extension will have .vx appended to the name as the file type ( extension.vx).
  
  Description of the illustration package-artifact-archive.png
  
  If you don't see an extension archive, click Build Now to run the build job.
Use cURL to install the extension on the Oracle Cloud Applications instance.
1. Open your command terminal.
2. In the terminal, navigate to the location of the extension archive on your local system.
3. Type the cURL request at the command prompt to install the extension. You'll need to provide:
  - The USERNAME and PASSWORD for the Oracle Cloud Applications instance.
  - The name of the extension archive (for example, EXTENSION_NAME.vx).
  - The path to the v2/extensions directory of your Oracle Cloud Applications instance, which will include its URL and port (INSTANCE_URL:PORT/fscmRestApi/vx/v2/extensions).
  Your cURL request will look similar to this:
```
curl -v --noproxy '*' -X POST -L -H Content-Type: application/octet-stream -H 'X-OAM-AUTHN-HINT: 0' 
 -u USERNAME:PASSWORD --data-binary @EXTENSION_NAME.vx
 http://INSTANCE_URL:PORT/fscmRestApi/vx/v2/extensions
```
  The cURL request contains a POST method to add the extension archive to the extensions directory.
  After installing the extension, you can use the following cURL request to see a list of installed extensions:
```
curl -v --noproxy '*' 'X-OAM-AUTHN-HINT: 0' -u
        USERNAME:PASSWORD http://INSTANCE_URL:PORT/fscmRestApi/vx/v2/extensions/
```

(Optional) To delete an extension using cURL:

To delete a specific version of an extension:

curl -v --noproxy '*' -X DELETE -L -H 'X-OAM-AUTHN-HINT: 0' -u
        USERNAME:PASSWORD http://INSTANCE_URL:PORT/fscmRestApi/vx/v2/extensions/{extensionId}/{extensionVersion}

To delete all versions of an extension:

curl -v --noproxy '*' -X DELETE -L -H 'X-OAM-AUTHN-HINT: 0' -u
        USERNAME:PASSWORD http://INSTANCE_URL:PORT/fscmRestApi/vx/v2/extensions/{extensionId}

The extension is automatically installed and registered when it's added to the directory.

Note:

Extensions deployed from a local system using cURL will not be in the list of deployed extensions in the project's Environments tab.