跳到主要内容
版本:4.0.0

镜像构建与标准化目录配置

在开展 Sealos 镜像构建任务前,我们建议先构建一个符合规范的目录结构。这样能够使构建过程更加规范,易于管理,同时也能降低出错率。这篇文章将详细指导你如何创建这样一个目录结构,并解释每个目录的用途。

目录结构示例

一个完整的、符合规范的目录结构示例如下:

.
├── charts
│   └── nginx
│   ├── Chart.lock
│   ├── charts
│   ├── Chart.yaml
│   ├── README.md
│   ├── templates
│   ├── values.schema.json
│   └── values.yaml
├── images
│   └── shim
│   └── nginxImages
├── init.sh
├── Kubefile
├── manifests
│   └── nginx
│   ├── deployment.yaml
│   ├── ingress.yaml
│   └── service.yaml
├── opt
│   └── helm
└── registry

目录描述

每个目录在构建过程中都扮演着特定的角色,以下是他们的详细描述:

  • Kubefile (必需):这个文件类似于 Dockerfile,是构建镜像的核心文件。它定义了构建过程中的各个步骤,如基础镜像选择、环境变量设置、文件复制等。
  • manifests:这个目录用于存放 Kubernetes 的 yaml 文件,这些文件描述了你的应用的配置信息,如 Pod、Service、Deployment 的配置。
  • charts:这个目录用于存放 Helm chart 文件,Helm chart 是 Kubernetes 的一个包管理工具,可以简化 Kubernetes 应用的部署和管理。
  • images/shim:这个目录用于存放无法从 yaml 文件或 Helm chart 中自动提取的镜像。在构建过程中,sealos 将自动拉取这些镜像。
  • opt:二进制文件存储在这里。
  • registry:这个目录用于存放构建过程中拉取到本地的镜像。在构建过程中,该目录将自动生成,无需手动创建。
  • init.sh:这个脚本在构建过程中由 GitHub Action 自动运行,你可以在这个脚本中编写一些自动化的工作,如初始化环境、预处理数据等。(cluster-image的规则)

Kubefile 参数

Kubefile 文件是镜像构建的核心,它支持多种参数,以下是这些参数的详细解析:

FROM labring/kubernetes:v1.24.0
ENV version v1.1.0
COPY manifests ./manifests
COPY registry ./registry
ENTRYPOINT ["kubectl apply -f manifests/tigera-operator.yaml"]
CMD ["kubectl apply -f manifests/custom-resources.yaml"]

各个参数的描述:

  • FROM:这个指令用于设置构建的基础镜像,所有的构建步骤都基于这个镜像进行。

  • LABEL: LABEL定义一些sealos集群镜像的内部配置。

    • check 集群镜像运行前的一些检查脚本操作

    • clean 集群reset或者节点删除的清理脚本

    • clean-registry 集群reset时候的清理镜像仓库的脚本

    • image 集群的lvscare镜像地址(sealos的IPVS镜像)

    • init 集群初始化的脚本

    • init-registry 集群初始化时启动容器镜像仓库的脚本

    • sealos.io.type 集群镜像类型,目前主要是rootfs、application和patch。

      • rootfs 是运行集群的基础镜像,比如kubernetes、kubernetes-docker这种包含镜像、二进制等集群所需的。(每个节点都需要存在
      • application 是应用镜像,比如calico、helm、istio等应用服务的镜像。(只存储到master0节点)
      • patch是在rootfs镜像后需要调整的,是另一种修改rootfs镜像的方式(还有一种方式是Config方式),它会覆盖默认的集群运行的第一个镜像。
    • sealos.io.version 镜像的版本号,目前开启的是v1beta1

    • version 集群的版本号,当前是kubernetes的版本号

    • vip 是VIP的地址,为修改IPVS的虚IP使用

  • ENVENV指令将环境变量<key>设置为值<value>。(rootfs中默认会有一些默认的环境变量,可以修改rootfs中一些默认参数,比如镜像仓库的账号密码、docker、containerd的存储目录等等)

    具体的集群镜像需要具体查看,sealos inspect镜像看一下对应的环境变量,不同版本的镜像略有不同。

    • SEALOS_SYS_CRI_ENDPOINT: 当前集群镜像的criSocket (不同类型集群镜像可能不同)
    • criData: cri的数据目录
    • defaultVIP: 默认的VIP地址
    • disableApparmor: 是否禁用apparmor (containerd有这个问题)
    • registryConfig: 容器镜像仓库的配置目录
    • registryData: 容器镜像仓库的数据目录(因为是目录进行了挂载,其实这个配置没有实际意义,它实际还是存储在/var/lib/sealos下面)
    • registryDomain: 默认镜像仓库的域名
    • registryPassword: 默认镜像仓库的密码
    • registryPort: 默认镜像仓库的密码
    • registryUsername: 默认镜像仓库的账户
    • sandboxImage: 默认cri启动的sandbox_image。(无需写repo只需要写镜像名称,eg: pasue:3.7)
  • COPYCOPY指令从<src>复制新的文件或目录,并将它们添加到容器的文件系统路径<dest>上。(注意,需要把registry目录进行拷贝,否则集群没有容器镜像)

  • ENTRYPOINT:这个指令用于设置镜像的启动命令,当镜像启动时,这条命令会被执行。

  • CMD:这个指令也用于设置镜像的启动命令,但它与 ENTRYPOINT 指令的区别在于,如果用户在运行镜像时(sealos run --cmd)提供了启动命令,CMD 指令中的命令将会被覆盖。

在构建过程中,Sealos 还会自动设置一些内置的环境变量,包括(前缀为'SEALOS_SYS'的环境变量无法被修改):

  • SEALOS_SYS_KUBE_VERSION:Kubernetes的版本号,例如 v1.26.0
  • SEALOS_SYS_SEALOS_VERSION:Sealos的版本号,例如 4.1.3