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

To publish standard applications as cloud applications, you must first create a custom image for them. This topic describes how to use the online image builder to create a custom image and how to manage images.

Configure the online image builder

Follow these steps to configure the online image builder.

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

On the Create Custom Image panel, on the Enter Basic Information tab, configure the following parameters and click Next.

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

On the Create Custom Image panel, on the Configure Online Builder tab, configure the following parameters and click Next.

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

On the Create Custom Image panel, on the Confirm tab, verify the information. Click Modify to make changes.
If the information is correct, click Confirm and Start.

Create the image

Follow these steps to create the custom image in the online image builder, which opens on a new page.

Environment preparation may take a few minutes. After the environment is ready, a guided dialog box appears. In the dialog box, click Start to Build.
In the application installation phase, do the following:
1. Install applications, add necessary files, and modify the registry as needed, and then click Next.
  You can treat the online image builder as a temporary cloud computer for creating an image. The desktop contains pre-installed common software and the application installers or files you uploaded, which you can use as needed.
2. In the Configure dialog box, on the Configure Cloud Applications tab, create a new cloud application for each installed application, or associate it with an existing one, and then click Next.
  You must complete this step to assign these applications to end users.
3. In the Configure dialog box, on the Configure Image tab, select whether to enable user data compatibility mode, and then click Next.
  Note
  If you do not enable compatibility mode, the listed data, including file directories and registry paths, will be lost. This may cause some applications to malfunction or run incorrectly.
4. In the Configure dialog box, on the Check and Test tab, click Test Now.
In the application verification phase, do the following:
1. In the Select Application for Testing dialog box, find the application to test and click Test in the Actions column.
2. Test the application. If no issues are found, click Test Passed.
  If you find an issue, click Exception Occurred, return to the application list, and follow the on-screen instructions to resolve the issue.
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 to publish the cloud application to, and then click Publish Now.
5. (Optional) In the dialog box that appears, click Publish Now to open the image details page and view the image information and status.

View applications in an image

To view the applications included in an image, follow these steps.

In the left-side navigation pane, click Image.
On the Image page, on the Custom Image tab, find the target image. You can filter images by status or search for an image by its ID or name.
Use one of the following methods to view the list of applications in the image:
- In the Application column of the target image, review the list of applications. If the list is long, hover over More to see all applications.
- Click the ID of the target image. On the image details page, view the complete list of applications in the Associate Cloud Applications section. You can also modify the default startup parameters for the applications in this list.

Quickly create an image

To save time on repetitive configurations, you can create a new image from an existing one.

In the left-side navigation pane, click Image.
On the Image page, on the Custom Image tab, find the target image. You can filter images by status or search for an image by its ID or name.
In the Actions column of the target image, click Create Image and complete the image creation process. For more information, see Configure the online image builder and Create the image.

Add a publishing region

An image's region determines its availability when you publish a delivery group. For example, if you select the China (Hangzhou) region, only images available in the China (Hangzhou) region are visible. To add a publishing region to an image, follow these steps.

In the left-side navigation pane, click Image.
On the Image page, on the Custom Image tab, find the target image. You can filter images by status or search for an image by its ID or name.
In the Actions column of the target image, click Configure Regions.
On the image details page, in the Region list, select the new publishing region, and then click New Region.

Next steps

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