Provisioning Using Private Catalogs

Provision resources using private catalog items in Fleet Application Management.

To provision OCI resources through a runbook, you can use a private Terraform catalog item with a corresponding configuration catalog item. See the following steps to achieve this:
  1. Create a private Terraform catalog item
    • Create a standard Terraform package to define OCI infrastructure as code using the OCI Provider (Oracle Cloud Infrastructure Provider). For guidance, see the tutorials (Get Started - OCI). A simple Terraform package includes:
      • A ⁠main.tf ⁠ file containing the infrastructure as code definitions.
      • A ⁠variables.tf⁠ file with defined external variables.
    • Upload this package to Object Storage as a folder or a ZIP file.
    • (Optional) Create a PAR to ZIP to specify the URI in the catalog item instead of selecting the folder from the Object Storage bucket.
    • Create a private catalog item for the Terraform package using the Object Storage bucket or URI.
  2. Create a private configuration catalog item
    • Create a ⁠conf.json ⁠ file outlined in step 4 of creating a task. In this file, the keys are variable names defined in the ⁠variables.tf ⁠file, and the values are the corresponding variable values.
    • Upload the configuration package to Object Storage as a folder or a ZIP file.
    • (Optional) Create a PAR to ZIP to specify the URI in the catalog item instead of selecting the folder from the bucket.
    • Create a private catalog item for the Terraform package using the Object Storage bucket or URI.
  3. Create a runbook task: Create a runbook that consists of a provisioning task referencing the Terraform and configuration catalog items. For more details, see Creating a Task.
  4. ⁠Schedule the runbook for execution: Use a scheduler to set a schedule for the runbook's execution.
  5. Monitor deployments and deployed resources: After executing the runbook, you can observe the deployments and the deployed resources under Provisions.