本地docker搭建gitlab, 並配置ldap認證

基於Docker在Mac OS X系統中的部署和設置GitLab的具體過程如下：

 

1. 安裝Docker for Mac (參見 https://docs.docker.com/docker-for-mac/install/）

 

2. 下載GitLab鏡像

     docker pull gitlab/gitlab-ce

 

    文檔可參見 https://docs.gitlab.com/omnibus/docker/。

 

3. 運行GitLab實例

  sudo docker run -d \

    --hostname xxxx.xxxx.xx \

    --name gitlab \

    --restart always \

    --publish 30001:22 --publish 30000:80 --publish 30002:443 \

    --volume $HOME/gitlab/data:/var/opt/gitlab \

    --volume $HOME/gitlab/logs:/var/log/gitlab \

    --volume $HOME/gitlab/config:/etc/gitlab \

    gitlab/gitlab-ce

 

其中volume選項將gitlab的目錄掛載為用戶當地目錄，以免容器在停止或被刪除的時候丟失數據。publish選項將宿主機器的30000、30001和30002映射為容器的80(http)、22(ssh)和443(https)端口。

 

4.配置GitLab實例

 

GitLab的配置存儲在/etc/gitlab/gitlab.rb文件中。

 

利用命令“ sudo docker exec -it gitlab /bin/bash”可以在gitlab容器中進入bash，也可以用命令“ sudo docker exec -it gitlab vi /etc/gitlab/gitlab.rb”直接執行vi編輯GitLab配置文件。由於在運行GitLab實例時，已經用volume選項將gitlab的目錄掛載為用戶當地目錄，因此gitlab.rb文件實際位於$HOME/gitlab/config目錄下。

 

修改gitlab.rb文件后，在容器中執行命令gitlab-ctl reconfigure重新配置gitlab。

 

4.1 配置GitLab服務器的訪問地址

 

4.1.1 配置http協議所使用的訪問地址

將external_url修改為GitLab服務器的訪問地址：

    external_url ' http://xxxx.xxxx.xxx:30000'

 

由於定義的url中有端口號，需要將nginx監聽的端口號改回80，否則nginx將監聽容器的30000端口，造成GitLab無法使用：

    nginx['listen_port'] = 80

 

4.1.2 配置ssh協議所使用的訪問地址和端口

    gitlab_rails['gitlab_ssh_host'] = ‘ data.comdyn.cn'

    gitlab_rails['gitlab_shell_ssh_port'] =30001

 

4.2 配置郵箱

 

為了采用SMTP服務器而不是缺省的Sendmail發送郵件，需要修改gitlab.rb中的內容，

 

下面以網易163郵箱為例配置郵箱:

 

    gitlab_rails['gitlab_email_from'] = " [e-mail]”

    gitlab_rails['gitlab_email_reply_to'] = ‘ [e-mail]'

    

    gitlab_rails['smtp_enable'] = true

    gitlab_rails['smtp_address'] = " smtp.163.com"

    gitlab_rails['smtp_port'] = 465

    gitlab_rails['smtp_user_name'] = " [e-mail]"

    gitlab_rails['smtp_password'] = "xxxxpassword"

    gitlab_rails['smtp_domain'] = " 163.com"

    gitlab_rails['smtp_authentication'] = "login"       

    gitlab_rails['smtp_enable_starttls_auto'] = true

    gitlab_rails['smtp_tls'] =true

 

    gitlab_rails['smtp_openssl_verify_mode'] = "peer"

 

最后，用命令docker restart gitlab重啟GitLab，或者在容器中執行命令gitlab-ctl reconfigure重新配置gitlab。

 

5. 導入現有的git倉庫

 

將現有的git倉庫（如test）導入gitlab需要三步：

 

5.1 將已有的所有git倉庫的裸庫（如test.git）都拷貝到gitlab目錄中。

 

前面在運行gitlab實例時，利用volume選項已經將gitlab的數據目錄指定為$HOME/gitlab/data/，因此git倉庫將存放在目錄$HOME/gitlab/data/git-data/repositories/下。

 

gitlab允許創建組，將多個倉庫納入到一個組中，每個組在repositories下面對應於一個與組名稱相同的子目錄。將所有裸庫拷貝到與其組所對應的子目錄中。例如，如果要要將test倉庫導入到sub組中的話，則應執行：

    sudo cp -r test.gig $HOME/gitlab/data/git-data/repositories/sub/

 

5.2 利用sudo chown命令，將test.git的擁有者的用戶名和組名改為和repositories目錄的擁有者相同，以保證gitlab可以訪問該倉庫。

 

5.3 導入倉庫

 

在gitlab容器中執行gitlab-rake命令：

    sudo docker exec -it gitlab gitlab-rake gitlab:import:repos['$HOME/gitlab/data/git-data/repositories’]

導入repositories下的所有倉庫，並自動創建組。如果某倉庫在gitlab中已存在，則會跳過該倉庫。

 

 

Gitlab 11.0.3漢化完成后，需要集成域控，現將域控的配置過程描述如下：

gitlab目錄：/etc/gitlab

gitlab配置文件：/etc/gitlab/gitlab.rb

編輯gitlab.rb文件：

在gitlab.rb文件中修改下面配置，其中：

1.host，是搭建的ldap的ip，根據實際情況修改；

2.uid，可以配置cn，也可以配置uid，都能識別（具體為什么沒深入研究）；

3.bind_dn，ldap的管理員賬號，根據實際情況修改；

4.password，ldap的管理員，根據實際情況修改；

5.active_directory，似乎是針對連接是否是ad域控的標示，因為這部分是ldap的配置，故為false；

6.allow_username_or_email_login，用戶登錄是否用戶名和郵箱都可以，方便用戶故配置true；

7.base，用戶列表所在的目錄，因為新增的用戶都在ldap的People下，故這么配置，根據實際情況修改；

我的配置如下：

　　gitlab_rails['ldap_enabled'] = true 

###! **remember to close this block with 'EOS' below** 
 gitlab_rails['ldap_servers'] = YAML.load <<-'EOS' 
   main: # 'main' is the GitLab 'provider ID' of this LDAP server 
     label: 'LDAP' 
     host: '**.**.**.**' 
     port: 389 
     uid: 'sAMAccountName' 
     bind_dn: 'cn=***,cn=Users,dc=***,dc=****,dc=COM' 
     password: '*****' 
     encryption: 'plain' # "start_tls" or "simple_tls" or "plain" 
     verify_certificates: true 
     active_directory: true 
     allow_username_or_email_login: true 
     lowercase_usernames: false 
     block_auto_created_users: false 
     base: 'OU=Users,OU=*****,DC=***,DC=*****,DC=COM' 
     user_filter: '' 
     ## EE only 
#     group_base: '' 
#     admin_group: '' 
#     sync_ssh_keys: false 
# 
#   secondary: # 'secondary' is the GitLab 'provider ID' of second LDAP server 
#     label: 'LDAP' 
#     host: '_your_ldap_server' 
#     port: 389 
#     uid: 'sAMAccountName' 
#     bind_dn: '_the_full_dn_of_the_user_you_will_bind_with' 
#     password: '_the_password_of_the_bind_user' 
#     encryption: 'plain' # "start_tls" or "simple_tls" or "plain" 
#     verify_certificates: true 
#     active_directory: true 
#     allow_username_or_email_login: false 
#     lowercase_usernames: false 
#     block_auto_created_users: false 
#     base: '' 
#     user_filter: '' 
#     ## EE only 
#     group_base: '' 
#     admin_group: '' 
#     sync_ssh_keys: false 
 EOS 

 

 

重要配置參數解釋（仔細閱讀上一篇svn集成LDAP認證的文章這些參數會更好理解）：
- host：LDAP服務器地址
- port：LDAP服務端口
- uid：以哪個屬性作為驗證屬性，可以為uid、cn等，我們使用uid
- method：如果開啟了tls或ssl則填寫對應的tls或ssl，都沒有就填寫plain
- bind_dn：search搜索賬號信息的用戶完整bind（需要一個有read權限的賬號驗證通過后搜索用戶輸入的用戶名是否存在）
- password：bind_dn用戶的密碼，bind_dn和password兩個參數登錄LDAP服務器搜索用戶
- active_directory：LDAP服務是否是windows的AD，我們是用的OpenLDAP，這里寫false
- allow_username_or_email_login：是否允許用戶名或者郵箱認證，如果是則用戶輸入用戶名或郵箱都可
- base：從哪個位置搜索用戶，例如允許登錄GitLab的用戶都在ou gitlab里，name這里可以寫ou=gitlab,dc=domain,dc=com
- filter：添加過濾屬性，例如只過濾employeeType為developer的用戶進行認證（employeeType=developer）

 

配置完成后進行配置更新：

　　gitlab-ctl reconfigure

檢查是否配置成功：

　　gitlab-rake gitlab:ldap:check（列出前100個用戶）

重啟gitlab服務：

　　gitlab-ctl restart

 

注意:  確認該用戶不處於特殊狀態

 

1.不處於“禁用賬戶”的狀態；

 

2.不處於“需要首次登錄修改密碼”的狀態；

 

（處於上面任意一種狀態的賬戶在登錄gitlab時都會報“Cloud not authenticate you from Ldapmain because "Invalid creadentials".”）

下圖是發出的search 用戶狀態的請求:

判斷用戶狀態碼:

https://www.cnblogs.com/tldxh/p/7093360.html