기록's

GitLab의 Web상의 관리 화면 Admin Erea에서는 값을 수정할 수 없으므로 직접 DB를 갱신할 필요가 있다.

Git Lab Server에 로그인하여 아래의 명령어를 입력한다.

gitlab-rails dbconsole

DB 콘솔로 전환됩니다.

identities 테이블의 extern_uid 컬럼에 정보가 저장되어 있으므로 대상자의 id를 확인하기 위해 SELECT에서 일람표시를 한다.

gitlabhq_production=> SELECT * FROM identities;

대상자의 id를 알게 되면 UPDATE에서 extern_uid 컬럼을 수정한다.

gitlabhq_production=> UPDATE identities SET extern_uid = 'uid=someuser,ou=People,dc=example,dc=com' WHERE id=1;

참조 : GitLab Omnibus LDAP User Mismatch After OU Change https://theterminallife.com/gitlab-omnibus-ldap-user-mismatch-after-ou-change/

GitLab Enterprise Edition으로 업그레이드하면 LDAP 그룹과 GitLab 그룹을 동기화할 수 있습니다.

터미널에서 설정

/etc/gitlab/gitlab.rb 편집

user_filter 와 group_base 에 설정을 추가하고 있습니다.

user_filter : LDAP 로그인 가능한 사용자를 제한

group_base : LDAP Group 으로 검색하는 기준

# .. 생략 ..
gitlab_rails['ldap_enabled'] = true
gitlab_rails['ldap_servers'] = YAML.load <<-'EOS'
   main:
     label: 'LDAP'
     host: 'ldap.naver.com'
     # .. 생략 ..
     user_filter: '(|(memberOf=cn=test-GitLab-Admins,ou=Roles,dc=naver)(memberOf=cn=test-GitLab-Users,ou=Roles,dc=naver)(memberOf=cn=Title-Developer,ou=Roles,dc=naver))'
     # .. 생략 ..
     group_base: 'ou=Roles,dc=naver'
     # .. 생략 ..

그 후 reconfigure

gitlab-ctl reconfigure

웹 화면 측에서의 설정

Admin Area → Groups → 편집하고 싶은 그룹명 → EditLDAP Synchonizations

대처 시기:2018/04

OS: CentOS 7 x86_64

Gitlab Version: 10.4.2-ce.0.el7.x86_64

참고 공식 문서:https://docs.gitlab.com/omnibus/update/README.html#from-community-edition-to-enterprise-edition

지금 설치되어 있는 GitLab CE의 버전을 확인합니다.

현재의 CE와 같은 버전의 EE을 설치하기 때문입니다.

rpm -q gitlab-ce

EE용 yum repository파일을 설정합니다.

curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

GitLab EE을 설치합니다.버전 지정시"ce"부분은 "ee"로 바꾸는 것에 주의하세요.

미리 설치된 GitLab CE패키지는 복제 합니다.

yum install gitlab-ee-10.4.2-ee.0.el7.x86_64

설치 후에는 reconfigure 합니다.

gitlab-ctl reconfigure

CE용 yum repository파일은 불필요하게 되었으므로 삭제합니다.

rm /etc/yum.repos.d/gitlab_gitlab-ce.repo

라이센스 추가 구입

GitLab Subscription Manager에 로그인

상부 메뉴 "Subscriptions"

Add more seats

새로운 합계수를 입력하고(예를 들어 현재 90개의 라이선스가 있고 5개를 늘리고 싶으면 5가 아닌 95로 입력한다) Proceed to checkout

내용을 확인하고 문제가 없으면 "Confirm Upgrade" ← 여기서 결제처리 확정

구매를 하면 라이선스 관리 이메일로 청구서와 라이선스 키 정보가 전달됩니다.

라이선스 설정

참고 공식 문서 : https://docs.gitlab.com/ee/user/admin_area/license.html

GitLab 에서 관리자 계정으로 로그인 → AdminArea → License → Upload New License

라이센스 파일을 업로드 하거나 라이센스 키 문자열을 텍스트 영역에 입력합니다.

curl -s -H "PRIVATE-TOKEN: ${GITLAB_TOKEN}" 'https://git.naver.com/api/v4/users?per_page=100&page=1'
  
curl -s -H "PRIVATE-TOKEN: ${GITLAB_TOKEN}" 'https://git.naver.com/api/v4/groups?per_page=100&page=1'

설치

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | bash
 
yum-config-manager --disable runner_gitlab-runner
yum-config-manager --disable runner_gitlab-runner-source
 
export GITLAB_RUNNER_DISABLE_SKEL=true
yum install --enablerepo=runner_gitlab-runner gitlab-runner

Docker 설치

아래의 ansible을 실행합니다.

cd git/ansible-common/
ansible-playbook -i hosts_gitlab-runner -u centos playbooks/docker/docker.yml

runner서버에서 다음 명령을 실행합니다.

gitlab-runner사용자로 docker를 다루도록 하겠습니다.

gpasswd -a gitlab-runner docker

Gitlab Token

관리자 권한으로 https://git.naver.com/admin/runners에 접속하시면 Token이 써있으니 자제합니다.

다음 gitlab-runner register 명령어로 사용합니다.

Runner의 서버에서 명령을 실행합니다

gitlab-runner register
 
Runtime platform                                    arch=amd64 os=linux pid=10537 revision=21cb397c version=13.0.1
Running in system-mode.
 
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
https://git.naver.com/                                       # <- 입력
Please enter the gitlab-ci token for this runner:
xxxxxxxxxxxxxxxxxxxx                                           # <- 입력
Please enter the gitlab-ci description for this runner:
[cocone-gitlab-runner-0.cocone]:                               # <- 입력(생략해도 됨)
Please enter the gitlab-ci tags for this runner (comma separated):
                                                               # <- 입력(생략해도 됨)
Registering runner... succeeded                     runner=xxxxxxxx
Please enter the executor: docker, docker-ssh, parallels, shell, virtualbox, docker+machine, custom, ssh, docker-ssh+machine, kubernetes:
docker                                                         # <- 입력
Please enter the default Docker image (e.g. ruby:2.6):
alpine:latest                                                  # <- 입력
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

확인방법

관리자 권한으로 https://git.naver.com/admin/runners에 접속하여 추가되어 있는지 확인합니다.

작업 순서

1. GitLab 관리 화면에서 대상 Runner를 정지한다.

https://git.naver.com/admin/runners 에 접속하여 대상 runner를 Pause 합니다.

EBS 스냅샷 수행

AWS 매니지먼트 콘솔로부터 EBS 스냅샷을 가져옵니다.

2. GitLab Runner 중지

systemctl stop gitlab-runner.service

3. 최신 GitLab Runner를 설치합니다.

export GITLAB_RUNNER_DISABLE_SKEL=true
yum install --enablerepo=runner_gitlab-runner gitlab-runner

4. GitLab Runner를 시작합니다

systemctl start gitlab-runner.service

기타 확인사항:

등록작업을 다시 할 필요가 있는지 확인한다. → 불필요

월 1회 GitLab을 수동으로 업데이트 하는 작업을 합니다.

1. GitLab 중지

액세스가 있을 때 데이터가 변경되지 않도록 중지한다.

gitlab-ctl stop

2. EBS 스냅샷 찍기

3. GitLab 재개

RPM설치 중에 백업을 작성하는 처리가 있으니 기동하지 않으면 실패합니다.

gitlab-ctl start

4. 업데이트

yum update --enablerepo=gitlab_gitlab-ee gitlab-ee

5. 재설정과 재시작

gitlab-ctl reconfigure
gitlab-ctl restart