配置检查清单
- 仓库权限与分支：授权目标仓库，选择包含预期发布版本的分支。
- 构建目录与命令：确认应用目录、构建设置及运行启动命令符合项目要求。
- 运行变量：配置所需凭据与环境值，不要将密钥放入浏览器端代码。
- 网络与数据：检查监听端口、域名配置、数据库引用及持久化存储卷路径。
从配置到部署
连接仓库
登录 Polyer，打开项目，连接有权部署的 GitHub 仓库。
选择构建与环境
选择仓库分支与目标环境，检查应用目录、构建设置和启动命令。
检查服务配置
配置所需变量、资源设置与其他服务连接，检查待发布变更后再提交部署。
检查发布结果
查看部署日志和运行输出，测试应用入口与数据库连接，再完成必要的初始化。
运行与维护
- 每次发布时确认所选分支与目标环境。检查部署记录，在需要重新部署时使用服务的重新部署操作。
- 将应用迁移和外部凭据检查作为发布准备的一部分。容器成功启动并不代表应用流程已经正确运行。
- 分开管理生产与开发配置，使用环境和服务日志排查构建失败、启动错误与连接问题。
部署前的常见问题
如何从 monorepo 部署单个应用？
为服务选择根目录，再确认构建能访问所需的依赖清单、锁文件与共享包。Dockerfile 路径只决定使用哪个文件，不会将构建上下文之外的文件加入构建。例如 apps/web 依赖 packages/shared 时，应选择包含两者的构建上下文，并相应调整 Dockerfile。
为什么修改构建命令没有影响 Dockerfile 构建？
构建命令设置用于 Railpack 构建。服务通过 Dockerfile 构建时，需要修改 Dockerfile 内的构建步骤。查看部署日志确认实际使用的构建方式。如果 CI 已产出发布镜像，可以通过 Docker 镜像托管直接部署该镜像，无需再次构建仓库。
可以部署私有 GitHub 仓库吗？
需要通过 GitHub 集成授予仓库访问权限。配置服务前，检查集成对组织与仓库的访问范围。
切换分支会改变生产环境吗？
分支决定应用代码来源，命名环境决定服务运行位置。部署前需要同时检查这两项设置及待发布变更。
GitHub 部署失败时应该检查什么？
先检查部署日志、仓库权限、构建目录和命令。运行失败时检查启动命令、变量、监听端口及依赖服务连接。
在工作空间配置
登录后进入工作空间，提交部署配置后才会创建资源。