Creating an Image from an Instance

On Compute Cloud@Customer, you can create a custom image of a compute instance's boot disk and use that custom image to create other compute instances. Instances that you create from this image include the customizations, configuration, and software that were installed on the boot disk when you created the image.

Custom images don't include the data from any attached block volumes.

After the new custom image reaches the Available state, you can use it to create new instances. See Creating an Instance.

Limitations and Considerations

  • Certain IP addresses are reserved for Compute Cloud@Customer use and can not be used in your address numbering scheme. For details, refer to Reserved Network Resources.

  • When you create an image of an instance, the instance must be in the stopped state. After the custom image is created, you can restart the instance.

  • You can't create extra custom images of a compute instance while the compute instance is engaged in the image creation process. You can, however, create images of different compute instances at the same time.

  • Custom images are available to all users authorized for the compartment in which the image was created.

  • Custom images inherit the compatible shapes that are set by default from the base image.

Avoid entering confidential information in names.

    1. Click Compute Cloud@Customer Console Dashboard, then click Compute/View Instances.

    2. At the top of the page, select the compartment that contains the instance you plan to use.
    3. Click the name of the instance that you want to use as the basis for the custom image.

    4. Ensure that the instance is in the Stopped state:

      1. On the details page for the instance, click Controls (upper right corner), and then click Stop.

      2. Wait for the instance status to change to Stopped. The status is displayed above the icon of the object.

    5. Click Controls and then click Create Custom Image.

    6. In the Create Image From Instance dialog box, enter the following information:

      • Name: Replace the name with the name you want for the image.

      • Create in Compartment: Select the compartment where the image will be stored.

    7. Click Create Custom Image.

      The status of the instance changes to Creating Image.

    8. Monitor the image creation progress.

      The time required to create the custom image depends on the size of the instance's boot volume.

      To monitor the progress, on the navigation menu, click Compute and then click Custom Images. Select the correct compartment, and click the image name in the list. On the details page for the image, under Resources click Work Requests.

    9. (Optional) Restart the instance.

      When the instance status changes from Creating Image to Stopped, you can restart the instance.

  • Use the oci compute image create command and required parameters to create an image from an instance.

    oci compute image create [OPTIONS]

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

  • Use the CreateImage operation to create an image from 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.