长期支持版本

    社区创新版本

      安装与部署

      在 VMware 上部署 NestOS

      本指南展示了如何在VMware虚拟机管理程序上配置最新的 NestOS。

      目前NestOS仅支持x86_64架构。

      开始之前

      ​在开始部署 NestOS 之前,需要做如下准备工作:

      • 下载 NestOS ISO
      • 准备 config.bu 文件
      • 配置 butane 工具(Linux环境/win10环境)
      • 安装有VMware的宿主机

      初步安装与启动

      启动 NestOS

      初次启动 NestOS ,ignition 尚未安装,可根据系统提示使用 nestos-installer 组件进行ignition的安装。

      配置 ignition 文件

      获取 Butane

      可以通过 Butane 将 bu 文件转化为 ignition 文件。ignition 配置文件被设计为可读但难以编写,是为了阻止用户尝试手动编写配置。Butane 提供了多种环境的支持,可以在 linux/windows 宿主机中或容器环境中进行配置。

      docker pull quay.io/coreos/butane:release
      

      生成登录密码

      在宿主机执行如下命令,并输入你的密码。

      # openssl passwd -1 -salt yoursalt
      Password:
      $1$yoursalt$1QskegeyhtMG2tdh0ldQN0
      

      生成ssh-key

      在宿主机执行如下命令,获取公钥和私钥以供后续 ssh 登录。

      # ssh-keygen -N '' -f ./id_rsa
      Generating public/private rsa key pair.
      Your identification has been saved in ./id_rsa
      Your public key has been saved in ./id_rsa.pub
      The key fingerprint is:
      SHA256:4fFpDDyGHOYEd2fPaprKvvqst3T1xBQuk3mbdon+0Xs root@host-12-0-0-141
      
      The key's randomart image is:
      +---[RSA 3072]----+
      |   ..= . o .   |
      |    * = o * .  |
      |     + B = *   |
      |     o B O + . |
      |      S O B o  |
      |       * = . . |
      |      . +o . . |
      |     +.o . .E  |
      |    o*Oo   ... |
      +----[SHA256]-----+
      

      可以在当前目录查看id_rsa.pub公钥:

      # cat id_rsa.pub
      ssh-rsa
      AAAAB3NzaC1yc2...
      

      编写bu文件

      进行最简单的初始配置,如需更多详细的配置,参考后面的 ignition 详解。 如下为最简单的 config.bu 文件:

      variant: fcos
      version: 1.1.0
      passwd:
        users:
          - name: nest
            password_hash: "$1$yoursalt$1QskegeyhtMG2tdh0ldQN0"
            ssh_authorized_keys:
              - "ssh-rsa
        AAAAB3NzaC1yc2EAAA..."
      

      生成ignition文件

      将 config.bu 通过 Butane 工具转换为 config.ign 文件,如下为在容器环境下进行转换。

      # docker run --interactive --rm quay.io/coreos/butane:release \
      --pretty --strict < your_config.bu > transpiled_config.ign
      

      安装 NestOS

      将宿主机生成的config.ign文件通过scp拷贝到前面初步启动的 NestOS 中,该OS目前运行在内存中, 并没有安装到硬盘。

      sudo -i
      scp root@your_ipAddress:/root/config.ign /root
      

      根据系统所给提示,执行如下指令完成安装。

      nestos-installer install /dev/sda --ignition-file config.ign
      

      安装完成后重启 NestOS 。

      systemctl reboot
      

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

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

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

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

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

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

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