Elastic Desktop Service (EDS) Enterprise supports custom images for creating cloud computers. If the built-in images do not meet your requirements, create a custom image in a virtual machine (VM), upload it to Object Storage Service (OSS), and then import it through the EDS Enterprise console. This topic uses a Windows image as an example.
The import workflow consists of six steps:
Create a VM in VirtualBox
Install Windows on the VM
Configure the system (Cloud Assistant Agent, UAC, firewall)
Export the image from VirtualBox
Upload the image to OSS
Import the image in the EDS Enterprise console
Prerequisites
Before you begin, make sure that you have:
An activated OSS subscription. For more information, see Activate OSS
(If using a RAM user) Permissions to import images to EDS Enterprise and to operate OSS buckets. For more information, see Attach EDS Enterprise system policies to a RAM user
Stable network connectivity (required for VM creation)
Install the following software on your local machine:
| Software | Purpose | Download |
|---|---|---|
| VirtualBox | Create and manage the VM | VirtualBox downloads |
| ossbrowser | Upload the image to OSS | Install ossbrowser 1.0 |
Prepare a Windows ISO image downloaded from the Microsoft official website. Do not use a Windows Home edition ISO.
Limits and requirements
Supported image formats
| Format | Supported | Notes |
|---|---|---|
| RAW | Yes | -- |
| VHD | Yes | Recommended when creating the VM in VirtualBox |
| QCOW2 | Yes | -- |
| ISO | No | Use to install Windows on the VM, then export in a supported format |
| VDI | No | Convert to a supported format before import. See Convert the format of an image |
Images cannot be compressed. Upload the image file in its original, uncompressed format.
Supported operating systems
The console supports importing both Windows and Linux images. This topic describes the process for importing a Windows image.
| OS edition | Supported |
|---|---|
| Windows Pro | Yes |
| Windows Enterprise | Yes |
| Windows Home | No |
The following Windows versions are not supported:
Windows XP
Windows 7
Windows 8
Windows 8.1
Boot mode
Only Basic Input/Output System (BIOS) boot mode is supported. Unified Extensible Firmware Interface (UEFI) boot mode is not supported.
System disk requirements
The system disk must have only the boot partition (drive C). Delete all other partitions, including the recovery partition, before export.
Valid system disk size: 5 to 500 GiB. The value must be greater than the size of the image file.
Recommended disk capacity in VirtualBox: 40 GB. Resize the disk later in the EDS Enterprise console if needed.
Image name constraints
The image name must be 2 to 128 characters and can contain letters, digits, colons (:), periods (.), underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.
Security notice
Alibaba Cloud does not guarantee the security of custom images. Make sure that imported images are safe and free of malware before use.
Procedure
Step 1: Create a VM
This example uses VirtualBox 7.0.4. Steps may vary depending on the version.
Launch VirtualBox.
In the upper-right corner, click New.
Click Name and Operating System, enter a name for the VM, and then select an operating system and version.
Click Hardware and specify the memory size and number of vCPUs.
Important- The memory size and number of vCPUs are irrelevant to the specifications of the cloud computer created from this image. - Do not select Enable EFI. EDS Enterprise does not support EFI boot mode.
Click Hard Disk, select the file location, and then configure the disk capacity and disk type.
- Set the disk capacity to 40 GB. Resize the disk later in the EDS Enterprise console if needed. - Only RAW, VHD, and QCOW2 images can be imported. Select VHD for the Hard Disk File Type and Variant parameter to avoid format conversion later.
Confirm the VM details and click Finish.
Step 2: Install Windows on the VM
Do not install the operating system in UEFI mode. Use BIOS mode.
Launch VirtualBox.
Select the VM and click Start.
Install Windows and complete the setup wizard.
Delete the recovery partition. To delete the recovery partition:
Open DiskPart by entering
diskpartin the search box or by running thediskpartcommand in Windows PowerShell.Run
list diskto view available disks.Run
select disk <disk number>to select the target disk. For example:select disk 0.Run
list volumeto view the disk partitions.If a recovery partition is listed: If deletion fails, use a disk tool to format the disk and then delete the partition.
Run
select volume <partition number>to select it. For example:select volume 1.Run
delete part overrideto delete the partition.
If no recovery partition is listed, skip this step.
WarningThe system disk must have only the boot partition (drive C). If additional partitions exist, the cloud computer created from this image cannot start, and the disk cannot be resized.
Step 3: Configure the system
Install Cloud Assistant Agent Download and install the Cloud Assistant Agent.
Important- After installation, start the agent. Verify that the AliyunService process is in the Running state in Task Manager. - If Aliyun Assist Service fails to start, restart the VM and check the service status again. - For certain Windows versions, Aliyun Assist Service may not start automatically. In this case, save the shortcut of Aliyun Assist Service to the Windows startup folder: - Cloud Assistant path:
C:\ProgramData\aliyun\assist\<version>\aliyun_assist_service.exe- Windows startup folder:C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUpDisable User Account Control (UAC) Open Windows PowerShell and run:
reg.exe add HKLM\Software\MicroSoft\Windows\CurrentVersion\Policies\System /v EnableLUA /t REG_DWORD /d 0 /fDisable the Windows firewall Run the following command:
netsh advfirewall set allprofiles state off
Step 4: Export the image
Locate the image file in the Folder path that was specified when the VM was created.
If the VM was moved to a different path after creation, use the actual current path.
Step 5: Upload the image to OSS
Get the OSS bucket address
Log on to the Elastic Desktop Service Enterprise console.
In the left-side navigation pane, choose Images Center > Images.
On the Images page, click Create Image.
In the Create Image panel, click the Import Image tab.
In the OSS Bucket Address section, click Obtain to get the bucket address, and then click Copy.
Upload the image using ossbrowser
Open ossbrowser and log on with the following settings:
ImportantThe AccessKey pair must belong to the same Alibaba Cloud account or Resource Access Management (RAM) user that is used to log on to the EDS Enterprise console. - Alibaba Cloud account login: Use the AccessKey pair of the Alibaba Cloud account. - RAM user login: Use the AccessKey pair of the RAM user.
Field Value Endpoint Default (Public Cloud) AccessKeyId AccessKey ID of the Alibaba Cloud account or RAM user used to log on to the EDS Enterprise console AccessKeySecret Corresponding AccessKey secret Preset OSS Path The OSS bucket address obtained from the EDS Enterprise console Region The region of the OSS bucket Upload the image file to the bucket.
ImportantOnly RAW, VHD, and QCOW2 formats are accepted. Images cannot be compressed. If the image is in a different format, convert it first. For more information, see Convert the format of an image.
After the upload completes, find the image in ossbrowser and click Address in the Actions column to copy the OSS object address.
Step 6: Import the image
Log on to the Elastic Desktop Service Enterprise console.
In the left-side navigation pane, choose Images Center > Images.
In the upper-left corner of the top navigation bar, select a region.
On the Images page, click Create Image.
In the Create Image panel, click the Import Image tab.
Configure the following parameters:
Parameter Description Image Name A name for the image. The name must be 2 to 128 characters and can contain letters, digits, colons (:), periods (.), underscores (_), and hyphens (-). It must start with a letter and cannot start with http://orhttps://.Region The region of the OSS bucket to which the image was uploaded. OSS Object Address The OSS object address obtained in the previous step. OS The operating system of the image. Select windows or linux. System Disk Size The size of the system disk. Must be greater than the image size. Valid values: 5 to 500 GiB. GPU Driver Select Yes to use this image for GPU-accelerated cloud computers of the Enterprise Graphics type. Protocol Type The protocol type of the image. Use the default value. License Type Bring Your Own License (BYOL): Use your own license. Description A description of the image. Click OK.
After the import completes, the image appears on the Custom Image tab of the Images page.
Next steps
After importing an image, create a cloud computer template that uses the image, and then create cloud computers from the template.
FAQ
"AccessDenied: the bucket you access does not belong to you" error in ossbrowser
This error occurs when the AccessKey pair used to log on to ossbrowser does not match the account used to log on to the EDS Enterprise console.
To fix this, use the AccessKey pair from the same account:
If logged on to the EDS Enterprise console with an Alibaba Cloud account, use the AccessKey pair of that Alibaba Cloud account.
If logged on as a RAM user, use the AccessKey pair of that RAM user.
Using the AccessKey pair of an Alibaba Cloud account is a high-risk operation. Use a RAM user with the AliyunECDFullAccess policy instead. For more information, see Attach EDS Enterprise system policies to a RAM user.Why is the system disk only 40 GiB after I set it to 100 GiB during import?
The recovery partition was not deleted before the image was exported. The system disk must have only the boot partition (drive C). If other partitions exist, the disk cannot be resized.
Do not use a disk partitioning tool to manually allocate disk space in the cloud computer. Doing so makes the cloud computer completely unavailable.