GitLab 구성

GitLab은 Git 저장소의 웹 기반 호스팅 서비스입니다. 쉽게 협업할 수 있도록 저장소의 로컬 및 원격 사본을 모두 보유할 수 있습니다.

GitLab.com의 새 저장소 또는 기존 저장소에서 소스 코드를 관리하거나 회사의 GitLab 인스턴스에서 소스 코드를 관리할 수 있도록 GitLab을 도구 체인의 도구 통합으로 구성할 수 있습니다. 위키, 문제 추적 및 병합 요청을 통해 소셜 코딩에 참여하십시오.

도구 체인을 작성할 때 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오.

GitLab 저장소에 소스 코드를 저장 중인 경우 구성 가능한 통합 섹션에서 GitLab을 클릭하십시오. IBM Cloud 퍼블릭에서 이 도구 통합을 구성하는 경우 OAuth 또는 개인 액세스 토큰을 선택하여 GitLab 에 액세스할 수 있도록 IBM Cloud 에 권한을 부여해야 합니다.
- OAuth를 선택하는 경우 권한 부여 를 클릭하여 GitLab 웹 사이트로 이동하십시오. 활성 GitLab 세션이 없으면 로그인을 요구하는 프롬프트가 표시됩니다. 애플리케이션에 권한 부여를 클릭하여 IBM Cloud에서 사용자의 GitLab 계정에 액세스할 수 있도록 허용하십시오. 활성 GitLab 세션이 있지만 최근에 비밀번호를 입력하지 않은 경우, 확인을 위해 GitLab 비밀번호를 입력하도록 프롬프트가 표시될 수 있습니다.
- 개인 액세스 토큰을 선택하는 경우 GitLab 에서 저장소를 복제하고 사용자 대신 다른 조치를 수행하도록 권한을 부여하는 데 사용할 개인 액세스 토큰을 입력해야 합니다. 개인 액세스 토큰이 없는 경우 GitLab 웹 사이트의 문서에 따라 토큰을 작성할 수 있습니다. 개인 액세스 토큰에 api 권한이 있는지 확인하십시오.
자체 GitLab 서버의 저장소를 사용 중인 경우 구성 가능한 통합 섹션에서 사용자 정의 서버 추가를 클릭하십시오.

a. 사용자 정의 GitHub 서버의 제목을 입력하고, 서버의 루트 URL을 지정하고, 개인 액세스 토큰을 입력하십시오.

b. 개인 액세스 토큰이 없는 경우 GitLab 웹 사이트의 문서에 따라 토큰을 작성할 수 있습니다.

c. GitHub 서버가 에어 갭이 있거나 공용 인터넷에서 액세스할 수 없는 경우, 자체 Delivery Pipeline 프라이빗 워커를 연결하고 통합하여 내부 또는 온프레미스 리소스에 액세스할 수 있는 Kubernetes 인프라에서 실행할 수 있습니다. Delivery Pipeline 개인 작업자에 대한 자세한 내용은 Delivery Pipeline 개인 작업자 로 작업하기를 참조하세요.
GitLab 저장소의 기본 대상 저장소 위치를 검토하십시오. 해당 저장소는 샘플 저장소에서 복제됩니다. 필요한 경우 대상 저장소의 이름을 변경하십시오.

도구 체인이 있고 여기에 이 도구 통합을 추가하는 경우 다음 단계를 따르십시오.

IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 카드에서 도구 체인 보기를 클릭하십시오. 그런 다음 개요를 클릭하십시오.
도구 추가를 클릭하십시오.
도구 통합 섹션에서 GitLab을 클릭하십시오.
사용할 GitLab 서버를 클릭하십시오.
GitLab 저장소가 있으며 이를 사용하려면 저장소 유형에 대해 기존을 클릭하고 URL을 입력하십시오.
새 GitLab 저장소를 사용하려는 경우, 해당 저장소의 이름을 입력하고 복제하거나 분기시킬 저장소의 URL을 입력하며 저장소 유형을 선택하십시오.

a. 빈 저장소를 작성하려면 새로 작성을 클릭하십시오.

b. GitLab 저장소의 사본을 작성하려면 복제를 클릭하십시오.

c. 가져오기 요청을 통해 변경사항을 제공할 수 있도록 GitLab 저장소를 분기하려면 분기를 클릭하십시오.
서버에서 공용 저장소를 작성하려는 경우 이 저장소를 개인용으로 설정 선택란을 선택 취소하십시오.
문제 추적을 위해 GitLab의 Issues를 사용하려는 경우 GitLab Issues 사용 선택란을 선택하십시오.
커미트에 대한 태그 및 주석을 작성하여 코드 변경사항 배치를 추적하고 커미트에서 참조되는 문제에 대한 레이블 및 주석을 추적하려는 경우, 코드 변경사항 배치 추적 선택란을 선택하십시오. 자세한 내용은 툴체인으로 코드가 배포된 위치 추적을 참조하세요.
통합 작성을 클릭하십시오.
도구 체인의 개요 페이지에 있는 저장소 카드에서, 작업하려는 GitLab 저장소를 클릭하십시오. 선택한 저장소에 따라 저장소의 컨텐츠를 볼 수 있는 GitLab 웹 사이트 또는 회사의 GitLab 저장소가 열립니다.
GitLab Issues를 사용한 경우에는 GitLab Issues를 클릭하여 이를 여십시오. 도구 체인에 여러 개의 GitLab 저장소가 포함되어 있어도 전체 도구 체인에 대해 GitLab Issues의 이 인스턴스를 사용할 수 있습니다.

링크 중인 저장소에 대해 소유자 또는 마스터 권한이 없으면 웹훅을 사용할 수 없으므로 통합이 제한됩니다. 웹훅은 커미트가 저장소에 푸시될 때 파이프라인을 자동으로 실행하는 데 필요합니다. 웹훅이 없으면 파이프라인을 수동으로 시작해야 합니다.

API를 사용하여 GitLab 구성하기

GitLab 도구 통합은 작성, 읽기및 업데이트 도구 통합 시 도구 체인 HTTP API및 SDK 와 함께 사용할 수 있는 다음 구성 매개변수를 지원합니다.

gitlab 값을 사용하여 요청 본문에서 tool_type_id 특성을 지정해야 합니다.

GitLab 도구 통합 매개변수
매개변수	사용량	유형	Terraform 인수	설명
api_root_url	선택적, 갱신 가능	문자열	api_root_url	GitLab API의 URL입니다.
api_token	선택적, 갱신 가능	비밀번호	api_token	개인 액세스 토큰 (PAT). 이 매개변수는 `auth_type` 가 `pat` 로 설정된 경우에만 필수이며, 그렇지 않으면 무시됩니다.
auth_type	선택적, 갱신 가능, `Default: oauth`	문자열	auth_type	Git 제공자에 액세스하는 데 사용할 인증 방법을 설정하십시오.
블라인드 연결	선택적, 갱신 가능, `Default: false`	부울	블라인드 연결	이 값을 true로 설정하면 IBM Cloud가 제공한 연결 세부 정보를 확인할 수 없으므로 공용 인터넷에서 서버를 주소 지정할 수 없음을 나타냅니다. Git 서버에 대한 API 액세스가 필요한 특정 기능은 비활성화됩니다. Delivery Pipeline는 Git 서버에 네트워크 액세스 권한이 있는 개인 워커를 사용해야만 작동합니다.
기본 분기	선택적, 갱신 가능	문자열	기본 분기	Git 저장소의 기본 분기 이름입니다.
enable_traceability	선택적, 갱신 가능, `Default: false`	부울	enable_traceability	커밋, 풀 리퀘스트 및 참조된 이슈에 태그, 레이블 및 주석을 만들어 코드 변경 사항의 배포를 추적하려면 이 값을 ' `true` '로 설정하세요.
Git_ID	선택적, 불변	문자열	Git_ID	gitlab.com의 경우 이 값을 `gitlab` 로 설정하거나 사용자 정의 GitLab 서버의 GUID로 설정하십시오.
has_issues	선택적, 갱신 가능, `Default: true`	부울	toolchain_issues_enabled	GitLab 저장소에서 문제를 사용으로 설정하고 문제 도구 통합 카드를 도구 체인에 추가하려면 이 값을 `true` 로 설정하십시오. 도구 체인에서 도구 통합 카드를 제거하려면 이 값을 `false` 로 설정하십시오. 이 조치는 GitLab 저장소 자체에서 문제가 사용으로 설정되었는지 여부에 영향을 주지 않습니다.
통합 소유자	선택적, 갱신 가능	문자열	통합 소유자	Git 조작이 수행되는 사용자를 선택하십시오.
owner_id	선택적, 불변	문자열	owner_id	저장소를 소유하는 GitLab 사용자 또는 그룹입니다. 이 매개변수는 저장소를 작성하거나 저장소를 복제 또는 분기할 때 필요합니다. 이 값은 기존 저장소에 링크할 때 계산됩니다.
개인용 저장소	선택적, 불변, `Default: true`	부울	개인용 저장소	저장소를 작성하거나 저장소를 복제 또는 분기 실행할 때 저장소를 개인용으로 설정하려면 이 값을 `true` 로 설정하십시오. 이 매개변수는 기존 저장소에 링크할 때 사용되지 않습니다.
저장소 ID	선택적, 불변	문자열	저장소 ID	GitLab 프로젝트의 ID입니다.
repo_name	선택적, 불변	문자열	repo_name	생성할 GitLab 리포지토리의 이름입니다. 이 매개변수는 저장소를 작성하거나 저장소를 복제 또는 분기할 때 필요합니다. 이 값은 기존 저장소에 링크할 때 계산됩니다.
repo_url	선택적, 불변	문자열	repo_url	이 도구 통합을 위한 GitLab 저장소의 URL입니다. 이 매개변수는 기존 저장소에 링크할 때 필요합니다. 이 값은 저장소를 작성하거나 저장소를 복제 또는 분기할 때 계산됩니다.
source_repo_url	선택적, 불변	문자열	source_repo_url	분기하거나 복제할 저장소의 URL입니다. 이 매개변수는 저장소를 분기 실행하거나 복제할 때 필요하지만, 저장소를 작성하거나 기존 저장소에 링크할 때 사용되지 않습니다.
토큰 URL	선택적, 갱신 가능	문자열	토큰 URL	GitLab 서버에서 권한을 부여하는 데 사용되는 토큰 URL입니다.
유형	필수, 불변	문자열	유형	새 도구 통합을 초기화하기 위해 수행할 조작입니다. `new` 를 사용하여 Git 저장소를 작성하거나, `clone` 기존 저장소를 새 Git 저장소에 복제하거나, `fork` 기존 Git 저장소를 분기하거나, `link` 를 사용하여 기존 Git 저장소에 링크하십시오.