长期支持版本

    在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放置于同一目录下,参考下面配置进行相应配置:
    [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将以守护进程的形式在后台运行。

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

    Windows下退出eulerlauncherd后台进程

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

    镜像操作

    1. 获取可用镜像列表。
    eulerlauncher.exe images
    
    +-----------+----------+--------------+
    |   Images  | Location |    Status    |
    +-----------+----------+--------------+
    | 22.03-LTS |  Remote  | Downloadable |
    |   21.09   |  Remote  | Downloadable |
    | 2203-load |  Local   |    Ready     |
    +-----------+----------+--------------+
    

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

    1. 下载远端镜像。
    eulerlauncher.exe download-image 22.03-LTS
    
    Downloading: 22.03-LTS, this might take a while, please check image status with "images" command.
    

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

    eulerlauncher.exe images
    
    +-----------+----------+--------------+
    |   Images  | Location |    Status    |
    +-----------+----------+--------------+
    | 22.03-LTS |  Remote  | Downloadable |
    |   21.09   |  Remote  | Downloadable |
    | 22.03-LTS |  Local   | Downloading  |
    +-----------+----------+--------------+
    

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

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

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

    eulerlauncher.exe load-image --path {image_file_path} IMAGE_NAME
    

    当前支持加载的镜像格式有 xxx.qcow2.xzxxx.qcow2

    例如:

    eulerlauncher.exe 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 加载到EulerLauncher系统中,并命名为 2203-load,与下载命令一样,加载命令也是一个异步命令,用户需要用镜像列表命令查询镜像状态直到显示为 Ready, 但相对于直接下载镜像,加载镜像的速度会快很多:

    eulerlauncher.exe images
    
    +-----------+----------+--------------+
    |   Images  | Location |    Status    |
    +-----------+----------+--------------+
    | 22.03-LTS |  Remote  | Downloadable |
    |   21.09   |  Remote  | Downloadable |
    | 2203-load |  Local   |   Loading    |
    +-----------+----------+--------------+
    
    eulerlauncher images
    
    +-----------+----------+--------------+
    |   Images  | Location |    Status    |
    +-----------+----------+--------------+
    | 22.03-LTS |  Remote  | Downloadable |
    |   21.09   |  Remote  | Downloadable |
    | 2203-load |  Local   |     Ready    |
    +-----------+----------+--------------+
    
    1. 删除镜像。

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

    eulerlauncher.exe delete-image 2203-load
    
    Image: 2203-load has been successfully deleted.
    

    虚拟机操作

    1. 获取虚拟机列表。
    eulerlauncher.exe 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.exe launch --image {image_name} {instance_name}
    

    通过--image指定镜像,同时指定虚拟机名称。

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

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

    文档捉虫

    “有虫”文档片段

    问题描述

    提交类型 issue

    有点复杂...

    找人问问吧。

    PR

    小问题,全程线上修改...

    一键搞定!

    问题类型
    规范和低错类

    ● 错别字或拼写错误;标点符号使用错误;

    ● 链接错误、空单元格、格式错误;

    ● 英文中包含中文字符;

    ● 界面和描述不一致,但不影响操作;

    ● 表述不通顺,但不影响理解;

    ● 版本号不匹配:如软件包名称、界面版本号;

    易用性

    ● 关键步骤错误或缺失,无法指导用户完成任务;

    ● 缺少必要的前提条件、注意事项等;

    ● 图形、表格、文字等晦涩难懂;

    ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

    正确性

    ● 技术原理、功能、规格等描述和软件不一致,存在错误;

    ● 原理图、架构图等存在错误;

    ● 命令、命令参数等错误;

    ● 代码片段错误;

    ● 命令无法完成对应功能;

    ● 界面错误,无法指导操作;

    风险提示

    ● 对重要数据或系统存在风险的操作,缺少安全提示;

    内容合规

    ● 违反法律法规,涉及政治、领土主权等敏感词;

    ● 内容侵权;

    您对文档的总体满意度

    非常不满意
    非常满意
    提交
    根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
    文档捉虫
    编组 3备份