Skip to content
Public template

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

阿里云云编译模板

1. 配置并生成文件

首次克隆后运行:

python build.py

没有配置时会生成带占位值的 config.json 并退出。填写配置后再运行一次,在 dist/ 中生成五个文件。

后面部署和复制的都是 dist 中生成的文件,根目录文件保留占位符,供修改模板使用。

配置项 说明
github_repository 未来放置 Action 的目标仓库,owner/repo
fc_url / fc_token FC HTTPS 地址及随机 Bearer 密钥;Token 建议用 python -c "import secrets; print(secrets.token_hex(32))" 生成
region_id / zone_id 海外地域及可用区
resource_group_id 构建资源组
launch_template_id / launch_template_version ECS 启动模板和固定的数字版本
disk_id 保留的数据盘 ID,须与实例同可用区,关闭多重挂载
max_runtime_seconds 超时自动释放,默认 14400 秒;允许 1800~18000 秒
work_dir 写入 fstab 的数据盘目录,默认 /mnt/cloud-build
source_url / source_ref 源码 HTTPS 地址和默认分支/标签;示例使用公共 QEMU 仓库
oss_bucket / oss_internal_endpoint / oss_prefix 同地域私有 OSS Bucket、内网 Endpoint 和对象前缀
build_commands 你的编译命令;当前只是 QEMU 示例,按项目替换

config.json 和 dist/ 已被 Git 忽略。FC Token 只用于配置 HTTP 触发器和 GitHub Secret,不会生成到云函数或 Action 源码中。Base64 配置仅用于替换占位符,不是加密。

2. 准备镜像和数据盘

创建海外地域的准备机和独立数据盘,设置数据盘“不随实例释放”。先通过控制台初始化空盘,或使用已经有 ext4/xfs 文件系统的数据盘;模板不执行格式化。

在 Ubuntu 24.04 x86_64 准备机上传生成的文件,可选执行:

sudo bash init-system.sh
lsblk -f
sudo bash init-data.sh /dev/vdb1  # 示例:替换为确认好的已有数据盘/分区

系统初始化脚本安装通用编译工具和 Python SDK,并将同目录的 compile.sh 安装到 /opt/cloud-build/compile.sh。如果已有环境,只需保证该路径和 /opt/cloud-build/venv/bin/python 可用即可。

init-data.sh 首次从指定分区读取 UUID,写入镜像的 /etc/fstab,再挂载并准备源码/缓存。ext4 配置形如 UUID=... /mnt/cloud-build ext4 defaults,nofail 0 2;xfs 使用最后一位 0。脚本拒绝系统盘、冲突配置和错误的已有挂载,不新增 config.json 的 UUID 字段。已有正确 fstab 条目时可省略设备参数。

以后 FC 会在实例启动后连接云盘,compile.sh 按该 fstab 条目重试 mount <work_dir>,校验挂载 UUID 和独立文件系统后才编译。仅有 nofail 不会在热添加时自动重跑开机挂载。阿里云数据盘挂载说明。

确认云助手 Agent 在线。完成准备后,关机,从系统盘快照创建系统镜像;释放准备机并保留原数据盘。不要把大数据盘复制进整机镜像。可为数据盘设置自动快照备份。

创建启动模板,配置这个系统镜像、构建规格、同可用区的交换机、安全组、公网访问和实例 RAM 角色。不要在模板中另建数据盘。

3. 部署云函数

FC 和 ECS 的 Python 依赖各自独立。init-system.sh 只给 ECS 安装依赖;FC 请在 Linux x86_64 / Python 3.12 环境(可用 WSL)运行:

python3.12 build.py --package-fc

同一个 build.py 会额外生成包含 FC SDK 依赖的 dist/fc.zip,无需新增打包脚本。普通 python build.py 仍只填充占位符,不安装依赖;Windows 上不要使用 --package-fc。

在 FC 创建函数并上传完整 ZIP,逐项设置:

项目 必须设置
版本/运行时/架构 FC 3.0 / Python 3.12 / x86_64
Handler function.handler
执行超时 600 秒,不要沿用默认 60 秒;启动与挂盘等待合计可达 360 秒
RAM 角色 下文的 FC 角色
HTTP 触发器 POST,内置 Bearer / Opaque,Token 使用 fc_token,禁止匿名访问

鉴权只由原生触发器完成,函数不再重复校验或保存 Token。将触发器地址填回 fc_url,再次生成 Action 文件。创建触发器之前可暂时将 fc_url 留空,但不能运行该 Action。

云端使用 RAM 角色临时凭据,不需要把阿里云长期 AccessKey 写进配置:

  • FC 角色:需要 ecs:RunInstances、ecs:DescribeInstances、ecs:DescribeDisks、ecs:AttachDisk、ecs:RunCommand、ecs:DeleteInstance,以及向实例传递指定角色的 ram:PassRole。
  • ECS 角色:需要指定 OSS 前缀的 oss:GetObject、oss:PutObject、oss:ListParts、oss:AbortMultipartUpload,以及 ecs:DescribeDisks 和释放构建实例的 ecs:DeleteInstance。

用自定义策略限定资源;删除权限可限制到带 cloud-build=managed 标签的构建实例,挂盘权限限定到指定盘 ID。不要直接授予 ECS 全权限,也不要认为 FC 角色仅绑定资源组就自动具备所需权限。

4. 使用 Action

只把生成的 dist/cloud-build.yml 复制到你自己项目的 .github/workflows/cloud-build.yml,不需要复制本仓库的 Python 脚本。

在目标仓库的 Actions Secrets 中创建 FC_TOKEN,值为配置里的 fc_token。然后在 Actions 页面手动运行 Cloud Build,选择源码分支、标签或完整提交 SHA。

Action 成功只表示任务已提交,不代表编译成功。 它会输出任务 ID、实例 ID 和云助手执行 ID;不轮询、不回传 GitHub Artifact。

concurrency 仅覆盖提交阶段,不是整个编译生命周期的锁。FC 会拒绝磁盘已占用或同一磁盘已有待清理构建实例的请求。两个请求仍可能同时通过预检查,此时由关闭多重挂载的云盘保证独占,未获得云盘的新实例会尝试释放并返回 409;没有实现严格的全局创建锁。

FC 对已有实例或已经尝试下发命令的实例不会因异常而释放;超时不代表命令未执行。错误响应会提供实例/任务 ID,先在云助手核对执行记录,勿直接重开多个任务。自动释放时间是状态不明时的兜底。只有本次取得的、尚未尝试下发命令、未获得数据盘且通过名称/标签归属检查的闲置实例才允许回滚。

构建日志和结果保存在:

oss://<oss_bucket>/<oss_prefix>/<job_id>/build.log
oss://<oss_bucket>/<oss_prefix>/<job_id>/result.json
oss://<oss_bucket>/<oss_prefix>/<job_id>/artifacts.tar.gz  # 编译成功时

查看 OSS 的 result.json 判断编译是否成功。上传使用带地域参数的 ProviderAuthV4;新建 Bucket 不再依赖 V1 签名。阿里云 V4 迁移说明。上传完成后,脚本检查数据盘保留属性,并释放当前实例。上传或释放失败时,去云助手查看日志;创建实例时设置的自动释放时间仍作为兜底。

5. 修改自己的编译流程

修改 config.json 的 build_commands,或直接编辑根目录 compile.sh 的编译/结束部分,再执行 build.py。命令可使用:

$SOURCE_DIR     持久源码目录
$BUILD_DIR      本次构建目录
$ARTIFACT_DIR   需要上传的产物放这里
$CCACHE_DIR     持久缓存
$JOBS           CPU 数

编译命令共用一个 Bash 环境,默认失败立即结束并上传日志。替换 Android 等工程时,工具链和构建入口按实际项目准备;私有源码的凭据接入也按需修改模板。

修改环境或编译脚本后,更新系统镜像/启动模板版本;修改云函数配置后重新部署;修改 Action 配置后重新复制到目标工程。

这份模板一次复用一块数据盘,忙时拒绝新任务。没有队列、抢占续跑或全局锁;遇到抢占重新提交即可。持久盘、快照和 OSS 在实例释放后仍会计费。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages