13 Star 15 Fork 14

openEuler / eulerlauncher

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
win-user-manual.md 8.56 KB
一键复制 编辑 原始数据 按行查看 历史

在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守护进程交互,对虚拟机、镜像等进行相关操作。
  • eulerlauncher.conf:EulerLauncher配置文件,需与eulerlauncherd.exe放置于同一目录下,参考下面配置进行相应配置:
[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将以守护进程的形式在后台运行。

打开 PowerShellTerminal ,准备进行对应的操作。

Windows下退出EulerLauncherd后台进程

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

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

镜像操作

  1. 获取可用镜像列表:
eulerlauncher images

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

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

  1. 下载远端镜像
eulerlauncher download-image 22.03-LTS

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

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

eulerlauncher images

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

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

eulerlauncher images

+-----------+----------+--------------+
|   Images  | Location |    Status    |
+-----------+----------+--------------+
| 22.03-LTS |  Remote  | Downloadable |
|   21.09   |  Remote  | Downloadable |
| 22.03-LTS |  Local   |    Ready     |
+-----------+----------+--------------+
  1. 加载本地镜像

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

eulerlauncher load-image --path {image_file_path} IMAGE_NAME

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

例如:

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, 但相对于直接下载镜像,加载镜像的速度会快很多:

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    |
+-----------+----------+--------------+
  1. 删除镜像:

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

eulerlauncher delete-image 2203-load

Image: 2203-load has been successfully deleted.

虚拟机操作

  1. 获取虚拟机列表:
eulerlauncher list

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

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

  1. 登录虚拟机:

若虚拟机已成功分配到IP地址,可以直接使用 SSH 命令进行登录:

ssh root@{instance_ip}

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

  1. 创建虚拟机
eulerlauncher launch --image {image_name} {instance_name}

通过 --image 指定镜像,同时指定虚拟机名称,EulerLauncher会根据所指定的镜像默认创建一个规格为2U4G的openEuler虚拟机。

  1. 删除虚拟机
eulerlauncher delete-instance {instance_name}

根据虚拟机名称删除指定的虚拟机。

  1. 为虚拟机打快照,并导出为镜像
eulerlauncher take-snapshot --snapshot_name snap --export_path path vm_name

通过--snapshot_name指定快照名称,--export_path指定导出镜像存放位置,vm_name为虚拟机名。

  1. 将虚拟机导出为主流编程框架开发镜像
eulerlauncher export-development-image --image_name image --export_path path vm_name

通过--image_name指定导出镜像名称,--export_path指定导出镜像存放位置,vm_name为虚拟机名,默认导出为Python/Go/Java主流编程框架开发镜像。

1
https://gitee.com/openeuler/eulerlauncher.git
git@gitee.com:openeuler/eulerlauncher.git
openeuler
eulerlauncher
eulerlauncher
master

搜索帮助