如何在Bash中可靠完成GitLab仓库的删除与重建操作

核心思路 #

替代固定等待的方案是利用GitLab API轮询仓库状态：删除操作发起后，反复查询仓库是否已不存在；创建操作发起后，反复查询仓库是否已存在且状态正常。这种方式既高效又能适配不同性能的GitLab实例。

改进后的删除仓库函数 #

删除仓库后，需要确认GitLab已彻底移除该仓库，避免后续创建时冲突。以下是添加轮询逻辑的版本：

delete_existing_repository() {
  local repo_name="$1"
  local repo_username="$2"
  local personal_access_token=$(echo "$GITLAB_PERSONAL_ACCESS_TOKEN_GLOBAL" | tr -d '\r')
  local project_path="${repo_username}%2F${repo_name}"
  local api_url="${GITLAB_SERVER_HTTP_URL}/api/v4/projects/${project_path}"

  # 发起删除请求
  local delete_response
  delete_response=$(curl --silent -w "%{http_code}" -H "Content-Type: application/json" -H "Private-Token: $personal_access_token" -X DELETE "$api_url")
  local delete_http_code="${delete_response: -3}"
  local delete_body="${delete_response%???}"

  # 处理删除请求的直接结果
  case "$delete_http_code" in
    204)
      echo "删除请求已提交，等待仓库彻底移除..."
      ;;
    404)
      echo "ERROR: 要删除的GitLab仓库不存在。"
      exit 183
      ;;
    *)
      echo "ERROR: 删除仓库失败，响应内容: $delete_body"
      exit 184
      ;;
  esac

  # 轮询确认仓库已不存在
  local max_attempts=30
  local attempt=0
  while [ $attempt -lt $max_attempts ]; do
    local check_http_code=$(curl --silent -w "%{http_code}" -o /dev/null -H "Private-Token: $personal_access_token" "$api_url")
    if [ "$check_http_code" -eq 404 ]; then
      echo "仓库已彻底删除"
      return 0
    fi
    attempt=$((attempt + 1))
    sleep 2
  done

  echo "ERROR: 等待仓库删除超时"
  exit 185
}

关键改进点： #

• 捕获HTTP状态码来判断删除请求的直接结果（204表示删除请求成功接收）
• 轮询查询仓库状态，直到返回404（仓库不存在）或超时
• 设置合理的重试次数和间隔，避免无限等待

改进后的仓库创建逻辑 #

创建仓库后，需要确认仓库已完全就绪（可正常访问），再执行后续操作：

create_new_repository() {
  local gitlab_repo_name="$1"
  local personal_access_token=$(echo "$GITLAB_PERSONAL_ACCESS_TOKEN_GLOBAL" | tr -d '\r')
  local api_url="${GITLAB_SERVER_HTTP_URL}/api/v4/projects"

  # 发起创建请求
  local create_response
  create_response=$(curl --silent -w "%{http_code}" -H "Content-Type: application/json" -H "Private-Token: $personal_access_token" -d "{ \"name\": \"$gitlab_repo_name\" }" "$api_url")
  local create_http_code="${create_response: -3}"
  local create_body="${create_response%???}"

  # 处理创建请求的直接结果
  case "$create_http_code" in
    201)
      echo "创建请求已提交，等待仓库就绪..."
      # 提取仓库的完整路径（用于后续查询）
      local project_path=$(echo "$create_body" | grep -o '"path_with_namespace":"[^"]*"' | cut -d'"' -f4 | sed 's/\//%2F/g')
      local check_url="${GITLAB_SERVER_HTTP_URL}/api/v4/projects/${project_path}"
      ;;
    409)
      echo "ERROR: 仓库已存在，无法创建"
      exit 186
      ;;
    *)
      echo "ERROR: 创建仓库失败，响应内容: $create_body"
      exit 187
      ;;
  esac

  # 轮询确认仓库已就绪
  local max_attempts=30
  local attempt=0
  while [ $attempt -lt $max_attempts ]; do
    local check_response=$(curl --silent -H "Private-Token: $personal_access_token" "$check_url")
    # 检查仓库状态是否正常（这里以能获取到仓库ID为例，可根据需求调整判断逻辑）
    if echo "$check_response" | grep -q '"id":'; then
      echo "仓库已创建完成并就绪"
      return 0
    fi
    attempt=$((attempt + 1))
    sleep 2
  done

  echo "ERROR: 等待仓库创建就绪超时"
  exit 188
}

关键改进点： #

• 捕获HTTP状态码判断创建请求结果（201表示创建成功接收）
• 从创建响应中提取仓库路径，用于后续状态查询
• 轮询查询仓库详情，直到确认仓库信息可正常获取（表示已就绪）
• 设置超时机制，避免无限等待

使用示例 #

在脚本中按顺序调用两个函数即可：

# 先删除现有仓库
delete_existing_repository "my-repo" "my-username"

# 再创建新仓库
create_new_repository "my-repo"

内容的提问来源于stack exchange，提问作者a.t.