How do I build an install package for apps that run on virtual machines?

If you’re a provider who is approved for Oracle Compute Cloud Service, you can create an install package that deploys an instance of the virtual machine to a customer’s Compute Cloud account. These instances are virtual servers that can run apps. They have varying combinations of CPU, memory, storage, and networking capacity, and give you the flexibility to choose the appropriate mix of resources for your app.

To build an install package for an app that runs on a virtual machine:

  1. Sign in to Oracle Cloud Marketplace Partner Portal.
  2. Click Listings.
    • If you haven’t started a listing, click Create Listing. Enter information into the required fields in the header and then click Save. You must complete this step before you can continue to define the install package.

    • If you already started a listing, find the listing on the Started tab and then click Edit.

  3. Click the App Install Package tab.
    • To create a new install package, select the package type and click Create Package. Complete the basic information for the install package and then click Save.

    • After the package is initially created, you can click Edit in the Define Package Information section to modify the basic information at any time.

  4. In the Configure Machine Image section, click Edit and enter the required information into each field.

    An image is a template of a virtual hard disk with an installed operating system. It is used to launch a virtual machine instance within the Oracle Cloud.

    A shape is a resource profile that specifies the number of CPUs and the amount of memory to be allocated to an instance in Oracle Compute Cloud Service.

    • In the Image Location field, click Search icon to select a machine image that you already uploaded.

    • In the Default Shape field, select a default shape for the image from the drop-down list.

    • In the Image Name field, specify a name for the image.

    • In the Minimum Disk Size field, specify the minimum disk size in gigabytes. For example, enter 10 to specify a minimum disk size of 10 GB. The maximum value you can enter is 2048 GB.

    • In the Size field, specify the actual size of the image file in bytes. For example, enter 1448803158 to specify a size of 1448803158 bytes.

    • The Configure Machine Image screen might also display the Unsupported Shapes field. In the Unsupported Shapes field, select the unsupported shapes.

    • In the Custom Properties section, specify custom attributes to be passed during VM instance initialization. If the customer must provide the value for an attribute during installation, then leave the value field blank for such attributes.

      • In the first text field, enter a name for the attribute.

      • In the second text field, enter a value for the attribute.

      • Click Add Custom Property icon to add another attribute.

      • Click Delete icon to delete an attribute.

    Click Save.

    You can continue to edit the package information, configure the image, and save your changes. You can’t proceed to the next step—validating the package—until you enter all required information.

  5. Click Next and then click Validate to verify that the package is defined properly.
    • To view more information about successes, failures, and issues, click the link in the Result column.

    • To return to the definition of the package and make adjustments, click Back.

    You can continue to edit the package definition. You can’t proceed to the final step—testing the package—until the validation is successful.

  6. Click Next to test the installation.
  7. Click Test Install.
    A preview of your listing opens in Oracle Cloud Marketplace.
  8. Click Test Install Get App.
  9. Follow the instructions for running the test.
    You can review the test results (for example, install in progress or installed failed), make changes to your package, and re-run the test as necessary.