官方Kubernetes Docker镜像,由openEuler CloudNative SIG维护,支持amd64和arm64多架构,适用于在openEuler系统上部署Kubernetes集群,提供控制平面和工作节点组件。
Kubernetes Docker镜像文档
镜像概述
该镜像为官方Kubernetes Docker镜像,由https://gitee.com/openeuler/cloudnative维护,支持amd64和arm64架构,适用于在openEuler操作系统上部署Kubernetes集群,提供kube-apiserver、kube-controller-manager、kube-scheduler、kube-proxy等核心组件。
核心功能与特性
- 多架构支持:同时支持amd64(x86_64)和arm64(aarch64)架构
- 官方维护:由openEuler CloudNative SIG团队维护,确保与openEuler系统兼容性
- 组件完整:包含Kubernetes核心控制平面和节点组件
- 多版本支持:提供多个Kubernetes版本与openEuler版本的组合
使用场景
适用于在openEuler操作系统上搭建Kubernetes集群,支持x86_64和ARM架构服务器,可用于构建混合架构的容器编排平台,满足企业级容器化应用部署需求。
构建方法
使用Docker Buildx构建多架构镜像:
shell# 构建kube-apiserver镜像 docker buildx build -t openeuler2k8s/kube-apiserver:v1.20.2-openEuler2109 --build-arg KUBE_BINARY=kube-apiserver --platform=linux/arm64,linux/amd64 . --push # 构建kube-controller-manager镜像 docker buildx build -t openeuler2k8s/kube-controller-manager:v1.20.2-openEuler2109 --build-arg KUBE_BINARY=kube-controller-manager --platform=linux/arm64,linux/amd64 . --push # 构建kube-scheduler镜像 docker buildx build -t openeuler2k8s/kube-scheduler:v1.20.2-openEuler2109 --build-arg KUBE_BINARY=kube-scheduler --platform=linux/arm64,linux/amd64 . --push # 构建kube-proxy镜像 docker buildx build -t openeuler2k8s/kube-proxy:v1.20.2-openEuler2109 --build-arg KUBE_BINARY=kube-proxy --platform=linux/arm64,linux/amd64 . --push
注:需先安装Docker Buildx,详见https://docs.docker.com/buildx/working-with-buildx/
部署指南
前置条件
- 准备3台x86_64服务器和3台aarch64服务器(以华为云为例)
- https://docs.docker.com/engine/install/
- https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/
测试环境信息
| 架构 | 主机名 | 规格 | EIP | 私有IP |
|---|---|---|---|---|
| x86_64(amd64) | amd64-k8s0 | c6s.large.2 | 116.63.177.179 | 192.168.0.47 |
| x86_64(amd64) | amd64-k8s1 | c6s.large.2 | 122.9.153.240 | 192.168.0.28 |
| x86_64(amd64) | amd64-k8s2 | c6s.large.2 | 116.63.161.162 | 192.168.0.127 |
| aarch64(arm64) | arm64-k8s0 | kc1.large.2 | 122.9.151.115 | 192.168.0.2 |
| aarch64(arm64) | arm64-k8s1 | kc1.large.2 | 139.9.158.136 | 192.168.0.31 |
| aarch64(arm64) | arm64-k8s2 | kc1.large.2 | 116.63.184.18 | 192.168.0.150 |
x86_64架构部署
部署控制平面(amd64-k8s0)
shellkubeadm init --image-repository openeuler2k8s --kubernetes-version v1.20.2-openEuler2109 mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config
部署工作节点(amd64-k8s1/amd64-k8s2)
shellkubeadm join 192.168.0.47:6443 --token 6tcun6.89trlh4tioxkyv3o --discovery-token-ca-cert-hash sha256:cc71b5eeef33f839df3f3eb1242ae7de80247a83bae9698be3c6bf86f8c22433
安装网络插件(amd64-k8s0)
shellhelm repo add cilium https://helm.cilium.io/ helm install cilium cilium/cilium --version 1.11.1 --namespace kube-system
验证节点状态(amd64-k8s0)
shell$ kubectl get nodes NAME STATUS ROLES AGE VERSION amd64-k8s0 Ready control-plane,master 3m6s v1.20.2 amd64-k8s1 Ready <none> 69s v1.20.2 amd64-k8s2 Ready <none> 49s v1.20.2
aarch64架构部署
部署控制平面(arm64-k8s0)
shellkubeadm init --image-repository openeuler2k8s --kubernetes-version v1.20.2-openEuler2109 mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config
部署工作节点(arm64-k8s1/arm64-k8s2)
shellkubeadm join 192.168.0.2:6443 --token lht0xh.6xdhjvqu47ifye1p --discovery-token-ca-cert-hash sha256:7ba9fda1b472596d5ae1521a401af54f7c6daf99b706b02bbffbd8b08e9d0fb7
安装网络插件(arm64-k8s0)
shellhelm repo add cilium https://helm.cilium.io/ helm install cilium cilium/cilium --version 1.11.1 --namespace kube-system
验证节点状态(arm64-k8s0)
shell$ kubectl get nodes NAME STATUS ROLES AGE VERSION aarch64-host0 Ready control-plane,master 3m36s v1.20.2 aarch64-host1 Ready <none> 2m3s v1.20.2 aarch64-host2 Ready <none> 104s v1.20.2
支持的标签及Dockerfile链接
| 标签 | 说明 | 架构 |
|---|---|---|
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.20.2/21.09/Dockerfile | Kubernetes 1.20.2 on openEuler 21.09 | amd64, arm64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.33.1/24.03-lts-sp1/Dockerfile | Kubernetes 1.33.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.34.3/24.03-lts-sp2/Dockerfile | Kubernetes 1.34.3 on openEuler 24.03-LTS-SP2 | amd64, arm64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.35.0/24.03-lts-sp2/Dockerfile | Kubernetes 1.35.0 on openEuler 24.03-LTS-SP2 | amd64, arm64 |
操作系统支持
Linux/Unix,支持aarch64(arm64)或x86_64(amd64)架构。
获取帮助
- https://gitee.com/openeuler/cloudnative
- https://gitee.com/openeuler/community
openeuler 命名空间的其他可用镜像:
openeuler/openeuler
openEuler 操作系统,开源 Linux 发行版,适合企业级应用
openeuler/open-webui
Open WebUI,基于 openEuler 的 Web 用户界面
openeuler/openclaw
openEuler 发布的 OpenClaw 镜像,适合在 openEuler 或信创环境中部署
openeuler/opencode
openEuler 发布的 OpenCode AI 助手镜像,适合本地对话式开发与工具链集成
openeuler/vllm-ascend
openEuler 场景下的 vLLM Ascend 推理镜像,适合在昇腾硬件上部署大模型在线服务
openeuler/kylin
openEuler 生态中的 Kylin 基础环境镜像,适合信创/国产化环境下的应用构建与验证
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 kubernetes 镜像标签
docker pull docker.xuanyuan.run/openeuler/kubernetes:<标签>
DockerHub 原生拉取命令
docker pull openeuler/kubernetes:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务