GitLab 자체 관리형 (콘솔) 에 대한 연결 생성 GitLab자체 관리형 (CLI) 에 대한 연결 생성

GitLab자체 관리형 연결을 생성하세요.

자체 관리형 설치를 통해 GitLab 엔터프라이즈 에디션 또는 GitLab 커뮤니티 에디션에 대한 연결을 생성할 수 있습니다.

AWS Management Console 또는 AWS Command Line Interface (AWS CLI) 를 사용하여 GitLab 자체 관리용 연결 및 호스트를 만들 수 있습니다.

참고

GitLab 자체 관리에서 이 연결 애플리케이션을 승인하면 서비스에 데이터를 처리할 권한을 부여하는 것으로 간주되며, 애플리케이션을 제거하여 언제든지 권한을 취소할 수 있습니다.

GitLab 셀프 매니지드 연결을 생성하기 전에 다음 단계에 설명된 대로 연결에 사용할 호스트를 생성해야 합니다. 설치된 공급자의 호스트 생성 워크플로에 대한 개요는 호스트 생성 또는 업데이트 워크플로우 섹션을 참조하십시오.

VPC로 호스트를 구성할 수도 있습니다. 호스트 리소스의 네트워크 및 VPC 구성에 대한 자세한 내용은 (선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성 및 호스트의 VPC 구성 문제 해결의 VPC 사전 요구 사항을 참조하십시오.

시작하기 전:

에서 이미 계정을 GitLab 생성했고 자체 관리형 설치가 포함된 GitLab Enterprise Edition 또는 GitLab Community Edition이 설치되어 있어야 합니다. 자세한 내용은 https://docs.gitlab.com/ee/subscriptions/self_managed/을 참조하십시오.

참고
연결은 연결을 만들고 권한을 부여하는 데 사용된 계정에 대한 액세스 권한만 제공합니다.

참고
소유자 역할이 있는 저장소에 대한 연결을 만든 다음 GitLab, 이 연결을 다음과 같은 CodePipeline 리소스와 함께 사용할 수 있습니다. 그룹 내 리포지토리의 경우 그룹 소유자가 아니어도 됩니다.
범위가 축소된 권한만 있는 GitLab 개인 액세스 토큰 (PAT) 을 이미 생성했어야 합니다: api. 자세한 내용은 https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html을 참조하십시오. 관리자만 PAT를 만들고 사용할 수 있습니다.

참고
PAT는 호스트를 인증하는 데 사용되며 연결에 달리 저장되거나 사용되지 않습니다. 호스트를 설정하려면 임시 PAT를 만든 다음 호스트를 설정한 후 PAT를 삭제하면 됩니다.

GitLab 자체 관리형 (콘솔) 에 대한 연결 생성

다음 단계를 사용하여 호스트를 생성하고 콘솔에서 GitLab 자체 관리형 호스트에 연결할 수 있습니다. VPC에서 호스트를 설정할 때 고려해야 할 사항에 대한 자세한 내용은 (선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성 섹션을 참조하십시오.

참고

현재 콘솔을 사용하여 연결을 생성하면 리소스 codestar-connections ARN에 있는 리소스만 생성됩니다. ARN에 codeconnections 서비스 접두사가 있는 리소스를 생성하려면 CLI, SDK 또는 CFN을 사용하십시오. 두 서비스 접두사가 모두 포함된 리소스는 콘솔에 계속 표시됩니다. 콘솔 리소스 생성은 2024년 7월 1일부터 사용할 수 있습니다.

참고

단일 GitLab 자체 관리형 설치를 위한 호스트를 만든 다음 해당 호스트에 대한 하나 이상의 GitLab 자체 관리형 연결을 관리할 수 있습니다.

1단계: 호스트 생성

에 로그인한 다음 에서 AWS 개발자 도구 콘솔을 엽니다. AWS Management Consolehttps://console.aws.amazon.com/codesuite/settings/connections
[호스트(Hosts)] 탭에서 [호스트 생성(Create host)]을 선택합니다.
[호스트 이름(Host name)]에 호스트에 사용할 이름을 입력합니다.
공급업체 선택에서 GitLab 자체 관리를 선택합니다.
[URL]에 공급자가 설치된 인프라의 엔드포인트를 입력합니다.
서버가 Amazon VPC 내에 구성되어 있는데 VPC와 연결하려는 경우 [VPC 사용(Use a VPC)]을 선택합니다. 그렇지 않은 경우 [VPC 없음]을 선택합니다.
(선택 사항) Amazon VPC로 호스트를 시작한 후 VPC에 연결하려는 경우 VPC 사용을 선택하고 다음을 완료합니다.
1. [VPC ID]에서 VPC ID를 선택합니다. 호스트가 설치된 인프라의 VPC를 선택하거나 VPN 또는 Direct Connect를 통해 인스턴스에 액세스할 수 있는 VPC를 선택해야 합니다.
2. 프라이빗 VPC가 구성되어 있고 퍼블릭이 아닌 인증 기관을 사용하여 TLS 검증을 수행하도록 호스트를 구성한 경우 TLS 인증서에 인증서 ID를 입력합니다. TLS 인증서 값은 인증서의 퍼블릭 키입니다.
[호스트 생성(Create host)]을 선택합니다.
호스트 세부 정보 페이지가 표시된 후, 호스트가 생성됨에 따라 호스트 상태가 바뀝니다.

참고
호스트 설정에 VPC 구성이 포함된 경우 호스트 네트워크 구성 요소를 프로비저닝하는 데 몇 분 정도 걸립니다.

호스트가 [보류 중(Pending)] 상태가 될 때까지 기다린 다음 설치를 완료합니다. 자세한 정보는 보류 중인 호스트 설정을 참조하세요.

2단계: 보류 중인 호스트 설정

호스트 설정을 선택합니다.
host_name 설정 페이지가 표시됩니다. 개인 액세스 토큰 제공에서 GitLab PAT에 다음과 같은 범위 축소 권한만 제공하십시오. api

참고
관리자만 PAT를 만들고 사용할 수 있습니다.
호스트가 성공적으로 등록되면 호스트 세부 정보 페이지가 나타나고 호스트 상태가 [사용 가능(Available)]으로 표시됩니다.

3단계: 연결 생성

에 로그인한 다음 에서 AWS 개발자 도구 콘솔을 엽니다https://console.aws.amazon.com/codesuite/settings/connections. AWS Management Console
설정을 선택한 다음 연결을 선택합니다. 연결 생성을 선택합니다.
GitLab 리포지토리에 대한 연결을 생성하려면 공급자 선택에서 GitLab 자체 관리를 선택합니다. [연결 이름(Connection name)]에 생성하려는 연결의 이름을 입력합니다.
[URL]에 서버의 엔드포인트를 입력합니다.
Amazon VPC로 서버를 시작한 후 VPC에 연결하려는 경우 [VPC 사용(Use a VPC)]을 선택하고 다음을 완료합니다.
1. [VPC ID]에서 VPC ID를 선택합니다. 호스트가 설치된 인프라의 VPC를 선택하거나 VPN 또는 Direct Connect를 통해 호스트에 액세스할 수 있는 VPC를 선택해야 합니다.
2. [서브넷 ID(Subnet ID)]를 선택하고 [추가(Add)]를 선택합니다. 해당 필드에서 호스트에 사용할 서브넷 ID를 선택합니다. 서브넷은 최대 10개까지 선택할 수 있습니다.
  
  호스트가 설치된 인프라의 서브넷을 선택하거나 VPN 또는 Direct Connect를 통해 설치된 호스트에 액세스할 수 있는 서브넷을 선택해야 합니다.
3. [보안 그룹 ID(Security group IDs)]에서 [추가(Add)]를 선택합니다. 해당 필드에서 호스트에 사용할 보안 그룹을 선택합니다. 보안 그룹은 최대 10개까지 선택할 수 있습니다.
  
  호스트가 설치된 인프라의 보안 그룹을 선택하거나 VPN 또는 Direct Connect를 통해 설치된 호스트에 액세스할 수 있는 보안 그룹을 선택해야 합니다.
4. 프라이빗 VPC가 구성되어 있고 퍼블릭이 아닌 인증 기관을 사용하여 TLS 검증을 수행하도록 호스트를 구성한 경우 TLS 인증서에 인증서 ID를 입력합니다. TLS 인증서 값은 인증서의 퍼블릭 키여야 합니다.
[ GitLab 자체 관리형 시스템에 연결] 을 선택합니다. 생성된 연결은 [대기 중(Pending)] 상태로 표시됩니다. 사용자가 제공한 서버 정보를 사용하여 연결을 위한 호스트 리소스가 생성됩니다. 호스트 이름으로 URL이 사용됩니다.
[보류 중인 연결을 업데이트(Update pending connection)]를 선택합니다.
의 로그인 페이지가 GitLab 표시되면 자격 증명으로 로그인한 다음 로그인을 선택합니다.
GitLab 계정 액세스를 위한 연결 승인을 요청하는 메시지와 함께 승인 페이지가 표시됩니다.

Authorize를 선택합니다.
브라우저가 연결 콘솔 페이지로 돌아갑니다. GitLab 연결 만들기에서 연결 이름에 새 연결이 표시됩니다.
[ GitLab 자체 관리형 시스템에 연결] 을 선택합니다.

연결이 성공적으로 생성되면 성공 배너가 표시됩니다. 연결 세부 정보는 연결 설정 페이지에 나와 있습니다.

GitLab자체 관리형 (CLI) 에 대한 연결 생성

AWS Command Line Interface (AWS CLI) 를 사용하여 자체 관리용 GitLab 호스트와 연결을 생성할 수 있습니다.

이렇게 하려면 create-host 및 create-connection 명령을 사용합니다.

중요

OR를 통해 생성된 AWS CloudFormation 연결은 기본적으로 PENDING 상태입니다. AWS CLI CLI를 사용하여 연결을 생성한 후 콘솔을 사용하여 연결을 편집하여 상태를 설정합니다. AWS CloudFormationAVAILABLE

1단계: GitLab 자체 관리형 (CLI) 용 호스트 생성하기

터미널(Linux, macOS, Unix) 또는 명령 프롬프트(Windows)를 엽니다. AWS CLI 를 사용하여 연결에 --name--provider-type, 및 --provider-endpoint 를 지정하여 create-host 명령을 실행합니다. 이 예제에서 서드 파티 공급자 이름은 GitLabSelfManaged이고 엔드포인트는 my-instance.dev입니다.
```
aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"
```
이 명령이 제대로 실행되면 다음과 비슷한 호스트 Amazon 리소스 이름(ARN) 정보가 반환됩니다.
```
{
    "HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
이 단계가 끝나면 호스트는 PENDING 상태입니다.
콘솔을 사용하여 호스트 설정을 완료하고 다음 단계에서 호스트를 Available 상태로 전환합니다.

2단계: 콘솔에서 보류 중인 호스트 설정

에 AWS Management Console 로그인하고 에서 개발자 도구 콘솔을 엽니다https://console.aws.amazon.com/codesuite/settings/connections.
콘솔을 사용하여 호스트 설정을 완료하고 호스트를 Available 상태로 전환합니다. 보류 중인 호스트 설정 섹션을 참조하십시오.

3단계: GitLab 자체 관리형 (CLI) 연결을 만들려면

터미널(Linux, macOS, Unix) 또는 명령 프롬프트(Windows)를 엽니다. AWS CLI 를 사용하여 연결을 --connection-name 위한 --host-arn 및 을 지정하여 create-connection 명령을 실행합니다.
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection
```
이 명령이 제대로 실행되면 다음과 비슷한 연결 ARN 정보가 반환됩니다.
```
{
    "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}
```
콘솔을 사용하여 다음 단계에서 보류 중인 연결을 설정합니다.

4단계: 콘솔에서 GitLab 자체 관리형 연결을 완료하려면

에 AWS Management Console 로그인하고 에서 개발자 도구 콘솔을 엽니다. https://console.aws.amazon.com/codesuite/settings/connections
콘솔을 사용하여 보류 중인 연결을 설정한 뒤 Available 상태로 연결을 전환합니다. 자세한 정보는 보류 중인 연결 업데이트을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

에 대한 연결 만들기 GitLab

보류 중인 연결 업데이트