一、Gitlab中文版安裝
在搭建過(guò)程中遇到了很多問(wèn)題，比較突出的三個(gè)問(wèn)題是:
a.docker下載鏡像緩慢戈钢，每次需要大概幾個(gè)小時(shí)；
b.docker下載完成之后是尔，運(yùn)行鏡像服務(wù)器死機(jī)殉了；
c.docker安裝并成功運(yùn)行g(shù)itlab容器之后，訪問(wèn)gitlab發(fā)現(xiàn)一直出現(xiàn)502錯(cuò)誤嗜历。
gitlab中文版是基于 GitLab 官方社區(qū)版 Docker 鏡像制作的中文 Docker 鏡像宣渗， 漢化補(bǔ)丁來(lái)自網(wǎng)友 larryli (8.8.5之前)抖所， 后續(xù)由網(wǎng)友 xhang 維護(hù)。
1 拉取gitlab docker鏡像
docker pull gitlab/gitlab-ce:latest
2 配置變量
GITLAB_HOME=`pwd`/data/gitlab
3 啟動(dòng)容器
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?配置外部訪問(wèn)URL
external_url "http://10.103.240.36:8080"? //如果配置了端口需要變更gitlab端口號(hào)以及docker映射端口號(hào)
5 重啟docker gitlab
docker restart gitlab
注意點(diǎn)：http的端口修改后一定要將docker映射端口改掉痕囱，否則會(huì)訪問(wèn)不了田轧！
二、gitlab-runner安裝
1鞍恢、獲取鏡像
執(zhí)行以下命令傻粘，獲取gitlab-runner 鏡像
docker pull gitlab/gitlab-runner
2、配置變量
GITLAB_RUNNER_HOME=`pwd`/data/gitlab-runner
3帮掉、啟動(dòng)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弦悉、注冊(cè)runner
docker exec -it gitlab-runner gitlab-ci-multi-runner register
按照提示填寫(xiě)相關(guān)信息
Please enter the gitlab-ci coordinator URL:
# gitlab的url, 如：http://gitlab.chain.cn
Please enter the gitlab-ci token for this runner:
# gitlab->你的項(xiàng)目->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->你的項(xiàng)目->settings -> CI/CD ->Runners settings 頁(yè)面下面有以下內(nèi)容：
5蟆炊、定義Runner規(guī)則
在gitlab項(xiàng)目根目錄創(chuàng)建.gitlab-ci.yml文件稽莉，填寫(xiě)runner規(guī)則，具體語(yǔ)法課參考官方文檔：https://docs.gitlab.com/ee/ci/yaml/
6涩搓、go集成命令
下面介紹幾個(gè)golang常見(jiàn)的集成命令
a.包列表
正如在官方文檔中所描述的那樣污秆，go項(xiàng)目是包的集合。下面介紹的大多數(shù)工具都將使用這些包昧甘，因此我們需要的第一個(gè)命令是列出包的方法良拼。我們可以用go list子命令來(lái)完成
go list ./...
請(qǐng)注意，如果我們要避免將我們的工具應(yīng)用于外部資源充边，并將其限制在我們的代碼中庸推。 那么我們需要去除vendor 目錄，命令如下：
go list ./... | grep -v /vendor/
b.單元測(cè)試
這些是您可以在代碼中運(yùn)行的最常見(jiàn)的測(cè)試浇冰。每個(gè).go文件需要一個(gè)能支持單元測(cè)試的_test.go文件贬媒。可以使用以下命令運(yùn)行所有包的測(cè)試:
go test -short $(go list ./... | grep -v /vendor/)
c.數(shù)據(jù)競(jìng)爭(zhēng)
這通常是一個(gè)難以逃避解決的問(wèn)題肘习，go工具默認(rèn)具有(但只能在linux / amd64掖蛤、freebsd / amd64、darwin / amd64和windows / amd64上使用)
go test -race -short $(go list . /…| grep - v /vendor/)
d.代碼覆蓋
這是評(píng)估代碼的質(zhì)量的必備工具井厌，并能顯示哪部分代碼進(jìn)行了單元測(cè)試，哪部分沒(méi)有致讥。
要計(jì)算代碼覆蓋率仅仆，需要運(yùn)行以下腳本：
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格式的覆蓋率報(bào)告，我們需要添加以下命令：
go tool cover -html=cover/coverage.cov -o coverage.html
e.構(gòu)建
最后一旦代碼經(jīng)過(guò)了完全測(cè)試垢袱，我們要對(duì)代碼進(jìn)行編譯墓拜，從而構(gòu)建可以執(zhí)行的二進(jìn)制文件。
go build .
Makefile
如果我們不想在.gitlab-ci.yml文件中寫(xiě)的太復(fù)雜请契，那么我們可以把持續(xù)集成環(huán)境中使用的所有工具咳榜，全部打包在Makefile中夏醉，并用統(tǒng)一的方式調(diào)用它們。
這樣的話涌韩，.gitlab-ci.yml文件就會(huì)更加簡(jiǎn)潔了畔柔。當(dāng)然了，Makefile同樣也可以調(diào)用*.sh腳本文件
配置實(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";
至此臣樱，配置結(jié)束靶擦。
