Shell脚本如何更新容器镜像版本

wen 实用脚本 2026-07-17 1

Shell脚本如何高效更新容器镜像版本

目录导读

为什么容器镜像版本管理是运维痛点？
Shell脚本更新镜像版本的核心思路
实现方案：从手动到自动化（含代码示例）
常见陷阱与最佳实践（FAQ问答）
构建可靠版本迭代流水线

为什么容器镜像版本管理是运维痛点？

当今微服务与Kubernetes集群中，容器镜像版本更新是高频操作，传统方式：登录服务器 → 修改Dockerfile → 重新构建 → 推送仓库 → 修改部署清单,这个过程极易出现：

Shell脚本如何更新容器镜像版本

版本号写错（如latest沦为废弃标签）
镜像与代码不匹配（手误导致回滚困难）
多环境部署时版本混乱（测试/预发布/生产同步问题）

案例场景：某电商团队需要每天更新3个微服务镜像，每个版本附带Git commit hash，手动操作平均耗时15分钟/次，且曾因误写v2.0.1与v2.0.1-alpha混淆,导致生产事故。

核心需求：通过Shell脚本实现 无感版本递增、自动生成标签、验证镜像健康状态。

Shell脚本更新镜像版本的核心思路

1 版本号策略

语义化版本（推荐标准）：major.minor.patch-buildID.gitCommit
时间戳版本：YYYYMMDD.HHMMSS.GIT_SHA
Git驱动版本：从tag或commit中提取（最可靠）

# 自动生成版本号示例
GIT_COMMIT=$(git rev-parse --short HEAD)
BUILD_NUM=$(git rev-list --count HEAD)
VERSION="1.2.${BUILD_NUM}.${GIT_COMMIT}"

2 脚本工作流

获取当前最新版本（从远端仓库或本地缓存）
2. 依据规则递增（patch/minor/major）
3. 更新Dockerfile中的FROM或ARG变量
4. 执行docker build并打标签
5. 推送至私有仓库（如：your-domain.com/library/app）
6. 更新K8s部署文件中的镜像版本
7. 可选：触发滚动更新

实现方案：从手动到自动化（含代码示例）

1 基础版本：本地镜像版本升级脚本

#!/bin/bash
# update_image_version.sh
set -euo pipefail
APP_NAME="my-service"
REGISTRY="your-domain.com"
CURRENT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# Step1: 获取当前版本（从已拉取的远程tag）
echo ">>> 正在检查当前线上版本..."
CURRENT_VERSION=$(curl -s "https://${REGISTRY}/v2/${APP_NAME}/tags/list" | jq -r '.tags[-1]' 2>/dev/null || echo "0.0.0")
echo "当前线上最新版本: ${CURRENT_VERSION}"
# Step2: 计算新版本（自动递增patch）
IFS='.' read -r MAJOR MINOR PATCH <<< "${CURRENT_VERSION//[^0-9.]/}"
NEW_PATCH=$((PATCH + 1))
NEW_VERSION="${MAJOR}.${MINOR}.${NEW_PATCH}"
echo "即将构建新版本: ${NEW_VERSION}"
# Step3: 更新Dockerfile（替换FROM或LABEL）
sed -i "s/^ARG APP_VERSION=.*/ARG APP_VERSION=${NEW_VERSION}/" Dockerfile
# Step4: 构建并打标签
docker build -t "${REGISTRY}/${APP_NAME}:${NEW_VERSION}" -t "${REGISTRY}/${APP_NAME}:latest" .
# Step5: 推送
docker push "${REGISTRY}/${APP_NAME}:${NEW_VERSION}"
docker push "${REGISTRY}/${APP_NAME}:latest"
echo "✓ 镜像已更新并推送: ${REGISTRY}/${APP_NAME}:${NEW_VERSION}"

2 进阶方案：关联Git提交与K8s滚动更新

考虑更严谨的CI/CD需求,增加以下能力：

Git commit嵌入版本（便于溯源）
自动更新K8s Deployment image字段

# 提取最新Git commit hash (前7位)
GIT_HASH=$(git log --pretty=format:"%h" -1)
GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD | sed 's/\\//_/g')
# 版本格式： branch.patch.commit
FULL_VERSION="${GIT_BRANCH}.${NEW_VERSION}.${GIT_HASH}"
# … 构建推送同上 …
# 更新K8s部署YAML（需确保已有deployment.yaml）
kubectl set image deployment/${APP_NAME} ${APP_NAME}=${REGISTRY}/${APP_NAME}:${FULL_VERSION} --namespace=production --record
# 或者修改本地yaml文件后apply
sed -i "s|image: ${REGISTRY}/${APP_NAME}:.*|image: ${REGISTRY}/${APP_NAME}:${FULL_VERSION}|g" k8s/deployment.yaml
kubectl apply -f k8s/deployment.yaml

3 企业级方案：多环境版本管理

# 区分测试/预发布/生产环境版本策略
ENV=${1:-dev}   # 通过参数传入环境
case "$ENV" in
  dev)
    # 测试环境采用时间戳+commit
    TAG="dev-$(date +%Y%m%d%H%M)-${GIT_HASH}"
    K8S_NAMESPACE="dev"
    ;;
  staging)
    # 预发布采用语义化版本+rc
    TAG="v${MAJOR}.${MINOR}.${PATCH}-rc.${BUILD_NUM}"
    K8S_NAMESPACE="staging"
    ;;
  prod)
    # 生产只能从稳定tag构建
    TAG="v${MAJOR}.${MINOR}.${PATCH}"
    K8S_NAMESPACE="production"
    ;;
esac
# … 后续构建部署 …

常见陷阱与最佳实践（FAQ问答）

Q1: 如何确保新版本不覆盖已有镜像标签？

A: 在推送前尝试docker pull检查标签是否存在：

if docker pull "${REGISTRY}/${APP_NAME}:${NEW_VERSION}" >/dev/null 2>&1; then
    echo "错误：版本 ${NEW_VERSION} 已存在，请增加build num"
    exit 1
fi

Q2: 脚本执行失败（如网络超时）导致版本混乱怎么办？

A: 采用 幂等设计：每次构建前从git tag或远程API获取最新版本，而非依赖本地文件，加入事务性检查：推送成功后修改K8s,推送失败则清理已构建的本地镜像。

Q3: 镜像版本与代码版本不同步（git commit漂移）？

A: 在docker build前强制检查当前工作区是否有未提交修改：

if ! git diff-index --quiet HEAD --; then
    echo "工作区有未提交修改，建议先commit再构建"
    exit 1
fi

Q4: 如何批量更新多个关联服务的版本？

A: 维护一个service_list.txt文件，逐行读取,用函数抽离通用流程：

SERVICES=("user-service" "order-service" "payment-service")
for svc in "${SERVICES[@]}"; do
    (cd "./${svc}" && ./update_version.sh) &
done
wait
echo "所有服务版本更新完成"

Q5: 版本标签过多占用仓库空间怎么办？

A: 设置保留策略：私有仓库（如Harbor）自动清理旧标签；或脚本定期执行：

# 保留最近5个版本，删除旧版本
for TAG in $(curl -s "https://${REGISTRY}/v2/${APP_NAME}/tags/list" | jq -r '.tags[: -5] | .[]'); do
    curl -X DELETE "https://${REGISTRY}/v2/${APP_NAME}/manifests/$(curl -s -H "Accept: application/vnd.docker.distribution.manifest.v2+json" "https://${REGISTRY}/v2/${APP_NAME}/manifests/${TAG}" | jq -r '.config.digest')"
done