长期支持版本

    社区创新版本

      在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备份