前置条件

此篇文档是以已经安装并配置好Choerodon、Gitlab，Gitlab-Runner的基础上进行讲解。

如需进行学习Gitlab CI文件如何编写请参考官方文档

Choerodon中CI文件详解

与Choerodon集成

  • 通过Choerodon创建应用后，在Gitlab中将自动会对应创建一个Git仓库，并且会在该仓库的CI Secret中添加一个Token，它是Choerodon给该Git仓库的唯一标识，请勿更改。
  • 下面curl语句最主要是进行获取环境变量以及一些固定的函数。
  • CHOERODON_URL为Choerodon的API地址，此项建议环境变量配置在Runner中。
  • type的值有microservice、front、lib，分别对应java后端应用，前端，java库。
  1. .auto_devops: &auto_devops |
  2.   http_status_code=`curl -o .auto_devops.sh -s -m 10 --connect-timeout 10 -w %{http_code} "${CHOERODON_URL}/devops/ci?token=${Token}"`
  3.   if [ "$http_status_code" != "200" ]; then
  4.     cat .auto_devops.sh
  5.     exit 1
  6.   fi
  7.   source .auto_devops.sh
  9. before_script:
  10.   - *auto_devops

.auto_devops.sh详解

  • 上述语句就是在CI的每个JOB运行后立即请求.auto_devops.sh脚本，脚本中有该项目的相关变量和一些封装的函数。

    1. C7N_COMMIT_TIMESTAMP=$(git log -1 --pretty=format:"%ci"| awk '{print $1$2}' | sed 's/[-:]//g')
    2. C7N_COMMIT_YEAR=${C7N_COMMIT_TIMESTAMP:0:4}
    3. C7N_COMMIT_MONTH=$(echo ${C7N_COMMIT_TIMESTAMP:4:2} | sed s'/^0//')
    4. C7N_COMMIT_DAY=$(echo ${C7N_COMMIT_TIMESTAMP:6:2} | sed s'/^0//')
    5. C7N_COMMIT_HOURS=${C7N_COMMIT_TIMESTAMP:8:2}
    6. C7N_COMMIT_MINUTES=${C7N_COMMIT_TIMESTAMP:10:2}
    7. C7N_COMMIT_SECONDS=${C7N_COMMIT_TIMESTAMP:12:2}
    8. export C7N_COMMIT_TIME=$C7N_COMMIT_YEAR.$C7N_COMMIT_MONTH.$C7N_COMMIT_DAY-$C7N_COMMIT_HOURS$C7N_COMMIT_MINUTES$C7N_COMMIT_SECONDS
    10. # 8位sha值
    11. export C7N_COMMIT_SHA=$(git log -1 --pretty=format:"%H" | awk '{print substr($1,1,8)}')
    12. # 获取的项目名称
    13. export GROUP_NAME={{ GROUP_NAME }}
    14. # 获取的应用名称
    15. export PROJECT_NAME={{ PROJECT_NAME }}
    17. # 分支名
    18. if [ $CIRCLECI ]; then
    19.   export C7N_BRANCH=$(echo $CIRCLE_BRANCH | tr '[A-Z]' '[a-z]' | tr '[:punct:]' '-')
    20. elif [ $GITLAB_CI ]; then
    21.   export C7N_BRANCH=$CI_COMMIT_REF_SLUG
    22. fi
    24. # 默认Version
    25. if [ $CI_COMMIT_TAG ]; then
    26.     export C7N_VERSION=$CI_COMMIT_TAG
    27. elif [ $CIRCLE_TAG ]; then
    28.     export C7N_VERSION=$CIRCLE_TAG
    29. else
    30.     export C7N_VERSION=$C7N_COMMIT_TIME-$C7N_BRANCH
    31. fi
    32. export CI_COMMIT_TAG=$C7N_VERSION
    34. # 更新maven项目本版本号
    35. function update_pom_version(){
    36.     mvn versions:set -DnewVersion=${CI_COMMIT_TAG} || \
    37.     find . -name pom.xml | xargs xml ed -L \
    38.         -N x=http://maven.apache.org/POM/4.0.0 \
    39.         -u '/x:project/x:version' -v "${CI_COMMIT_TAG}"
    40.     mvn versions:commit
    41. }
    42. # 测试分支合并到指定分支，比如合并到master：git_merge master，默认合并到develop
    43. function git_merge(){
    44.     git config user.name ${GITLAB_USER_NAME}
    45.     git config user.email ${GITLAB_USER_EMAIL}
    46.     git checkout origin/${1:-"develop"}
    47.     git merge ${CI_COMMIT_SHA} --no-commit --no-ff
    48. }
    49. # 此项为上传构建并上传chart包到Choerodon中，只有通过此函数Choerodon才会有相应版本记录。
    50. function chart_build(){
    51.     # 查找Chart.yaml文件
    52.     CHART_PATH=`find . -maxdepth 3 -name Chart.yaml`
    53.     # 重置values.yaml文件中image.repository属性
    54.     sed -i "s,repository:.*$,repository: ${DOCKER_REGISTRY}/${GROUP_NAME}/${PROJECT_NAME},g" ${CHART_PATH%/*}/values.yaml
    55.     # 构建chart包，重写version与app-version为当前版本
    56.     helm package ${CHART_PATH%/*} --version ${CI_COMMIT_TAG} --app-version ${CI_COMMIT_TAG}
    57.     TEMP=${CHART_PATH%/*}
    58.     FILE_NAME=${TEMP##*/}
    59.     # 通过Choerodon API上传chart包
    60.     curl --fail -X POST \
    61.         -F "token=${Token}" \
    62.         -F "version=${CI_COMMIT_TAG}" \
    63.         -F "file=@${FILE_NAME}-${CI_COMMIT_TAG}.tgz" \
    64.         -F "commit=${CI_COMMIT_SHA}" \
    65.         -F "image=${DOCKER_REGISTRY}/${GROUP_NAME}/${PROJECT_NAME}:${CI_COMMIT_TAG}" \
    66.         "${CHOERODON_URL}/devops/ci"
    67. }