
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本仓库包含AIS开发者使用的基础镜像参考,下文将概述这些镜像的构建和使用步骤。
所有镜像应使用适当标签构建。还应使用完全限定域名标识所使用的Docker Registry,以确保从远程网络成功执行拉取操作。要创建标记为2.7的Python基础镜像,应使用以下命令(注意末尾的句点):
sudo docker build -t appliedis/python:2.7 .
镜像构建完成后,应在发布到仓库前进行测试。可使用docker run命令完成测试。如果Dockerfile包含CMD语句,需验证其中定义的可执行文件是否已启动。如果没有CMD语句,可提供尾随命令以防止容器在运行时立即静默关闭。以下两个命令分别演示了测试默认CMD和覆盖CMD的情况:
sudo docker run -it appliedis/python:2.7 sudo docker run -it appliedis/python:2.7 echo "Docker CMD override successful"
值得注意的是,你可以使用更便捷的名称进行测试,然后在推送前将镜像标记为适当的主机名。有关详细信息,请参见docker tag --help。
一致性是关键——所有目录应与镜像名称保持一致。所有镜像名称应使用小写字母和连字符,版本标签应设置为我们关心的最具体版本。例如,如果我们希望固定到Python 2.7,但希望灵活更新到最新补丁版本(如2.7.10等),则应标记为"python:2.7"。如果不关心次要版本,可仅标记为"python:2"。建议避免使用latest标签,始终指定明确的版本标签。Docker在所有省略标签的情况下默认使用latest,这在需要固定到特定发布版本时可能会产生问题。
要发布到非官方Docker Hub的远程仓库,唯一的方法是将仓库主机名作为镜像名称的第一部分。在我们的案例中,主机名是appliedis。由于我们已在docker build步骤中标记了镜像,因此只需对现有镜像名称执行推送命令:
sudo docker push appliedis/python:2.7
镜像推送到Docker Registry后,任何具有仓库连接的机器都可使用该镜像。你可以直接按照测试部分所述使用镜像,或在Dockerfile中扩展/覆盖它:
FROM appliedis/python:2.7 ... 你的Dockerfile配置 CMD ["python", "my-python-script.py"]
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务