Atoms一键部署到Atoms_Cloud步骤

Atoms项目可通过atoms-cli一键部署至Atoms Cloud，需满足CLI版本、系统环境及atoms.yaml配置要求，登录后选择空间并执行deploy命令，自动完成构建、推送与服务暴露。

想把本地开发好的 Atoms 项目快速推送到 Atoms Cloud 运行环境，避免手动配置集群、镜像构建和权限绑定等重复操作，直接获得可访问的 API 端点和可观测性面板。

确认本地环境满足前提条件

确保你已在 macOS 或 Linux 机器上安装了 atoms-cli v2.4.0+。Windows 用户必须使用 WSL2（内核版本 ≥5.15），且已启用 systemd 支持。运行

验证输出中包含 “cloud-ready” 标志位。

检查当前目录下存在 atoms.yaml 文件，且该文件中至少定义了 service.name、runtime.type（仅支持 rust-1.78+、python-3.11+、nodejs-20.12+）和 endpoints.http.port 三个字段。缺失任一字段将导致部署中断并退出，不会进入构建阶段。

登录 Atoms Cloud 账户并选择目标空间

执行 atoms-cli login，按提示打开浏览器完成 OAuth2 授权。授权成功后，CLI 自动获取短期访问令牌并缓存至 ~/.atoms/auth.json。

运行 atoms-cli space list 查看可用空间列表。若目标空间未出现在列表中，请联系空间管理员为你添加

角色。普通 member 权限无法触发部署流水线。

执行 atoms-cli space use my-production-space 切换至目标空间。这一步会写入 ~/.atoms/config.yaml，后续所有命令均默认在此空间上下文中执行。

执行一键部署

在项目根目录下运行：atoms-cli deploy --auto-build --wait。

这条命令会依次执行以下操作：源码打包、Dockerfile自动生成（若没有自定义Dockerfile）、镜像构建、推送至Atoms Cloud私有Registry、Kubernetes Deployment创建、Service和Ingress配置、健康探针就绪检测。整个过程大概需要90到210秒，具体时长取决于代码体积和依赖层大小。

一旦终端输出了 ✅ Deployment succeeded: https://myapp.my-production-space.atoms.cloud，这就表明服务已经对外暴露了。这个时候，我们可以立刻使用curl进行测试，测试命令为：curl -I https://myapp.my-production-space.atoms.cloud/health，如果返回的是HTTP/2 200，那就说明服务已经就绪了。