Gitlab使用python批量创建用户

本文使用python的python-gitlab库实现，python环境3.6.8
安装库

pip3 install python-gitlab

这里先贴出源码

# coding=utf-8
import gitlab
import requests

def add(gl):
    path = 'useradd.txt'
    with open(path,'r') as f:
        for fnun in f.readlines():
            fkey = fnun.strip()
            name = fkey.split(',')[0]
            mail = fkey.split(',')[1]
            username = mail.split('@')[0]
            passwd = fkey.split(',')[2]
            user = gl.users.create({'email':mail,'password':passwd,'username':username ,'name':name})
            print(user.username,user.id)

def main():
    gl = gitlab.Gitlab.from_config('somewhere', ['gitlab.cfg'])
    #gl = gitlab.Gitlab('http://0.0.0.0', private_token='your_token')
    add(gl)
    
if __name__ == '__main__':
    main()

在连接gitlab的时候，可以参考api官方手册，一般用两种方式直接通过ip和私有的token连接，或者使用配置文件进行连接。因为我这里配置了https，所以采用的配置文件gitlab.cfg进行连接，文件内容具体如下：

[global]
default = somewhere
ssl_verify = False
timeout = 5

[somewhere]
url = https://0.0.0.0
private_token = your_token
api_version = 4

新版的gitlab不再支持api v3，所以使用v4。这里填写上你的ip地址以及私有的token就可以了。我这里ssl选择的False因为我没有真正的证书，只是本地生成的证书。
如果不使用配置文件的方法直接用我注释的那行代码，把上面那行注释掉就可以了。
我们这里使用批量创建用户的方法是读取了当前目录下的useradd.txt的文件，格式如下：

张三,[email protected],12345678

Q&A
1.解释一下access_level这个字段的意思
gitlab里面分为Guest,Reporter,Developer,Maintainer,Owner，对应的id是10,20,30,40,50，所以这里默认用的30也就是Developer的权限，具体权限可以参考gitlab的官方文档。程序默认会让你选择他们是哪个组，可以点击组的名字看到Group ID。
2.在哪里新建私有的token
在管理员账户中点击用户头像，选择setting(设置)，再选着Access Tokens(访问令牌),填写名字，然后选择api，点击创建就可以了，一定要好好记住显示的tokens值，因为一旦离开页面，以后都看不到了，而且不要给其他人。
3.为什么创建了用户无法登陆？
gitlab要使用邮件进行确认，但是可以跳过确认用户。只需要将users.create那一段修改一下就好。
代码如下：

user = gl.users.create({'email':mail, 'password':passwd, 'username':username, 'name':name, 'skip_confirmation':True})

参考网址：
https://blog.51cto.com/8669236/2287084?source=dra
https://python-gitlab.readthedocs.io/en/stable/
https://docs.gitlab.com/ce/api/users.html