quay.io/kubespray/kubespray:v2.12.8
quay.iolinux/amd64v2.12.8大小: 未知更新于 2026年6月23日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
quay.io/kubespray/kubespray 镜像说明
技术定位
该镜像为 Kubespray 的容器化分发版本。Kubespray 是基于 Ansible 的开源 Kubernetes 集群部署工具，旨在简化多节点 K8s 集群的自动化部署、配置与管理，支持多种基础设施（如裸金属、公有云、私有云）及操作系统。
典型使用场景
- Kubernetes 集群部署：通过容器化环境运行 Kubespray 的 Ansible Playbook，自动化完成 K8s 集群的初始化（包括控制平面、节点、网络插件、存储等组件）。
- 版本一致性管理：固定镜像 tag 可确保部署工具版本统一，避免因环境差异导致的部署问题。
- CI/CD 集成：在持续集成流程中作为部署步骤的执行环境，实现集群部署的自动化与可重复性。
版本标签说明
镜像 tag 遵循语义化版本及开发分支标识，主要类型包括：
master：开发分支镜像，包含最新特性，适合测试场景。latest：最新稳定版本镜像，推荐生产环境使用。v2.x.x（如v2.31.0、v2.29.1）：具体版本号镜像，对应 Kubespray 的稳定发布版，便于版本锁定。
与常见技术栈的关系
- Kubernetes：核心目标是部署和管理 K8s 集群，支持多种 K8s 版本（具体版本需参考对应 Kubespray 版本的官方文档）。
- Ansible：镜像内置 Ansible 运行环境及 Kubespray Playbook，无需额外安装依赖。
- Docker/Kubernetes：可通过 Docker、Podman 等容器引擎运行，也可在现有 K8s 集群中作为 Job 执行部署任务。
使用示例
通过容器运行 Kubespray 执行部署（需挂载本地配置目录，如 inventory 文件、SSH 密钥等）：
docker run -it --rm \
-v /path/to/local/inventory:/inventory \
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
quay.io/kubespray/kubespray:v2.31.0 \
ansible-playbook -i /inventory/mycluster.yml cluster.yml
注：实际使用需根据具体版本的 Kubespray 文档配置 inventory 文件及参数。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"