容器OS镜像制作指导

简介

kbimg是KubeOS部署和升级所需的镜像制作工具，可以使用kbimg制作KubeOS docker，虚拟机和物理机镜像。

命令介绍

命令格式

bash kbimg.sh [ --help | -h ] create [ COMMANDS ] [ OPTIONS ]

参数说明

• COMMANDS

  参数	描述
  upgrade-image	生成用于安装和升级的docker镜像格式的 KubeOS 镜像
  vm-image	生成用于部署和升级的虚拟机镜像
  pxe-image	生成物理机安装所需的镜像及文件

• OPTIONS

  参数	描述
  -p	repo 文件的路径，repo 文件中配置制作镜像所需要的 yum 源
  -v	制作出来的KubeOS镜像的版本
  -b	os-agent二进制的路径
  -e	KubeOS 镜像 root 用户密码，加密后的带盐值的密码，可以用 openssl，kiwi 命令生成
  -d	生成或者使用的 docker镜像
  -h --help	查看帮助信息

使用说明

注意事项

• kbimg.sh 执行需要 root 权限。
• 当前仅支持 x86和 AArch64 架构使用。
• 容器 OS 镜像制作工具的 rpm 包源为 openEuler 具体版本的 everything 仓库和 EPOL 仓库。制作镜像时提供的 repo 文件中，yum 源建议同时配置 openEuler 具体版本的 everything 仓库和 EPOL 仓库。

KubeOS docker镜像制作

注意事项

• 制作的 docker 镜像仅用于后续的虚拟机/物理机镜像制作或升级使用，不支持启动容器。
• 使用默认 rpmlist 进行容器OS镜像制作时所需磁盘空间至少为6G，如自已定义 rpmlist 可能会超过6G。

使用示例

• 如需进行DNS配置，请先在scripts目录下自定义resolv.conf文件。

  cd /opt/kubeOS/scripts
  touch resolv.conf
  vim resolv.conf

• 制作KubeOS容器镜像。

cd /opt/kubeOS/scripts
bash kbimg.sh create upgrade-image -p xxx.repo -v v1 -b ../bin/os-agent -e '''$1$xyz$RdLyKTL32WEvK3lg8CXID0''' -d your_imageRepository/imageName:version 

• 制作完成后查看制作出来的KubeOS容器镜像。

docker images

KubeOS 虚拟机镜像制作

注意事项

• 如使用 docker 镜像制作请先拉取相应镜像或者先制作docker镜像，并保证 docker 镜像的安全性。
• 制作出来的容器 OS 虚拟机镜像目前只能用于 CPU 架构为 x86 和 AArch64 的虚拟机。
• 容器 OS 目前不支持 x86 架构的虚拟机使用 legacy 启动模式启动。
• 使用默认rpmlist进行容器OS镜像制作时所需磁盘空间至少为25G，如自已定义rpmlist可能会超过25G。

使用示例

• 使用repo源制作。

  • 如需进行DNS配置，请先在scripts目录下自定义resolv.conf文件。

  cd /opt/kubeOS/scripts
  touch resolv.conf
  vim resolv.conf
  

  • KubeOS虚拟机镜像制作。

  cd /opt/kubeOS/scripts
  bash kbimg.sh create vm-image -p xxx.repo -v v1 -b ../bin/os-agent -e '''$1$xyz$RdLyKTL32WEvK3lg8CXID0'''
  

• 使用docker镜像制作。

  cd /opt/kubeOS/scripts
  bash kbimg.sh create vm-image -d  your_imageRepository/imageName:version
  

• 结果说明。
  容器 OS 镜像制作完成后，会在 /opt/kubeOS/scripts 目录下生成：

  • system.qcow2: qcow2 格式的系统镜像，大小默认为 20GiB，支持的根文件系统分区大小 < 2020 MiB，持久化分区 < 16GiB 。
  • update.img: 用于升级的根文件系统分区镜像。

KubeOS 物理机安装所需镜像及文件制作

注意事项

• 如使用 docker 镜像制作请先拉取相应镜像或者先制作 docker 镜像，并保证 docker 镜像的安全性。
• 制作出来的容器 OS 物理安装所需的镜像目前只能用于 CPU 架构为 x86 和 AArch64 的物理机安装。
• Global.cfg配置中指定的ip为安装时使用的临时ip,请在系统安装启动后请参考《openEuler 22.09 管理员指南-配置网络》进行网络配置。
• 不支持多个磁盘都安装KubeOS，可能会造成启动失败或挂载紊乱。
• 容器OS 目前不支持 x86 架构的物理机使用 legacy 启动模式启动。
• 使用默认rpmlist进行镜像制作时所需磁盘空间至少为5G，如自已定义 rpmlist 可能会超过5G。

使用示例

• 首先需要修改00bootup/Global.cfg的配置，对相关参数进行配置，参数均为必填，ip目前仅支持ipv4，配置示例如下：

  # rootfs file name
  rootfs_name=kubeos.tar
  # select the target disk to install kubeOS
  disk=/dev/sda
  # pxe server ip address where stores the rootfs on the http server
  server_ip=192.168.1.50
  # target machine temporary ip
  local_ip=192.168.1.100
  # target machine temporary route
  route_ip=192.168.1.1
  # target machine temporary netmask
  netmask=255.255.255.0
  # target machine netDevice name
  net_name=eth0
  

• 使用 repo 源制作。

  • 如需进行DNS配置，请在scripts目录下自定义resolv.conf文件。

    cd /opt/kubeOS/scripts
    touch resolv.conf
    vim resolv.conf
  

  • KubeOS物理机安装所需镜像制作。

    cd /opt/kubeOS/scripts
    bash kbimg.sh create pxe-image -p xxx.repo -v v1 -b ../bin/os-agent -e '''$1$xyz$RdLyKTL32WEvK3lg8CXID0'''
  

• 使用 docker 镜像制作。

  cd /opt/kubeOS/scripts
  bash kbimg.sh create pxe-image -d your_imageRepository/imageName:version
  

• 结果说明。

  • initramfs.img: 用于pxe启动用的 initramfs 镜像 。
  • kubeos.tar: pxe安装所用的 OS。