https://docs.gitlab.com/ee/api/README.html
https://stedolan.github.io/jq/manual/#Invokingjq

P_token:

    gitlab web : User Setting --> Access Tokens

API_VERSION:

https://gitlab.casa-systems.com/help/api/v3_to_v4.md
In GitLab 9.0 and later, API V4 is the preferred version to be used.

jq command：

https://stedolan.github.io/jq/manual/#Invokingjq

gitlab api 根据指定组名取组对象

curl --header "PRIVATE-TOKEN: $P_token" $GITLAB_INSTANCE/api/$API_VERSION/groups/${GroupName} 2>/dev/null|jq .

gitlab api 根据指定组名取组里的元素属性

curl --header "PRIVATE-TOKEN: $P_token" $GITLAB_INSTANCE/api/$API_VERSION/groups/${GroupName} 2>/dev/null|jq 'keys'

gitlab api 根据指定组名取组里的第一个project里的属性

curl --header "PRIVATE-TOKEN: $P_token" $GITLAB_INSTANCE/api/$API_VERSION/groups/${GroupName} 2>/dev/null|jq .projects[0]|jq 'keys'

gitlab api 根据指定组名取组的任一key的值

curl --header "PRIVATE-TOKEN: $P_token" $GITLAB_INSTANCE/api/$API_VERSION/groups/${GroupName

Push Rule

设置的位置 Gitlab project 的settings
repository -> Push Rules -> Commit message:

示例：

^(I|i)ssue \d{4,6} \/*
^(Issue|issue|bug|Bug) #\d{1,7} \/*

示例含义：

^(I|i)ssue 开头
\d{4,6} 表示4-6位数字
\/* 表示任意内容

即以上示例匹配以下格式：

[I|i]ssue空格4-6位数字空格任意内容
如 
Issue 1234 gfdg dgdfgdfgdff 
Issue 124455 ggfdgd gd

其他匹配细节可参考:
https://github.com/google/re2/wiki/Syntax

不符合commit message匹配规则的commit 无法被push , 此时gitlab 会给出匹配提示，以实际项目中设置的格式为准，比如：

remote: GitLab: Commit message does not follow the pattern '^(I|i)ssue \d{4,6} \/*'

以下介绍如何处理修正不匹配规则的commit message。

三种情况
- [1] gitlab web 页面直接提交时（即直接在远程push 一条commit）
- [2] 提交一个merge request 时，merge request 本身产生一条合并的commit
- [3] 本地仓库的commit 推送到远程仓库时

以上情况，在push时，会对commit message , 对merge reuqest 的title 进行上方设置规则的匹配校验，检验不成功则push 不成功。

gitlab web 页面直接提交时

提交一个merge request

本地仓库的commit 推送到远程仓库时

本地仓库的commit message 不符合匹配规则，导致在push这些不合规的commit到remote repo时报错：
--push failed: r

gitlab 的 release 功能是项目交付跟踪的一种方式

Gitlab 的release 功能不止将源代码快照（tag） 与版本对应记录，其他版本信息，如目标产物，修改说明，相关文档链接等，都可以在一个release 里跟踪。

目前在GitLab 11.7 以上版本已经包含了release 的功能，但是现在（2019-11-1）为止，Release 的入口只支持API接入。


更新信息:
Gitlab 的 release 现在已支持在界面上直接以 “new release” 进入编辑。
以下说明皆为使用 api 新建release 的方法：（此句更新于2021.5.6）

https://docs.gitlab.com/ee/api/releases/index.html

官方文档相关说明

一个release 可以包含两大块资源： 代码和链接。后续会支持更多资源的关联，包含容器等

Release assets
You can currently add the following types of assets to each Release:
    Source code: state of the repo at the time of the Release
    Links: to content such as built binaries or documentation
GitLab will support more asset types in the future, including objects such as pre-built packages, compliance/security evidence, or container images.

关联的资源

Source code

实际是映射到 tag 对应的源码版本 ，tag 信息是需要在创建release 时提供。

link

目前支持 http, https, ftp 链接。一个release 里可以有多个link , 每个link 用字典管理，分别有自己的 id tag_name n

整理中
https://about.gitlab.com/devops-tools/gerrit-vs-gitlab.html

JQ URL

https://stedolan.github.io/jq/download/
https://stedolan.github.io/jq/manual/#Invokingjq
这是一个开源工具，用于处理json 。

前言

"The API uses JSON to serialize data. You don’t need to specify .json at the end of an API URL."

在linux 下使用gitlab API 返回json 对象，经常使用python处理返回结果。 如果只是单纯地使用shell脚本中，常将其当作文本，并用sed ,grep,cut分解。但是因为它不是准确地分解对象中的组成，而是简单地通过关键字进行筛选和切割，所以经常会有遗漏或不够准确。

在linux 中安装jq , 可以在shell 中直接使用jq 对json 对象进行处理。

安装jq

下载 jq 源码包编译安装

# configure ,make ,make install 
cd jq
autoreconf -i
./configure --disable-maintainer-mode
make
sudo make install

下载二进制文件直接使用

[root@huangbei ~]# chmod +x jq-linux64
[root@huangbei ~]# mv jq-linux64 /usr/bin/jq
[root@huangbei ~]# jq
jq - commandline JSON processor [version 1.6]
Usage:  jq [options] <jq filter> [file...]
        jq [options] --args <jq filter> [strings...]
        jq [options] --jsonargs <jq filter> [JSON_TEXTS...]
jq is a tool for processing JSON inputs, applying the given 

写在前面

gitlab 的CI/CD ，即持续集成，持续构建并部署测试的过程，实质上是
1. 将持续集成的过程阶段（编译构建/打包/部署/测试）写在gitlab.yml中
2. 并将准备执行gitlab.yml脚本内容的服务器配置为gitlab服务器的一个runner。
3. 当gitlab 库中的提交时，便会自动触发一次在runner 上的持续集成过程。

创建 gitlab-ci.yml

注意: gitlab.yml 是一个yaml文件，对缩进非常严格，需要始终使用空格，而非制表符。
https://gitlab.${company}.com/help/ci/yaml/README.md
具体格式及构成可参考gitlab help/ci/yaml/README.md 文件

在库中的根目录下，创建一个名为.gitlab.yml的文件
1. 通过 CI-CD --> jobs --> CI Init 直接编辑初始化文件
2. 在库中的根目录下，创建一个名为.gitlab.yml的文件

配置库的CI/CD

在库的设置中Setting--> CI/CD --> runners 展开
使用共享 runner 去运行 ： Shared Runners
使用指定 runner 去运行 ： Specific Runners //如从新配置一台服务器作为gitlab.yml 中脚本运行的runner，请按如下配置runner执行

配置 Runner

https://docs.gitlab.com/runner/install/

安装GitLab Runner

# Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

赋执行权限

sudo chmod +x /usr/local/bin/gitlab-runner

创建 GitLab CI 用户:

git reset test.txt #将指针后移
git checkout test.txt #重新检出一份代码，检出的版本是当前workspace 最新的commit版本

test.txt ：modify ,未add ,未commit

撤销修改内容

git reset test.txt #无改变，因为未受控，未追踪
git checkout test.txt #撤销修改内容

test.txt ：modify ,add ,未commit

撤销 add

git reset test.txt #返回到未add 的状态
git checkout test.txt #撤销修改内容

test.txt ：modify ,add ,commit

撤销commit

##对于修改已经commit 到本地仓库的
git log -n 2 ##找到上一次commit pre-ID
git reset pre-ID ## 将workspace 恢复到上一条commit,即撤销本次commit
git status ## 可以看到文件又回到add 未commmit状态

对于本地仓库已经更新远程最新，想要撤销更新，回退到未更新前的某个commit 的位置

git reset ID 
git status 
git checkout  XXX  XXXXfile 

等于

git reset --hard ID  ## --hard 表示回退指针再恢复文件内容
## 即--hard == reset + checkout 
git status
# 以下摘自https://git-scm.com/book/zh/v2
虽然在调用时加上 --hard 选项可以令 git reset 成为一个危险的命令（译注：可能导致工作目录中所有当前进度丢失！），但本例中工作目录内的文件并不会被修改。 不加选项地调用 git reset 并不危险 — 它只会修改暂存区域。

以上，恢复到远程某个commit 时的版本，等到远程稳定时再用git pull 就可以重新再更新到最新