How do I build an Oracle Cloud Infrastructure install package for my app?

If you’re a partner who is approved for Oracle Cloud Infrastructure (OCI) Service, you can create an Oracle Cloud Infrastructure install package.

To build an Oracle Cloud Infrastructure install package for an app:
  1. Sign in to Oracle Cloud Marketplace Partner Portal.
  2. Click Listings.
    1. 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.

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

  3. Click the App Install Package tab.
    1. To create a new install package, select a package type and click Create Package.

    2. Enter the basic information for the install package such as version and description. While specifying the Version, use only letters, numbers, periods, hyphens, underscores, space, and round brackets. Don't use any other character. In the Terms of Use field, select the terms of use for this app and install package.

    3. 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 Terraform Template section or Configure OCI Compute Image section, click Edit to configure a resource. Configure the resource by completing the configuration information:

      • Select an artifact.

      • Compartment ID will be provided by customer during installation (only Terraform templates).

      • Optionally, enter a display name and description (only Terraform templates).

      • Configure custom properties (only Terraform templates).

      Click Save.

      You can click Edit in the Configure Terraform Template section or Configure OCI Compute Image section to modify the resource information at any time.

    Note:

    • To delete a package, in the App Install Package tab, click Delete Package.

    • Once you've defined a package, you can edit the package information in the Package Versions section under the App Install Package tab. To edit the package information, in the Package Versions section, click action menu icon next to the package version and select Edit. You can also click the package version number to edit the package information.

    • To delete a package version, in the Package Versions section, click action menu icon next to the package version and select Delete.

    • To mark a specific package version as the default version for installation, in the Package Versions section, click action menu icon next to the package version and select Mark As Default.

Configure custom properties

Configure custom properties in the App Install Package tab when you configure a resource.

Click Add Custom Property icon to add a custom property.

  • Enter a name, a display name, select a source (User or Publisher), and select a data type for the custom property.

    If you set the source to User, then the customer should provide the value during installation. If you set the source to Publisher, then specify a value based on the selected data type.

  • Optionally, you can specify whether the property is mandatory or not and provide a hint message.

  • Click Add.

In the Custom Properties section, click Edit to modify the details of a custom property.

In the Custom Properties section, click Delete to delete a custom property.

How do I create multiple package versions?

You can create multiple package versions for OCI install packages.

To create a new version for a package:
  1. Sign in to Oracle Cloud Marketplace Partner Portal.
  2. Click Listings.
    Find the listing on the Started tab and then click Edit.
  3. Click the App Install Package tab.
  4. In the Package Versions section, click action menu icon next to the package version and select New Version.
    A new version of the package is created and displayed in the Package Versions section.
  5. To edit the package information for the new version, click action menu icon next to the package version and select Edit. You can also click the package version number to edit the package information.
    Manage all your package versions from the Package Versions section under the App Install Package tab.
    To view information about a published version of a package, click action menu icon next to the package version and select View Package.
    To publish a package version, click action menu icon next to the package version and select Publish.

Note:

On the Listings page, package versions and corresponding statuses will display for listings that have OCI install packages.

How do I unpublish a package version?

You can unpublish a published version of a package in the Package Versions section under the App Install Package tab.

To unpublish a package version:
  1. Sign in to Oracle Cloud Marketplace Partner Portal.
  2. Click Listings.
    Find the listing on the Started tab and then click Edit.
  3. Click the App Install Package tab.
  4. In the Package Versions section, click action menu icon next to the package version and select Unpublish.
    The package version is unpublished.

Note:

You cannot unpublish the default package version.