atoms项目可通过atoms-cli一键部署至atoms cloud，需满足cli版本、系统环境及atoms.yaml配置要求，登录后选择空间并执行deploy命令，自动完成构建、推送与服务暴露。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想把本地开发好的 Atoms 项目快速推送到 Atoms Cloud 运行环境，避免手动配置集群、镜像构建和权限绑定等重复操作，直接获得可访问的 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-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 即为就绪。
