Docke部署gitlab中文版及Runner踩坑实录

一、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'] = "[email protected]"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'] = "[email protected]"

user["git_user_email"] = "[email protected]"

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

token

成功后，可以看到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";

至此，配置结束。