Oracle Cloud Infrastructure Documentation

Creating an Instance Configuration from an Instance

On Compute Cloud@Customer you can create an instance configuration by using the configuration information from an existing compute instance (a template instance).

Note the following when you use a template instance to create an instance configuration:

  • The new instance configuration doesn't include any information from the boot volume of the template instance. For example, installed applications, binaries, and files that are on the template instance aren't included in the instance configuration.

    Use the following procedure to create an instance configuration that includes the custom setup from the template instance:

    1. Create a custom image from the template instance. See Creating an Image from an Instance.

    2. Use the custom image to create a new instance. See Creating an Instance.

    3. Use the instance that you created in the preceding step as the template to create the instance configuration.

  • Instances with replicated boot volumes can't be used as template instances for an instance configuration. For example, instances that are included in a disaster recovery configuration can't be used as template instances for an instance configuration.

  • The instance configuration doesn't include the contents of any block volumes that are attached to the template instance.

  • Instances that are created from this new instance configuration are placed in the same compartment as the template instance.

To include block volumes or secondary VNICs in the configuration, or to specify the compartment where new instances will be created, create the instance configuration as described in Creating an Instance Configuration by Entering Configuration Values.

    1. In the Compute Cloud@Customer Console navigation menu, click Compute, then click Instances.
    2. At the top of the page, select the compartment that contains the instance that you want to use to create the new instance configuration.

    3. Click the name of the instance that you want to use to create the new instance configuration.

    4. On the instance details page, click Controls (upper right corner), then click Create Instance Configuration.

    5. In the Create Instance Configuration dialog box, enter the following information:

      • Name: Enter a name for the instance configuration.

      • Compartment: Select the compartment where this instance configuration will be created.

      • Tagging: (Optional) Add one or more tags to this resource. Tags can also be applied later. For more information about tagging resources, see Resource Tags.

    6. Click Create Instance Configuration.

  • Use the oci compute-management instance-configuration create-from-instance command and required parameters to create an instance configuration by using the configuration information from an existing compute instance.

    oci compute-management instance-configuration create-from-instance --compartment-id <compartment_OCID> --instance-id <instance_OCID> --display-name <IC_name>

    The specified compartment is where this instance configuration is created.

    The specified display name is the name of the instance configuration. If you don't provide a value for the --display-name option, the default name of the instance configuration is instanceconfigurationYYYYMMDDhhmmss, where YYYYMMDDhhmmss is the creation date and time.

    The output of this command is the same as the output of the instance-configuration get command.

    For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  • Use the CreateInstanceConfiguration operation to create an instance configuration using an instance.

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.