一、Gitlab中文版安装
在搭建过程中遇到了很多问题，比较突出的三个问题是:
a.docker下载镜像缓慢，每次需要大概几个小时；
b.docker下载完成之后，运行镜像服务器死机；
c.docker安装并成功运行gitlab容器之后，访问gitlab发现一直出现502错误。
gitlab中文版是基于 GitLab 官方社区版 Docker 镜像制作的中文 Docker 镜像， 汉化补丁来自网友 larryli (8.8.5之前)， 后续由网友 xhang 维护。
1 拉取gitlab docker镜像
docker pull gitlab/gitlab-ce:latest
2 配置变量
GITLAB_HOME=`pwd`/data/gitlab
3 启动容器
docker run -d --hostname gitlab --publish 8443:443 --publish 8089:80 --publish 2223:22 --name gitlab --restart always --volume $GITLAB_HOME/config:/etc/gitlab --volume $GITLAB_HOME/logs:/var/log/gitlab --volume $GITLAB_HOME/data:/var/opt/gitlab beginor/gitlab-ce:11.3.0-ce.0
4 配置邮箱
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_port'] = 25gitlab_rails['smtp_user_name'] = "xxxx@163.com"gitlab_rails['smtp_password'] = "xxxxpassword"
gitlab_rails['smtp_domain'] = "163.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = false
gitlab_rails['smtp_openssl_verify_mode'] = "peer"
gitlab_rails['gitlab_email_from'] = "xxxx@163.com"
user["git_user_email"] = "xxxx@163.com"
4 配置外部访问URL
external_url "http://10.103.240.36:8080" //如果配置了端口需要变更gitlab端口号以及docker映射端口号
5 重启docker gitlab
docker restart gitlab
注意点：http的端口修改后一定要将docker映射端口改掉，否则会访问不了！
二、gitlab-runner安装
1、获取镜像
执行以下命令，获取gitlab-runner 镜像
docker pull gitlab/gitlab-runner
2、配置变量
GITLAB_RUNNER_HOME=`pwd`/data/gitlab-runner
3、启动runner
sudo docker run -d --name gitlab-runner --restart always -v $GITLAB_RUNNER_HOME/config:/etc/gitlab-runner -v $GITLAB_RUNNER_HOME/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest
4、注册runner
docker exec -it gitlab-runner gitlab-ci-multi-runner register
按照提示填写相关信息
Please enter the gitlab-ci coordinator URL:
# gitlab的url, 如：http://gitlab.chain.cn
Please enter the gitlab-ci token for this runner:
# gitlab->你的项目->settings -> CI/CD ->Runners settings
Please enter the gitlab-ci description for this runner:
# 示例：demo
Please enter the gitlab-ci tags for this runner (comma separated):
# 示例：demo
Whether to run untagged builds [true/false]:
# true
Please enter the executor: docker, parallels, shell, kubernetes, docker-ssh, ssh, virtualbox, docker+machine, docker-ssh+machine:
# docker
Please enter the default Docker image (e.g. ruby:2.1):
# golang:1.9.4
成功后，可以看到gitlab->你的项目->settings -> CI/CD ->Runners settings 页面下面有以下内容：
5、定义Runner规则
在gitlab项目根目录创建.gitlab-ci.yml文件，填写runner规则，具体语法课参考官方文档：https://docs.gitlab.com/ee/ci/yaml/
6、go集成命令
下面介绍几个golang常见的集成命令
a.包列表
正如在官方文档中所描述的那样，go项目是包的集合。下面介绍的大多数工具都将使用这些包，因此我们需要的第一个命令是列出包的方法。我们可以用go list子命令来完成
go list ./...
请注意，如果我们要避免将我们的工具应用于外部资源，并将其限制在我们的代码中。 那么我们需要去除vendor 目录，命令如下：
go list ./... | grep -v /vendor/
b.单元测试
这些是您可以在代码中运行的最常见的测试。每个.go文件需要一个能支持单元测试的_test.go文件。可以使用以下命令运行所有包的测试:
go test -short $(go list ./... | grep -v /vendor/)
c.数据竞争
这通常是一个难以逃避解决的问题，go工具默认具有(但只能在linux / amd64、freebsd / amd64、darwin / amd64和windows / amd64上使用)
go test -race -short $(go list . /…| grep - v /vendor/)
d.代码覆盖
这是评估代码的质量的必备工具，并能显示哪部分代码进行了单元测试，哪部分没有。
要计算代码覆盖率，需要运行以下脚本：
PKG_LIST=$(go list ./... | grep -v /vendor/)
for package in ${PKG_LIST};do
go test -covermode=count -coverprofile "cover/${package##*/}.cov" "$package" ;
done
tail -q -n +2 cover/*.cov >> cover/coverage.cov
go tool cover -func=cover/coverage.cov
如果我们想要获得HTML格式的覆盖率报告，我们需要添加以下命令：
go tool cover -html=cover/coverage.cov -o coverage.html
e.构建
最后一旦代码经过了完全测试，我们要对代码进行编译，从而构建可以执行的二进制文件。
go build .
Makefile
如果我们不想在.gitlab-ci.yml文件中写的太复杂，那么我们可以把持续集成环境中使用的所有工具，全部打包在Makefile中，并用统一的方式调用它们。
这样的话，.gitlab-ci.yml文件就会更加简洁了。当然了，Makefile同样也可以调用*.sh脚本文件
配置实例
.gitlab-ci.yml
image: golang:1.9.4
stages:
- test
- build
before_script:
- mkdir -p /go/src/192.168.1.100/tommy /go/src/_/builds
- cp -r $CI_PROJECT_DIR /go/src/ 192.168.1.100 /tommy/demo
- ln -s /go/src/ 192.168.1.100 /tommy /go/src/_/builds/tommy
unit_tests:
stage: test
script:
- make test
tags:
- demo
race_detector:
stage: test
script:
- make race
code_coverage:
stage: test
script:
- make
coverage code_coverage_report:
stage: test
script:
- make coverhtml
only:
- master
build:
stage: build
script:
- go build .
tags:
- demo
Makefile
PROJECT_NAME := "demo"
PKG := "192.168.1.100/tommy/$(PROJECT_NAME)"
PKG_LIST := $(shell go list ./... | grep -v /vendor/)
GO_FILES := $(shell find . -name '*.go' | grep -v /vendor/ | grep -v _test.go)
test: ## Run unittests
@go test -v ${PKG_LIST}
race: ## Run data race detector
@go test -race -short ${PKG_LIST}
coverage: ## Generate global code coverage report
./scripts/coverage.sh;
coverhtml: ## Generate global code coverage report in HTML
./scripts/coverage.sh html;
coverage.sh
#!/bin/bash
#
# Code coverage generation
COVERAGE_DIR="${COVERAGE_DIR:-coverage}"
PKG_LIST=$(go list ./... | grep -v /vendor/)
# Create the coverage files directory
mkdir -p "$COVERAGE_DIR";
# Create a coverage file
for each package for package in ${PKG_LIST}; do
go test -covermode=count -coverprofile "${COVERAGE_DIR}/${package##*/}.cov" "$package" ;
done ;
# Merge the coverage profile files
echo 'mode: count' > "${COVERAGE_DIR}"/coverage.cov ;
tail -q -n +2 "${COVERAGE_DIR}"/*.cov >> "${COVERAGE_DIR}"/coverage.cov ;
# Display the global code coverage
go tool cover -func="${COVERAGE_DIR}"/coverage.cov ;
# If needed, generate HTML report
if [ "$1" == "html" ];then
go tool cover -html="${COVERAGE_DIR}"/coverage.cov -o coverage.html ;
fi
# Remove the coverage files directory
rm -rf "$COVERAGE_DIR";
至此，配置结束。
