用途:为 Web 应用在 Locaweb Cloud 上搭建部署流程,支持按环境(如 preview、production)生成部署与拆除工作流、Kamal 配置及密钥文件。
主要能力:每个环境生成 .github/workflows/deploy-{env}.yml 与 teardown-{env}.yml、config/deploy.{env}.yml、.kamal/secrets.{env};公共文件包括 config/deploy.yml、.kamal/secrets-common 和仓库根目录的单个 Dockerfile。部署工作流由 provisioning job(调用外部 locaweb/locaweb-cloud-provision 配置 VM、网络、磁盘、IP、防火墙、快照、DNS)与 deploy job(Kamal 构建推送镜像并部署)组成。提供脚本 generate_pg_cmd.py,按 VM 规格生成 PostgreSQL cmd,例如:mise x -- python3 scripts/generate_pg_cmd.py --plan medium。
使用方式:按步骤执行——准备应用(根目录单 Dockerfile、监听 80 端口、GET /up 返回 200);确认 GitHub 仓库远程;生成或复用 Ed25519 SSH 密钥;收集 CloudStack 凭据并设为 GitHub Secrets(CLOUDSTACK_API_KEY、CLOUDSTACK_SECRET_KEY);梳理应用环境变量并分类;用 gh secret set 创建所需 Secrets;最后基于 examples/ 编写 Kamal 配置与密钥文件。
适用场景:需要为 Locaweb Cloud 上的 Web 应用建立可重复的按环境部署与预览环境的团队。
限制:forward_headers 必须为 false,禁止改为 true;web 无水平扩展,只能垂直扩容;持久化路径必须位于 /data/ 子目录下;呼叫方工作流不得包含独立 Docker 构建或推送步骤;须启用 TLS(proxy.ssl: true);env_name 与 accessory 名称仅限小写字母、数字和下划线;accessory 每次部署会重启并有停机。部分细节(如具体价格、更多平台行为)资料暂未提供。