Oracle Cloud Infrastructure Documentation

Managing Custom Images

Oracle Cloud Infrastructure uses images to launch instances. You specify an image to use when you launch an instance.

You can create a custom image of a bare metal instance's boot disk and use it to launch other instances. Instances you launch from your image include the customizations, configuration, and software installed when you created the image.

For details on Windows images, see Creating Windows Custom Images.

Custom images do not include the data from any attached block volumes. For information about backing up volumes, see Backing Up a Volume.

Tip

Oracle Cloud Infrastructure runs on Oracle's high-quality Sun servers. However, any hardware can experience a failure. Follow industry-wide hardware failure best practices to ensure the resilience of your solution. Some best practices include:

  • Design your system with redundant compute nodes in different availability domains to support fail-over capability.
  • Create a custom image of your system drive each time you change the image.
  • Back up your data drives, or sync to spare drives, regularly.

If you experience a hardware failure and have followed these practices, you can terminate the failed instance, launch your custom image to create a new instance, and then apply the backup data.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. you should work in.

For administrators: The policy in Let users launch instances includes the ability to create and manage images. If the specified group doesn't need to launch instances or attach volumes, you could simplify that policy to include only manage instance-family, and remove the statements involving volume-family and virtual-network-family.

Tip

When users create a custom image from an instance or launch an instance from a custom image, the instance and image don't have to be in the same A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization.. However, users must have access to both compartments.

If you're new to policies, see Getting Started with Policies and Common Policies. If you want to dig deeper into writing policies for instances, cloud networks, or other Core Services API resources, see Details for the Core Services.

Limitations and Considerations

  • Certain IP addresses are reserved for Oracle Cloud Infrastructure use and may not be used in your address numbering scheme. See IP Addresses Reserved for Use by Oracle for more information.
  • Before you create a custom image of an instance, you must disconnect all iSCSI attachments and remove all iscsid node configurations from the instance. For steps, see Disconnecting From a Volume.

  • When you create an image of a running instance, the instance shuts down and remains unavailable for several minutes. The instance restarts when the process completes.
  • You cannot create additional custom images of an instance while the instance is engaged in the image creation process. When you start to create a custom image, the system implements a 20-minute timeout, during which you cannot create another image of the same instance. You can, however, create images of different instances at the same time.
  • Custom images are available to all users authorized for the A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. in which the image was created.
  • The maximum size for creating a custom image is 300 GB.
  • The maximum size for importing a custom image is 300 GB.
  • The maximum size for custom exported images is 50 GB.
  • You can create a maximum of 25 custom images per region per root compartment.
  • You cannot create an image of an Oracle Database instance.
  • Windows custom images cannot be exported or downloaded.
  • If you use a custom image and update the OS kernel on your instance, you must also upload the update to the network drive. See OS Kernel Updates for more information.

For information about how to deploy any version of any operating system that is supported by the Oracle Cloud Infrastructure hardware, see Bring Your Own Image (BYOI).

X5 and X7 Compatibility for Custom Images

Oracle X5 and X7 servers have different host hardware. As a result, using an X5 image on an X7 bare metal or virtual machine (VM) instance may not work without additional modifications. Oracle Cloud Infrastructure recommends for X7 hosts that you use the Oracle-provided images for X7. See Oracle-Provided Image Release Notes for more information about which images support X7. These images have been explicitly created and tested with the new hardware.

If you do attempt to use an existing X5 image on X7 hardware, note that CentOS 6 and all Windows versions are not cross-compatible.

Oracle Linux, Ubuntu 16.04, Ubuntu 14.04, and CentOS 7 are cross-compatible, however you need to update the kernel to the most recent version to install the latest device drivers. To do so, run the following commands from a terminal session:

  • Oracle Linux
    yum update
  • CentOS 7
    yum update
  • Ubuntu 16.04
    apt-get update
    apt-get dist-upgrade
  • Ubuntu 14.04
    apt-get update
    apt-get dist-upgrade
    apt-get install linux-hwe-generic-trusty

The primary device drivers that are different between X5 and X7 hosts are:

  • Network device drivers
  • NVMe drive device drivers
  • GPU device drivers

Additional updates may be required depending on how you have customized the image.

Using the Console

To access the Console, you must use a supported browser.

To create a custom image
To launch an instance from a custom image
To edit custom image details
To manage tags for a custom image
To delete a custom image

Using the API

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.

Use the following operations to manage custom images: