在Windows下安装与运行EulerLauncher

EulerLauncher当前支持Windows11/10，前往EulerLauncher最新版下载下载Windows版软件包并解压到期望的位置。右键点击 config-env.bat 并选择以管理员身份运行，该脚本将进行环境变量相关的配置，将当前目录添加到系统环境变量 path中，如果使用者掌握如何配置环境变量，或配置脚本出现问题，也可以进行手动配置，将当前脚本所在目录及 qemu-img 子目录添加至系统环境变量 path 中。

EulerLauncher在Windows上运行需要对接 Hyper-V 或者qemu虚拟化后端，Hyper-V 是 Microsoft 的硬件虚拟化产品，可以为Windows上的虚拟机提供更为出色的性能。在运行EulerLauncher前，请先检查你的系统是否开启了 Hyper-V，具体检查及开启方法请参考Hyper-V开启指导或其他网络资源; qmue需要在[qemu官网]下载安装，然后在[openvpn官网] 下载tap-windows网络适配器，修改名称为tap0并设置tap0的ipv4网络信息，然后将tap0设置为主机网络的共享网络，当tap0的ipv4连接显示Internet则说明配置成功，否则配置失败虚拟机无法分配ip地址。

EulerLauncher解压后包含以下几个部分：

eulerlauncherd.exe：EulerLauncher的主进程，是运行在后台的守护进程，负责与各类虚拟化后端交互，管理虚拟机、容器以及镜像的生命周期，eulerlauncherd.exe是运行在后台的守护进程。
eulerlauncher.exe：EulerLauncher的CLI客户端，用户通过该客户端与eulerlauncherd守护进程交互，对虚拟机、镜像等进行相关操作。
eulerlauncherGUI.exe：EulerLauncher的GUI客户端，用户也可以通过该图形化界面客户端与eulerlauncherd守护进程交互，对虚拟机、镜像等进行相关操作。
eulerlauncher.conf：EulerLauncher配置文件，需与eulerlauncherd.exe放置于同一目录下，参考下面配置进行相应配置：

Conf

[default]
log_dir = D:\workdir-test\logs
debug = True
work_dir = D:\workdir-test
image_dir = images
instance_dir = instances
qemu_dir = C:\Progra~1\qemu
pattern = qemu

[vm]
cpu_num = 2
memory = 8G

配置完成后请右键点击eulerlauncherd.exe，选择以管理员身份运行，点击后eulerlauncherd.exe将以守护进程的形式在后台运行。

打开 PowerShell 或 Terminal （对应后文的CLI客户端），或者打开eulerlauncherGUI.exe（对应后文的GUI客户端），准备进行对应的操作。

Windows下退出EulerLauncherd后台进程

当eulerlauncherd.exe运行后，会在操作系统右下角托盘区域生成eulerlauncherd托盘图标：

鼠标右键点击托盘图标，并选择 `Exit EulerLauncher` 即可退出EulerLauncherd后台进程。

镜像操作

获取可用镜像列表：

CLI客户端

PowerShell

eulerlauncher images
+-----------+----------+--------------+
|   Images  | Location |    Status    |
+-----------+----------+--------------+
| 22.03-LTS |  Remote  | Downloadable |
|   21.09   |  Remote  | Downloadable |
| 2203-load |  Local   |    Ready     |
+-----------+----------+--------------+

GUI客户端
左边栏选择镜像管理，右边下方点击刷新，即可获取可用镜像列表，内容包括镜像名称、位置、状态等信息。

EulerLauncher镜像有两种位置属性：1）远端镜像 2）本地镜像，只有处于本地且状态为 Ready 的镜像可以直接用来创建虚拟机，位于远端的镜像需要下载后才能够使用；你也可以加载已经预先下载好的本地镜像到EulerLauncher中，具体操作方法可以参考接下来的操作指导。

下载远端镜像

CLI客户端

PowerShell

eulerlauncher download-image 22.03-LTS

Downloading: 22.03-LTS, this might take a while, please check image status with "images" command.

GUI客户端
左边栏选择镜像管理，右边列表中选中要下载的镜像，然后在右边下方点击下载，即可开始下载镜像，下载过程中点击刷新按钮可以查看当前状态。

镜像下载请求是一个异步请求，具体的下载动作将在后台完成，具体耗时与你的网络情况相关，整体的镜像下载流程包括下载、解压缩、格式转换等相关子流程，在下载过程中可以通过 image 命令（CLI客户端）或者点击刷新（GUI客户端）随时查看下载进展与镜像状态，进度条格式为[downloaded_bytes]/[total_bytes] (percentage)：

CLI客户端

PowerShell

eulerlauncher images

+-----------+----------+------------------------------------+
|   Images  | Location |                Status              |
+-----------+----------+------------------------------------+
| 22.03-LTS |  Remote  |            Downloadable            |
|   21.09   |  Remote  |            Downloadable            |
| 22.03-LTS |  Local   | Downloading: 97.76/ 386.74MB (25%) |
+-----------+----------+------------------------------------+

GUI客户端
点击刷新按钮查看当前状态，列表中也会显示上面的三列。

当镜像状态转变为 Ready 时，表示镜像下载完成，处于 Ready 状态的镜像可被用来创建虚拟机：

CLI客户端

PowerShell

eulerlauncher images

+-----------+----------+--------------+
|   Images  | Location |    Status    |
+-----------+----------+--------------+
| 22.03-LTS |  Remote  | Downloadable |
|   21.09   |  Remote  | Downloadable |
| 22.03-LTS |  Local   |    Ready     |
+-----------+----------+--------------+

GUI客户端
点击刷新按钮查看当前状态，列表中也会显示上面的三列，最后一个值为Ready时说明下载完成。

加载本地镜像

用户也可以加载自定义镜像或预先下载到本地的镜像到EulerLauncher中用于创建自定义虚拟机：

CLI客户端

PowerShell

eulerlauncher load-image --path {image_file_path} IMAGE_NAME

GUI客户端
左边栏选择镜像管理，右边下方点击加载本地镜像，会弹出文件选择窗口，按照弹出窗口的引导选择本地镜像文件，输入镜像名称，即可完成加载。

当前支持加载的镜像格式有 xxx.{qcow2, raw, vmdk, vhd, vhdx, qcow, vdi}.[xz]

例如：

CLI客户端

PowerShell

eulerlauncher load-image --path D:\openEuler-22.03-LTS-x86_64.qcow2.xz 2203-load

Loading: 2203-load, this might take a while, please check image status with "images" command.

将位于 D:\ 目录下的 openEuler-22.03-LTS-x86_64.qcow2.xz 加载到OmniVirt系统中，并命名为 2203-load，与下载命令一样，加载命令也是一个异步命令，用户需要用镜像列表命令查询镜像状态直到显示为 Ready, 但相对于直接下载镜像，加载镜像的速度会快很多：

PowerShell

eulerlauncher images

+-----------+----------+----------------------------+
|   Images  | Location |           Status           |
+-----------+----------+----------------------------+
| 22.03-LTS |  Remote  |       Downloadable         |
|   21.09   |  Remote  |       Downloadable         |
| 2203-load |  Local   |   Loading: (24.00/100%)    |
+-----------+----------+----------------------------+

eulerlauncher images

+-----------+----------+--------------+
|   Images  | Location |    Status    |
+-----------+----------+--------------+
| 22.03-LTS |  Remote  | Downloadable |
|   21.09   |  Remote  | Downloadable |
| 2203-load |  Local   |     Ready    |
+-----------+----------+--------------+

GUI客户端
同样以上面的例子为例，点击加载本地镜像，在文件选择窗口内选择D:\openEuler-22.03-LTS-x86_64.qcow2.xz，镜像名称输入2203-load，点击确定，即可完成加载。获取加载情况请点击刷新按钮查看。

删除镜像：

CLI客户端
通过下面的命令将镜像从EulerLauncher系统中删除：
PowerShell
eulerlauncher delete-image 2203-load

Image: 2203-load has been successfully deleted.

GUI客户端
左边栏选择镜像管理，右边列表中选中要删除的镜像，然后在右边下方点击删除镜像，即可删除镜像。

虚拟机操作

获取虚拟机列表：

CLI客户端

Powershell

eulerlauncher list

+----------+-----------+---------+---------------+
|   Name   |   Image   |  State  |       IP      |
+----------+-----------+---------+---------------+
|   test1  | 2203-load | Running | 172.22.57.220 |
+----------+-----------+---------+---------------+
|   test2  | 2203-load | Running |      N/A      |
+----------+-----------+---------+---------------+

GUI客户端
左边栏选择虚拟机管理，右边上方点击刷新，即可获取虚拟机列表，内容包括虚拟机名称、镜像、状态、IP等信息。

若虚拟机IP地址显示为 N/A ，若这台虚拟机的状态为 Running 则表示这台虚拟机为新创建的虚拟机，网络还未配置完成，网络配置过程大概需要若干秒，请稍后重新尝试获取相关虚拟机信息。

登录虚拟机：

CLI客户端
若虚拟机已成功分配到IP地址，可以直接使用 SSH 命令进行登录：
PowerShell
ssh root@{instance_ip}

GUI客户端
左边栏选择虚拟机管理，右边列表中选中要登录的虚拟机，然后在右边下方点击连接，界面会自动跳转到虚拟机连接。虚拟机连接界面上方左侧会显示虚拟机的各种信息，上方右侧有三个按钮，提供两种SSH连接方式。
选择调用终端进行SSH连接，则会调用系统终端进行SSH连接，会自动弹出终端窗口，在里面操作即可，关闭终端窗口即可断开连接（最好先输入exit指令）。
选择在GUI中进行SSH连接，如果使用导入的镜像则需要在弹出窗口中输入密码，连接成功则会在界面下方的文本框内显示信息，在输入栏中输入命令后按输入条右侧的Send或者按键盘上的Enter键即可发送命令。要断开连接，可以点击上方右侧的断开连接按钮，或者在输入栏中输入exit命令，还可以在左边栏直接切换到其他页面（不推荐），这三种方式均可断开连接。

若使用的是openEuler社区提供的官方镜像，则默认用户为 root 默认密码为 openEuler12#$

创建虚拟机

CLI客户端
PowerShell
eulerlauncher launch --image {image_name} {instance_name}
通过 --image 指定镜像，同时指定虚拟机名称，EulerLauncher会根据所指定的镜像默认创建一个规格为2U4G的openEuler虚拟机。

GUI客户端
左边栏选择虚拟机管理，右边下方点击创建虚拟机，弹出窗口中选择镜像，输入虚拟机名称，点击确定，即可创建虚拟机，创建过程中请耐心等待请等待弹窗消失。

删除虚拟机

CLI客户端
PowerShell
eulerlauncher delete-instance {instance_name}
根据虚拟机名称删除指定的虚拟机。

GUI客户端
左边栏选择虚拟机管理，右边列表中选中要删除的虚拟机，然后在右边下方点击删除虚拟机，即可删除虚拟机。

为虚拟机打快照，并导出为镜像

CLI客户端
Shell
eulerlauncher take-snapshot --snapshot_name snap --export_path path vm_name
通过--snapshot_name指定快照名称，--export_path指定导出镜像存放位置，vm_name为虚拟机名。

GUI客户端
左边栏选择虚拟机管理，右边列表中选中要打快照的虚拟机，然后在右边下方点击生成快照，弹出窗口中选择文件存放位置，输入快照名称，点击确定，即可完成快照，其会存放在选择的路径下。

将虚拟机导出为主流编程框架开发镜像

CLI客户端
Shell
eulerlauncher export-development-image --image_name image --export_path path vm_name
通过--image_name指定导出镜像名称，--export_path指定导出镜像存放位置，vm_name为虚拟机名，默认导出为Python/Go/Java主流编程框架开发镜像。

GUI客户端
左边栏选择虚拟机管理，右边列表中选中要导出的虚拟机，然后在右边下方点击导出为开发镜像，弹出窗口中选择文件存放位置，输入镜像名称，点击确定，即可完成导出，其会存放在选择的路径下。

在Windows下安装与运行EulerLauncher ​

Windows下退出EulerLauncherd后台进程 ​

镜像操作 ​

虚拟机操作 ​

在Windows下安装与运行EulerLauncher

Windows下退出EulerLauncherd后台进程

镜像操作

虚拟机操作