Atoms 项目可通过 atoms-cli 一键部署到 Atoms Cloud，但前提是满足 CLI 版本、本地系统环境以及 atoms.yaml 配置要求。完成登录后，选择目标空间并执行 deploy 命令，即可自动完成构建、镜像推送和服务暴露。

如果你想将本地开发完成的 Atoms 项目快速发布到 Atoms Cloud 运行环境，借助 atoms-cli 可以省去手动配置集群、构建镜像和绑定权限等繁琐步骤，并直接获得可访问的 API 地址以及可观测性控制面板。

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

请先确认你已在 macOS 或 Linux 设备上安装 atoms-cli v2.4.0 及以上版本。Windows 用户则必须通过 WSL2（内核版本 ≥5.15）运行，并且需要启用 systemd 支持。可执行 【atoms-cli version】 检查输出结果中是否包含 “cloud-ready” 标志位。

同时检查当前目录中是否存在 atoms.yaml 文件，并确保文件内至少配置了 service.name、runtime.type（仅支持 rust-1.78+、python-3.11+、nodejs-20.12+）以及 endpoints.http.port 这三个关键字段。任意字段缺失都会导致 Atoms Cloud 部署流程中断，且不会进入构建阶段。

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

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

接着运行 atoms-cli space list 查看当前可用的空间列表。如果目标空间没有出现在列表中，需要联系该空间管理员为你分配 【deployer】 角色，因为普通 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，则说明服务已经部署完成并处于就绪状态。