2 Managing Images

1. In SUSE Studio or SUSE Studio Onsite, switch to the Configuration › Appliance tab.

2. Enable the Integrate with SUSE OpenStack Cloud/OpenStack check box.

3. On the Build tab, choose the respective appliance format. It mainly depends on the hypervisor on which you want to use the image—see Section 2.1.2, “Image Requirements Depending on Hypervisor”.

1. Make sure the virt-utils package is installed on the machine used for conversion.

2. Download the image from SUSE Studio.

3. To convert qcow2 to vhd images, use the following command:

   qemu-img convert -O vpc CURRENT_IMAGE_FILE FINAL_IMAGE_FILE.vhd

Upload a disk image using the glance command line tool that is contained in the package python-glanceclient.

Images are owned by projects and can be private (accessible to members of the particular project only) or public (accessible to members of all projects). Private images can also be explicitly shared with other projects, so that members of those projects can access the images, too. Any image uploaded to OpenStack Image will get an owner attribute. By default, ownership is set to the primary project of the user that uploads the image.

Set or modify hypervisor-specific properties with the --property key=value option. This can be done directly during image upload (as shown in the examples below). To change the properties after image upload, refer to Procedure 2.3, “Modifying Image Properties”.

1. In a shell, source the OpenStack RC file for the project that you want to upload an image to. For details, refer to http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html.

2. Upload the image using glance image-create. Find some example commands for different hypervisors below:

   • For KVM:

     glance image-create --name="IMAGE_NAME" --progress \
       --is-public=True --container-format=bare \
       --property architecture=x86_64 \
       --property hypervisor_type=kvm \
       --disk-format=qcow2 < PATH_TO_FINAL_IMAGE_FILE.qcow2

   • For Xen:

     glance image-create --name="IMAGE_NAME" --progress \
       --is-public=True --container-format=bare \
       --property architecture=x86_64 \
       --property hypervisor_type=xen \
       --property vm_mode=xen \
       --disk-format=qcow2 < PATH_TO_FINAL_IMAGE_FILE.qcow2

     

     Note: Value of vm_mode

     For Xen PV image import, use vm_mode=xen, for Xen HVM image import use vm_mode=hvm.

   • For Hyper-V:

     glance image-create --name="IMAGE_NAME" --progress \
       --is-public=True --container-format=bare \
       --property architecture=x86_64 \
       --property hypervisor_type=hyperv \
       --property vm_mode=hvm \
       --disk-format=vhd < PATH_TO_FINAL_IMAGE_FILE.vhd

   • For VMware:

     glance image-create --name="IMAGE_NAME"  --progress \
       --is-public=true --container-format=bare \
       --property vmware_adaptertype="lsiLogic" \
       --property vmware_disktype="preallocated" \
       --property hypervisor_type=vmware \
       --disk-format=vmdk --file PATH_TO_FINAL_IMAGE_FILE.vmdk

     

     Note: Value of vmware_disktype

     Depending on which disk type you use, adjust the value of vmware_disktype accordingly. For an overview of which values to use, refer to http://docs.openstack.org/liberty/config-reference/content/vmware.html, Table 2.8. OpenStack Image Service disk type settings.

   • For Docker:

     Find an image in the Docker registry you want to use and save it locally with docker pull IMAGE_NAME, where IMAGE_NAME is the name of the image in the Docker registry. The same name needs to be used with the --name parameter when uploading the image with the following command:

     docker save IMAGE_NAME | glance image-create \
     --is-public=true --property hypervisor_type=docker \
     --container-format=docker --disk-format=raw --name "IMAGE_NAME"

     

     Important: Docker Images Need to Run a Long-Living Process

     Docker instances will only be able to spawn successfully, when running a long-living process, for example sshd. Such a process can be configured with CMD or ENTRYPOINT in the Docker.

     Alternatively, such a process can be specified on the command line with the glance image property os_command_line.

     glance image-update --property os_command_line='/usr/sbin/sshd -D' \
            IMAGE_ID

   If the image upload has been successful, a message appears, displaying the ID that has been assigned to the image.

1. In a shell, source the OpenStack RC file for the project that you want to upload an image to. For details, refer to http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html.

2. If you do not know the ID or the exact name of the image whose properties you want to modify, look it up with:

   glance image-list

3. Use the glance image-update command to set the properties for architecture, hypervisor type, and virtual machine mode. In the following, find some examples with properties for different hypervisors:

   • For KVM:

     glance image-update IMAGE_ID_OR_NAME \
       --property architecture=x86_64 \
       --property hypervisor_type=kvm

   • For Xen:

     glance image-update IMAGE_ID_OR_NAME \
       --property architecture=x86_64 \
       --property hypervisor_type=xen \
       --property vm_mode=xen

     

     Note: Value of vm_mode

     For Xen PV image import, use vm_mode=xen, for Xen HVM image import use vm_mode=hvm.

   • For VMware:

     glance image-update IMAGE_ID_OR_NAME \
       --property vmware_adaptertype="lsiLogic" \
       --property vmware_disktype="preallocated" \
       --property hypervisor_type=vmware

     

     Note: Value of vmware_disktype

     Depending on which disk type you use, adjust the value of vmware_disktype accordingly. For an overview of which values to use, refer to http://docs.openstack.org/liberty/config-reference/content/vmware.html, Table 2.8. OpenStack Image Service disk type settings.

   • For Hyper-V:

     glance image-update IMAGE_ID_OR_NAME \
       --property architecture=x86_64 \
       --property hypervisor_type=hyperv \
       --property vm_mode=hvm