Creating a Stack from a Zip File

• Console
• CLI
• API

• 1. On the Stacks list page, select Create stack. If you need help finding the list page or the stack, see Listing Stacks.
  2. On the Create stack page, under Choose the origin of the Terraform configuration, select My configuration.
  3. Select .Zip file and add the revised Terraform configuration.
     You can either drag the file onto the dialog's control or select Browse and navigate to the location of the file or folder.
     The page is populated with information contained in the Terraform configuration.
  4. (Optional) To use custom providers, select Use custom providers and then select the bucket that contains the custom provider.
  5. (Optional) Edit the default stack name and enter a stack description. Avoid entering confidential information.
  6. Select the compartment that you want to store the stack in.
  7. For Terraform version, select the version used by the Terraform configuration.
  8. (Optional) Under Tags, add one or more tags to the stack.
     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.
  9. Select Next.
  10. In the Configure variables panel, review the variables listed from the Terraform configuration and change as needed.
      Important
      
      Don't add your private key or other confidential information to configuration variables.
  11. Select Next.
  12. In the Review panel, verify the stack configuration.
  13. (Optional) To automatically provision resources on creation of the stack, select Run apply.
  14. Select Create.

  The stack is created and its details page opens.

  If you selected Run apply, then Resource Manager runs the apply action on the new stack.

• Note
  
  On Windows, be sure the zip file and variables.json files are in the same directory from which you're running the CLI. The CLI currently has a limitation on Windows that prevents correct handling of the files if either one is in a subdirectory.

  Use the oci resource-manager stack create command and required parameters to create a stack from a local zip file.

  oci resource-manager stack create [OPTIONS]

  For a complete list of parameters and values for CLI commands, see the Command Line Reference for Resource Manager.

  Example Request

  oci resource-manager stack create --compartment-id ocid1.tenancy.oc1..uniqueid --config-source vcn.zip --variables file://variables.json --display-name "My Example Stack" --description "My Tutorial to Create a VCN" --working-directory ""

  Example Response

  {
    "data": {
      config-source": 
      {
        "working-directory": null,
        "config-source-type": "ZIP_UPLOAD"
      },
      "defined-tags": {},
      "description": "My Tutorial to Create a VCN",
      "display-name": "My Example Stack",
      "freeform-tags": {},
      "id": "ocid1.ormstack.oc1..uniqueid",
      "lifecycle-state": "ACTIVE",
      "time-created": "2019-04-03T18:26:56.299000+00:00",
      "variables": 
      {
        "compartment_ocid": "ocid1.compartment.oc1..uniqueid", 
        "region": "us-phoenix-1"
      }
    }
  }

• Use the CreateStack operation to create a stack from a local zip file.

  For an example of the configSource part of the request, see CreateZipUploadConfigSourceDetails.

  Example request

  POST /20180917/stacks
  Host: resourcemanager.us-phoenix-1.oraclecloud.com
  <authorization and other headers>
  {
    "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
    "terraformVersion": "0.12.x",
    "displayName": "My Zip Configuration",
    "configSource": {
      "configSourceType": "ZIP_UPLOAD",
      "zipFileBase64Encoded": "<zip_file_content_encoded_in_base64_format>",
      "workingDirectory": "<file_path_to_directory>"
    },
  }