Skip to main content
Version: 4.0.0

Building Cluster Images Based on Deployment Manifest

This document will detail how to build cluster images based on Deployment Manifests. We will use a simple nginx application as an example.

I. Preparations

  1. First, create a base directory as the build workspace.
$ mkdir ~/cloud-images
  1. Create a directory named manifests to store the kubernetes nginx deployment yaml file.
$ cd cloud-images
$ mkdir manifests

II. Prepare the Manifest File

At this stage, we will prepare a simple nginx kubernetes yaml file.

$ cat manifests/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
spec:
selector:
matchLabels:
app: nginx
replicas: 2
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.23.1
ports:
- containerPort: 80

III. Create Kubefile

At this stage, we need to create a Kubefile that will be used to build the image.

FROM scratch
COPY manifests manifests
COPY registry registry
CMD ["kubectl apply -f manifests/deployment.yaml"]

IV. Build the Cluster Image

After preparing all the necessary files and directories, we can start building the cluster image.

sealos build -t labring/nginx:v1.23.1 .

Note: Before starting the build, you need to install the sealos command on your local host.

During the build, you can view the build log.

V. Verify the Image

After the build is complete, you can view the built image with the following command:

root@ubuntu:~/cloud-images# sealos images
labring/nginx v1.23.1 521c85942ee4 4 minutes ago 56.8 MB

VI. Push the Image

Finally, we can push the built image to any Docker image repository. The following command pushes it to DockerHub.

sealos push labring/nginx:v1.23.1

Note: Please use the sealos command to operate the cluster image, the Docker command is not supported.

If you are using a private image repository, just use sealos login to log into the repository before pulling or pushing the image.

sealos login docker.io -u xxx -p xxx

sealos login registry.cn-hangzhou.aliyuncs.com -u xxx -p xxx

At this point, the cluster image based on the deployment manifest is successfully built.