长期支持版本

    社区创新版本

      安装与配置

      安装方法

      前提条件

      • 为了获取更好的性能体验,kuasar需要运行在裸金属服务器上,暂不支持kuasar运行在虚拟机内
      • kuasar运行依赖以下openEuler组件,请确保环境上已安装所需版本的依赖组件。
        • iSulad(请参考iSula容器引擎的安装与配置章节安装iSulad)
        • StratoVirt(请参考StratoVirt的安装章节安装StratoVirt)

      安装操作

      1. kuasar发布组件集成在kuasar rpm包中,使用yum命令可以直接安装

        $ yum install kuasar
        
      2. 安装启动沙箱及容器需要使用的cri命令行工具crictl

        # arm环境
        $ wget https://github.com/kubernetes-sigs/cri-tools/releases/download/v1.25.0/crictl-v1.25.0-linux-arm64.tar.gz
        $ tar -zxvf crictl-v1.25.0-linux-arm64.tar.gz -C /usr/local/bin
        # x86环境
        $ wget https://github.com/kubernetes-sigs/cri-tools/releases/download/v1.25.0/crictl-v1.25.0-linux-amd64.tar.gz
        $ tar -zxvf crictl-v1.25.0-linux-amd64.tar.gz -C /usr/local/bin
        
      3. 安装cri配置网络需要使用的cni插件

        $ mkdir -p /opt/cni/bin && mkdir -p /etc/cni/net.d
        
        # arm环境
        $ wget https://github.com/containernetworking/plugins/releases/download/v1.3.0/cni-plugins-linux-arm64-v1.3.0.tgz
        $ tar -zxvf cni-plugins-linux-arm64-v1.3.0.tgz -C /opt/cni/bin/
        # x86环境
        $ wget https://github.com/containernetworking/plugins/releases/download/v1.3.0/cni-plugins-linux-amd64-v1.3.0.tgz
        $ tar -zxvf cni-plugins-linux-amd64-v1.3.0.tgz -C /opt/cni/bin/
        

      配置方法

      iSulad容器引擎的配置

      修改iSulad容器引擎的配置文件/etc/isulad/daemon.json以支持iSulad容器引擎调用kuasar vmm虚拟机类型的容器运行时,新增如下配置:

      $ cat /etc/isulad/daemon.json
      ...
          "cri-sandboxers": {
              "vmm": {
                  "name": "vmm",
                  "address": "/run/vmm-sandboxer.sock"
              }
          },
          "cri-runtimes": {
              "vmm": "io.containerd.vmm.v1"
          },
      ...
      

      重新启动iSulad

      $ systemctl restart isulad
      

      crictl的配置

      修改crictl配置文件/etc/crictl.yaml对接isulad

      $ cat /etc/crictl.yaml
      runtime-endpoint: unix:///var/run/isulad.sock
      image-endpoint: unix:///var/run/isulad.sock
      timeout: 10
      

      kuasar的配置

      修改kuasar对接stratovirt配置文件(可使用默认配置,配置文件字段说明详见附录

      $ cat /var/lib/kuasar/config_stratovirt.toml
      [sandbox]
      log_level = "info"
      
      [hypervisor]
      path = "/usr/bin/stratovirt"
      machine_type = "virt,mem-share=on"
      kernel_path = "/var/lib/kuasar/vmlinux.bin"
      image_path = ""
      initrd_path = "/var/lib/kuasar/kuasar.initrd"
      kernel_params = "task.log_level=debug task.sharefs_type=virtiofs"
      vcpus = 1
      memory_in_mb = 1024
      block_device_driver = "virtio-blk"
      debug = true 
      enable_mem_prealloc = false
      
      [hypervisor.virtiofsd_conf]
      path = "/usr/bin/vhost_user_fs"
      

      启动kuasar-vmm服务

      $ systemctl start kuasar-vmm
      

      确认服务已处于running状态

      $ systemctl status kuasar-vmm
      ● kuasar-vmm.service - Kuasar microVM type sandboxer daemon process
           Loaded: loaded (/usr/lib/systemd/system/kuasar-vmm.service; disabled; vendor preset: disabled)
           Active: active (running) since Sat 2023-08-26 14:57:08 CST; 1h 25min ago
         Main PID: 1000445 (vmm-sandboxer)
            Tasks: 99 (limit: 814372)
           Memory: 226.4M
           CGroup: /system.slice/kuasar-vmm.service
                   └─ 1000445 /usr/local/bin/vmm-sandboxer --listen /run/vmm-sandboxer.sock --dir /run/kuasar-vmm
      

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

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

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

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

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

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

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