在Windows下安装与运行EulerLauncher

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

EulerLauncher在Windows上运行需要对接 Hyper-V 虚拟化后端，Hyper-V 是 Microsoft 的硬件虚拟化产品，可以为Windows上的虚拟机提供更为出色的性能。在运行EulerLauncher前，请先检查你的系统是否开启了 Hyper-V，具体检查及开启方法请参考Hyper-V开启指导或其他网络资源。

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

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

Conf

[default]
# 配置日志文件的存储目录
log_dir = D:\eulerlauncher-workdir\logs
# 配置日志等级是否开启Debug
debug = True
# 配置EulerLauncher的工作目录
work_dir = D:\eulerlauncher-workdir
# 配置EulerLauncher的镜像目录，镜像目录为对工作目录的相对目录
image_dir = images
# 配置EulerLauncher的虚拟机文件目录，虚拟机文件目录为对工作目录的相对目录
instance_dir = instances

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

打开 PowerShell 或 Terminal ，准备进行对应的操作。

Windows下退出eulerlauncherd后台进程

当eulerlauncherd.exe运行后，会在操作系统右下角托盘区域生成eulerlauncherd托盘图标，鼠标右键点击托盘图标，并选择 Exit eulerlauncher 即可退出eulerlauncherd后台进程。

镜像操作

获取可用镜像列表。
PowerShell
```
eulerlauncher.exe images

+-----------+----------+--------------+
|   Images  | Location |    Status    |
+-----------+----------+--------------+
| 22.03-LTS |  Remote  | Downloadable |
|   21.09   |  Remote  | Downloadable |
| 2203-load |  Local   |    Ready     |
+-----------+----------+--------------+
```
EulerLauncher镜像有两种位置属性：1）远端镜像 2）本地镜像，只有处于本地且状态为 Ready 的镜像可以直接用来创建虚拟机，位于远端的镜像需要下载后才能够使用；你也可以加载已经预先下载好的本地镜像到EulerLauncher中，具体操作方法可以参考接下来的操作指导。
下载远端镜像。
PowerShell
```
eulerlauncher.exe download-image 23.09

Downloading: 23.09, this might take a while, please check image status with "images" command.
```
镜像下载请求是一个异步请求，具体的下载动作将在后台完成，具体耗时与你的网络情况相关，整体的镜像下载流程包括下载、解压缩、格式转换等相关子流程，在下载过程中可以通过 image 命令随时查看下载进展与镜像状态：
PowerShell
```
eulerlauncher.exe images
```
当镜像状态转变为 Ready 时，表示镜像下载完成，处于 Ready 状态的镜像可被用来创建虚拟机：
PowerShell
```
eulerlauncher.exe images
```
加载本地镜像。
用户也可以加载自定义镜像或预先下载到本地的镜像到EulerLauncher中用于创建自定义虚拟机：
PowerShell
```
eulerlauncher.exe load-image --path {image_file_path} IMAGE_NAME
```
当前支持加载的镜像格式有 xxx.qcow2.xz，xxx.qcow2。
例如：
PowerShell
```
eulerlauncher.exe load-image --path D:\openEuler-23.09-x86_64.qcow2.xz 2309-load

Loading: 2309-load, this might take a while, please check image status with "images" command.
```
将位于 D:\ 目录下的 openEuler-23.09-x86_64.qcow2.xz 加载到EulerLauncher系统中，并命名为 2309-load，与下载命令一样，加载命令也是一个异步命令，用户需要用镜像列表命令查询镜像状态直到显示为 Ready，但相对于直接下载镜像，加载镜像的速度会快很多：
PowerShell
```
eulerlauncher.exe images

......

eulerlauncher images

......
```
删除镜像。

通过下面的命令将镜像从EulerLauncher系统中删除：

PowerShell

eulerlauncher.exe delete-image 2309-load

Image: 2309-load has been successfully deleted.

虚拟机操作

获取虚拟机列表。

Powershell

eulerlauncher.exe list

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

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

登录虚拟机。
若虚拟机已成功分配到IP地址，可以直接使用 SSH 命令进行登录：
PowerShell
```
ssh root@{instance_ip}
```
若使用的是openEuler社区提供的官方镜像，则默认用户为 root 默认密码为 openEuler12#$。
创建虚拟机。
PowerShell
```
eulerlauncher.exe launch --image {image_name} {instance_name}
```
通过--image指定镜像，同时指定虚拟机名称。
删除虚拟机。
PowerShell
```
eulerlauncher.exe delete-instance {instance_name}
```
根据虚拟机名称删除指定的虚拟机。

在Windows下安装与运行EulerLauncher ​

Windows下退出eulerlauncherd后台进程 ​

镜像操作 ​

虚拟机操作 ​

在Windows下安装与运行EulerLauncher

Windows下退出eulerlauncherd后台进程

镜像操作

虚拟机操作