Creating a Private Catalog Item

• Console
• CLI
• API

• 1. On the Private catalog list page, select Add catalog item. If you need help finding the list page, see Listing Private Catalog Items.
  2. Enter the following information:
     • Name: Enter a unique name for the catalog item. Avoid entering confidential information.
     • Short description: Enter a short description of the catalog item for easy identification. Avoid entering confidential information.
     • Long description (overview): Provide a long description of the catalog item. For example, an overview and architecture diagram of the catalog item.
     • Initial version: Specify the base version of the catalog item in x.y.z format.
     • Version description: Add version description.
     • Type: Select one of the following options:
       • Terraform package: To automate provisioning of OCI resources, use Terraform package sources supported with Resource Manager. Create a Terraform file with Terraform domain-specific language format (.tf) and make a ZIP file or PAR URL link with Terraform code. This ZIP file is used with Resource Manager to provision your OCI resources. To add the ZIP file, skip to step 3. For information about Terraform configuration format, see Authoring Configurations.
       • Non-terraform package: Use scripting languages such as BASH to write scripts that can automate the provisioning and management of OCI resources and add the script file. To add the file, skip to step 4.
       • Configuration file: Create a JSON configuration file that specifies the OCI resources you want to provision, such as Compute instances and add the configuration file. To add the configuration file, skip to step 5.
     • Create in compartment: Verify the compartment that you want to create the catalog item in. Select another compartment as needed.
  3. If you selected Terraform package for type, under Add resource, select an option to add resources to the catalog item:
     • Upload: If you plan to upload the Terraform file locally, then bundle all files into a .zip file. Drag the ZIP file from the file system to the Drop a file box, or browse for the file. Then, enter the working directory, which is the directory in the ZIP file where the Terraform file exists, if applicable.
     • Select from Object Storage bucket: Select the bucket compartment and the Object Storage bucket that contains the Terraform file, and select the specific Terraform package (ZIP). Then, enter the working directory, which is the directory in the ZIP file where the Terraform file exists, if applicable.
     • URL: If you have created a PAR URL link of the Terraform package in Object Storage, enter the URL link. Then, enter the working directory, which is the directory in the ZIP file where the Terraform file exists, if applicable.
     • External repo: If you store Terraform configurations using configuration source providers in Resource Manager such as Git, select the configuration source provider compartment that contains the Terraform file, the configuration source provider from Resource Manager, repository URL, and the branch name of the repository that contains the configuration file. Then, enter the working directory, which is the directory in the ZIP file where the Terraform file exists, if applicable. For information about configuration source providers, see Managing Configuration Source Providers.
  4. If you selected Non-terraform package for type, under Add resource, select an option to add resources to the catalog item:
     • Select from Object Storage bucket: Select the bucket compartment and the Object Storage bucket that contains the script file, and select the specific BASH file. Then, enter the working directory, which is the directory in the ZIP file where the Terraform script file exists, if applicable.
     • URL: If you have created a PAR URL link of the BASH script file in Object Storage, enter the URL link. Then, enter the working directory, which is the directory in the ZIP file where the script file exists, if applicable.
  5. If you selected Configuration file for type, under Add resource, select an option to add resources to the catalog item:
     • Select from Object Storage bucket: Select the bucket compartment and the Object Storage bucket that contains Terraform JSON configuration file, and select the specific ZIP file. Then, enter the working directory, which is the directory in the ZIP file where the Terraform JSON configuration file exists, if applicable.
     • URL: If you have created a PAR URL link of the Terraform JSON configuration file in Object Storage, enter the URL link. Then, enter the working directory, which is the directory in the ZIP file where the Terraform JSON configuration file exists, if applicable.
  6. (Optional) In the Tags section, add one or more tags to the catalog item. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
  7. Select Create.

  The creation process begins, and the Versions tab of the catalog item's details page opens to display the status of the current version of the catalog item. Select the version to find more information of the catalog item.

• Use the oci fleet-apps-management fleet-apps-management-catalog catalog-item create command and required parameters to create a private catalog item:

  oci fleet-apps-management fleet-apps-management-catalog catalog-item create --compartment-id <compartment_OCID> -config-source-type <text> --description <text> --display-name <text> --package-type <text> [OPTIONS]

  For a complete list of flags and variable options for Fleet Application Management CLI commands, see the CLI for Fleet Application Management.

• Run the CreateCatalogItem operation to create a private catalog item.