# 通用构建推送脚本

`build_push.sh` 是一个通用的镜像编译和推送脚本，用于在 CI/CD 环境中构建和推送多架构 Docker 镜像到 SWR 注册表。

## 功能特性

- 支持多架构构建 (linux/amd64, linux/arm64)
- 支持 CI/CD 环境变量
- 自动处理标签（基于分支或标签）
- 支持 main 分支推送时添加 latest 标签
- 自动清理构建缓存及镜像

## 环境变量

以下环境变量需要在 CI/CD 环境中手动设置 (通过运行时的 Secrets 导入) ：

- `SWR_REGISTRY`: 镜像注册表地址
- `SWR_USERNAME`: 注册表用户名（从密钥获取）
- `SWR_PASSWORD`: 注册表密码（从密钥获取）

以下环境变量为 CI/CD 运行时自动设置：

- `CI_REPO_NAME`: 仓库名称
- `CI_COMMIT_TAG`: 提交标签（可选，用于标签推送）
- `CI_COMMIT_SHA`: 提交 SHA（用于默认标签）
- `CI_COMMIT_BRANCH`: 提交分支（用于确定是否推送 latest 标签）

## 使用方法

在 CI/CD 配置中，将脚本复制到项目中并执行：

```bash
# 基于 Git Submodule 更新脚本
git submodule update --init --recursive

# 执行构建推送
sh .ci/common/build_push.sh
```

## Git Submodule 集成

此脚本作为 Git Submodule 集成到项目中：

```bash
git submodule add https://git.colovu.com/docker/common.git .ci/common
```

## 错误处理

脚本会在以下情况退出：

- 必需的环境变量未设置
- 无法登录到镜像注册表
- 构建或推送失败