Uploading Image Files to Oracle Cloud Infrastructure Object Storage Classic

After building your private images, to use the images to launch instances in Compute Classic, you must first upload the image files to Oracle Cloud Infrastructure Object Storage Classic.

Oracle Cloud Infrastructure Object Storage Classic provides an enterprise-grade, large-scale, object storage solution for files and unstructured data. When your Compute Classic account was activated, an Oracle Cloud Infrastructure Object Storage Classic instance would have been provisioned automatically.

Note:

For information about the operating systems that you can use to build machine images, see Guidelines for Building Private Images.

Tip:

You can also upload image files to Oracle Cloud Storage Service by using the uploadcli tool. With this tool, you can upload multiple files by using a single command. See the Uploading a Machine Image to Oracle Cloud Infrastructure Object Storage Classic tutorial.

Prerequisites

  • Make sure that the .tar.gz file that you want to upload is available on the host from which you’re accessing the Compute Classic web console.

  • Make sure that you have the required role to upload images to Oracle Cloud Infrastructure Object Storage Classic.
    • If this is the first image being uploaded to Oracle Cloud Infrastructure Object Storage Classic, then you must have the Storage Administrator role.

    • If one or more images have previously been uploaded to Oracle Cloud Infrastructure Object Storage Classic, then any user with the Storage_ReadWriteGroup role can upload images.

    If you don’t have the required role or aren’t sure, then ask your service administrator to ensure that you have the required role in Oracle Cloud My Services. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

  • Make sure that a replication policy has been set for your Oracle Cloud Infrastructure Object Storage Classicinstance. See Selecting a Replication Policy for Oracle Cloud Infrastructure Object Storage Classic in Using Oracle Cloud Infrastructure Object Storage Classic.

Procedure

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Images tab.
    The Private Images page is displayed.
  3. Click Upload Image.
  4. Enter your password, and then click Continue.
    The Upload Image page is displayed in a new tab.
  5. In the Image File field, browse to select the .tar.gz image file that you want to upload.
    The path where the image file will be uploaded and the size of the image are displayed.
  6. In the Target Object field, enter the name of the object that the image file should be stored as in Oracle Cloud Infrastructure Object Storage Classic.
    By default, this field is filled automatically with the name of the selected image file. You can use that name or enter a new name. The name must be unique and it must end with .tar.gz (example: myImage.tar.gz).
    Note this name. You’ll need it later when you want to add a machine image to Compute Classic using the POST /machineimage/ HTTP request or delete the image file from Oracle Cloud Infrastructure Object Storage Classic.
  7. Click Upload.

    Note:

    If an error message is displayed, check whether a replication policy has been selected for your Oracle Cloud Infrastructure Object Storage Classic instance. See Selecting a Replication Policy for Oracle Cloud Infrastructure Object Storage Classic in Using Oracle Cloud Infrastructure Object Storage Classic.

    If an image file already exists with the name specified in the Target Object field, you’re prompted to enter another name. If you proceed with the upload without changing the name, the existing image file is overwritten.
    The progress indicator shows the percentage of the upload operation that is complete. The time taken to upload the file varies depending the size of the image file. Do not close this browser window while the upload is still in progress.
    If you want to cancel the upload, click Cancel.

    After the file is uploaded to the compute_images container in Oracle Cloud Storage Service, a message is displayed to indicate that the image file was successfully uploaded. If you want to upload another image file, click Upload More.

To launch instances using the image files that you uploaded to Oracle Cloud Infrastructure Object Storage Classic, you must register the machine images in Compute Classic. See Registering a Machine Image in Compute Classic.

Tip:

By default, any user in your Oracle Cloud Infrastructure Object Storage Classic account who has the Storage_ReadWriteGroup role has full read and write access to the compute_images container in which you store image files. To restrict access to the compute_images container, create a custom role in Oracle Cloud My Services, assign that role to only the users who must be allowed to access the compute_images container, and then assign the role to the X-Container-Write ACL of the container. See the Restrict Read and Write Access to Containers by Using the REST API tutorial.