一、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";
至此，配置結束。
