How to create an image - App Streaming - Alibaba Cloud Documentation Center

Before you publish common applications as cloud applications, you must create custom images for the applications. This topic describes how to create a custom image by using an online image builder. This topic also describes how to manage an image.

Configure an online image builder

To configure an online image builder, perform the following steps:

Log on to the App Streaming console.
In the left-side navigation pane, click Images.
On the Images page, click the Custom Image tab and then click Create Image.

In the Enter Basic Information step of the Create Custom Image wizard, configure the parameters and click Next. The following table describes the parameters.

Parameter	Required	Description	Limit	Example
Custom Image Name	Yes	The name of the custom image.	The name must be 2 to 64 characters in length and can contain letters, digits, colons (:), underscores (_), and hyphens (-). The name must start with a letter but cannot start with `http://` or `https://`.	TestImage01
Description	No	The description of the custom image.	The description must be 2 to 256 characters in length and can contain letters, digits, special characters, and spaces. You can use carriage returns to separate lines. The description cannot start with `http://` or `https://`.	Test
Image Type	No	The type of the image.	Valid values: Custom Image System Image	System Image
Basic Image	Yes	The basic image on which the image that you want to create depends.	You can select a system image. You can also select a custom image that you created.	System Image

In the Configure Online Builder step of the Create Custom Image wizard, configure the parameters and click Next. The following table describes the parameters.

Parameter	Required	Description	Limit	Example
Performance Type	Yes	The computing resource type of the online image builder.	Valid values: General (Non-GPU) Graphics (GPU)	General (Non-GPU)
Storage Capacity	Yes	The storage capacity of the online image builder.	Valid values: 40 to 300. Unit: GiB. You can increase the capacity at increments of 10 GiB. The value of this parameter must be greater than or equal to the storage capacity of the basic image that you selected.	100 GiB
File	No	Upload the installation package or file package of the apps that you want to create as cloud apps. The files that you upload are placed on the desktop of the online image builder.	If each file is less than 5 GiB in size, select Local File. If each file is greater than or equal to 5 GiB in size, select OSS URL. No limit is imposed on the file type. You can upload up to five files.	Local File

In the Confirm step of the Create Custom Image wizard, confirm the information. If some information is incorrect, click Modify to modify the information. If the information is correct, click Confirm and Start to open the online image builder.
The online image builder is opened on the page that appears. The environment preparation requires a few minutes to complete.

Create an image

After the online image builder is created, you can perform the following steps on the page that appears to create an image:

In the environment preparation phase, wait a few minutes for the environment to be prepared. In the message that appears, click Start Creation.
In the application installation phase, perform the following operations:
1. Install applications, pre-store files, and modify the registry. Then, click Next.
  An online image builder works as a temporary cloud computer that can be used to create images. On the desktop of the online image builder, you can use pre-installed software and the application installation packages or file packages that you uploaded based on your business requirements.
2. On the Configure Cloud Applications tab of the Configuration dialog box, create cloud applications for the applications that you installed in the image or individually associate existing cloud applications with the image. Then, click Next.
  You can assign the applications to end users only after you perform the preceding operation.
3. On the Configure Image tab of the Configure dialog box, specify whether to enable the user data compatibility mode and click Next.
  Note
  If you do not enable the user data compatibility mode, data listed in the dialog box, including file directories and registry directories, is lost. This may cause exceptions in specific applications.
4. On the Check and Test tab of the Configure dialog box, click Test Now.
  The environment for application verification requires 1 to 5 minutes to be prepared.
In the application verification phase, perform the following operations:
1. In the Select Application for Testing dialog box, find the application that you want to test and click Test in the Actions column.
2. Test the application. If no exception occurs, click Test Passed.
  If an exception occurs, click Exception Occurred. Then, go to the application list and follow the on-screen instructions to fix the exception.
3. After all applications pass the test, click Publish.
4. In the Do you want to publish now? dialog box, select one or more regions where you want to publish the cloud applications and click Publish Now.
5. (Optional) In the dialog box that appears, click Go Now to go to the image details page and view the information and status of the image.

View applications in an image

If you want to view the applications in an image, perform the following steps:

In the left-side navigation pane, click Images.
On the Custom Images tab of the Images page, find the image that you want to manage. You can also filter the image by status or search for the image by ID or name.
Use one of the following methods to view applications in the image:
- View applications in the image in the Application column. If a large number of applications exist in the image, move the pointer over More to view the complete list of applications.
- Click the ID of the image that you want to view. In the Application section of the image details page, view the complete list of applications. You can also modify the default startup parameters of the applications.

Quickly create an image

App Streaming allows you to quickly create an image based on an existing image. This improves configuration efficiency.

In the left-side navigation pane, click Images.
On the Custom Images tab of the Images page, find the image that you want to manage. You can also filter the image by status or search for the image by ID or name.
In the Actions column of the image, click Create Image to create an image. For more information, see Configure an online image builder and Create an image.

Add a region for an image

When you publish a delivery group, the images that you can select vary based on the region that you specify. For example, if you specify the China (Hangzhou) region when you publish a delivery group, you can view only images that reside in the China (Hangzhou) region. To add a region for an image, perform the following steps:

In the left-side navigation pane, click Images.
On the Custom Images tab of the Images page, find the image that you want to manage. You can also filter the image by status or search for the image by ID or name.
In the Actions column of the image, click Configure Region.
In the Regions section of the image details page, select the region that you want to add for the image and click New Region.

Delete an image

If you no longer require an image, you can delete the image.

In the left-side navigation pane, click Images.
On the Custom Images tab of the Images page, find the image that you want to manage. You can also filter the image by status or search for the image by ID or name.
In the Actions column of the image, click Delete. In the message that appears, click OK.

What to do next

After you create an image, you can specify the image and assign the image to specific end users when you publish a delivery group. For information about how to publish a delivery group, see Publish delivery groups.