10.1 Gitlab Plugin 정보¶
Gitlab은 소스 저장소 기능을 제공하는 오픈 소스 툴입니다.
젠킨스 소프트웨어와 연결되어 자동화된 소스 빌드 및 배포 기능에 활용됩니다.
세렝게티에서 제공하는 Gitlab은 초기 사용자 설정이 아래와 같습니다.
- 초기 사용자 Id : root
- 초기 사용자 암호 : serengeti
초기 설정된 사용자 정보를 변경하기 위해 사용자 로그인 아이콘 메뉴를 선택하고 하단에 출력되는 설정(Settings) 메뉴를 클릭합니다.
10.1.2 외부 연동을 위한 토큰 발행¶
외부 연동에 사용되는 토큰 정보는 생성되는 시점에만 정보를 확인할 수 있기 때문에 토큰을 생성한 이후에는 해당하는 값을 잘 보관해야 합니다.
토큰 생성을 위해서 입력되는 정보는 다음과 같습니다.
- Name : 토큰을 참조하기 위한 이름
- Expires at : 토큰 만료 기간을 설정합니다. 별도의 만료일을 지정하지 않는 경우, 영구적으로 사용됩니다.
- Scopes : 토큰을 사용할 수 있는 권한을 설정합니다.
10.1.5 사용자 관리¶
Gitlab 서비스를 사용하기 위한 사용자 정보를 등록/관리하기 위해서 어드민 화면으로 이동합니다.
어드민 관리 화면에서 화면 좌측의 사용자(Users) 메뉴를 선택하여 사용자 관리 화면으로 이동합니다.
등록된 사용자 정보를 확인하고 필요한 경우 새로운 사용자를 추가할 수 있습니다.
사용자 등록에 필수적인 정보는 다음과 같습니다.
- Name : 사용자를 식별할 수 있는 출력용 이름
- Username : 사용자 Id
- Email : 사용자 정보 변경을 위한 링크 정보 전송용 Email 정보 입력
- Password : 암호는 사용자 등록 후, 변경을 통해서 수정할 수 있습니다.
10.1.6 Webhook 설정¶
Webhook 기능은 외부 CI/CD 툴과의 연동을 위해서 설정하는 기능으로 Gitlab에 소스가 Push 되거나 특정 이벤트가 발생할 떄, 발생한 정보를 외부 툴에 전송하는 기능을 수행합니다.
설정하는 절차는 Gitlab의 프로젝트 설정 메뉴에서 Webhooks 메뉴를 통해서 등록/관리하게 됩니다.
Jenkins와 연동을 위해서는 설정하는 항목은 URL과 SSL Verification 부분에 대한 설정하면 됩니다. (SSL Verification은 Https 적용 여부에 따라서 설정하거나 설정하지 않으면 됩니다.)
URL 설정
URL 설정 항목은 다음과 같은 규칙에 의해서 설정이 이루어지게 되므로 해당하는 정보를 확인해서 등록하면 됩니다.
URL 작성 규칙 : http(s):{Jenkins 관리자 ID}:{Jenkins 관리자 ID에서 생성한 API Token}@{프로젝트 Domain/IP:서비스포트}/project/{Jenkins Project}
설정 내역 테스트
설정 내역에 대한 테스트를 위해서는 항목 하단에 있는 테스트 선택항목을 선택하고 출력되는 상세 테스트 항목에서 Push Event를 선택해서 소스 코드가 Push된 조건으로 테스트를 할 수 있습니다.