Gitlab使用第三篇（API与Tags）

前面我们已经讲述过Gitlab的部署以及安全相关设置，这一篇将讲述调用Gitlab提供的API来创建项目(project)，这样对我们在运维自动化过程中非常有用。

从Gitlab官方文档（https://docs.gitlab.com/ee/development/documentation/styleguide.html#curl-commands），我们可以获取到如何使用API。

调用API的第一步是生成Access Token。此处以[email protected]用户为例。

1、进入到用户设置(User Settings)

2、选择"Access Tokens"，来增加个人访问令牌，如下图1所示。

3、在Name输入一个名字，如“firefly"，在过期时间中设置一个日期，若按默认不设置，则为永不过期。

4、允许通过token访问具有哪些仅限。

图1

最后点击”Create personal access token"来生成Access Token，如图2所示，token为“ybxsZqyaSeG-wZWhL1-R”

图2

调用API的第二步，编写代码或脚本来调用，此处以curl方式来测试。

1、通过token来查看组的详细信息

curl -H "PRIVATE-TOKEN:ybxsZqyaSeG-wZWhL1-R" http://gitlab.demo.com/api/v4/groups/oa_group

执行上述命令返回信息如图3所示，从中我们可以得到oa_group组的id为7，oa_group组下有哪些project等等。

图3

2、通过token来创建仓库，默认不指定组时会创建在当前用户下。

例如，执行上述命令后，我们可以看到名为firefly的项目是在firefly用户下，如图4所示。

图4

2、通过token在指定的组下创建项目，Gitlab的API是通过指定组的ID（namespace_id）来确定组名的。

curl --request POST -H "PRIVATE-TOKEN:ybxsZqyaSeG-wZWhL1-R" --data "name=deploy_test01&namespace_id=7" http://gitlab.demo.com/api/v4/projects

或者

curl --request POST -H "PRIVATE-TOKEN:ybxsZqyaSeG-wZWhL1-R" http://gitlab.demo.com/api/v4/projects?name=deploy_test02&namespace_id=7

执行上述2条命令后，将在OA_GROUP组下创建2个仓库，如图5所示。

图5

具体更多的操作，可参考Gitlab官方文档。

----------------------------------------------------------------------------------------------------------------------------------------------

接下来我们要来说Gitlab的标签(tags)创建，目前我们对tags的用途主要是用来做为发布版本号，可用于发布版本以及回滚版本。如图6所示，为OA_GROUP组下的tc_service手动创建了标签v_20191209_1821

图6

由于该tag是手动输入的，很有可能输错或者位数不对，导致版本发布异常，所以要规范tags，不能随意命名，而是要按一定规则，比如按，即按时间命名，精确到分钟即可。再好的约束由人来执行也难免出错，所以我们要修改Gitlab的源码，让其自动生成我们所需格式的tag，并强制用户添加版本功能描述信息才能创建。最终效果如图7所示。

图7

我们看到，“Tag name”输入框自动生成了tag，并且是灰色不可修改，另外，若开发人员在“Message”对话框中若不输入描述性文字，则下方的"Create tag"按钮为灰色不可创建。这样就达到了我们规范目的，是不是比较完美，哈哈。

下一篇将继续讲述Gitlab使用第四篇（日常维护）