호스트 생성 - 개발자 도구 콘솔
(선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성연결을 위한 호스트 생성(콘솔)연결을 위한 호스트 생성(CLI)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

호스트 생성

AWS Management Console 또는 AWS Command Line Interface (AWS CLI) 를 사용하여 인프라에 설치된 타사 코드 저장소에 대한 연결을 만들 수 있습니다. 예를 들어 Amazon EC2 인스턴스에서 가상 머신으로 실행되는 GitHub 엔터프라이즈 서버가 있을 수 있습니다. GitHub 엔터프라이즈 서버에 연결하기 전에 연결에 사용할 호스트를 생성합니다.

설치된 공급자의 호스트 생성 워크플로에 대한 개요는 호스트 생성 또는 업데이트 워크플로우 섹션을 참조하십시오.

시작하기 전:

  • (선택 사항) VPC로 호스트를 생성하려면 네트워크 또는 Virtual Private Cloud(VPC)가 이미 생성되어 있어야 합니다.

  • 인스턴스가 이미 생성되어 있어야 하며, VPC와 연결하려는 경우 VPC로 호스트를 시작한 상태여야 합니다.

    참고

    각 VPC는 한 번에 하나의 호스트와만 연결할 수 있습니다.

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

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 을 참조하십시오 GitHub엔터프라이즈 서버 연결 생성 (콘솔). 콘솔이 자동으로 호스트를 생성합니다.

콘솔을 사용하여 호스트를 생성하고 GitLab 자체 관리형 연결을 생성하려면 을 참조하십시오 GitLab자체 관리형 연결을 생성하십시오.. 콘솔이 자동으로 호스트를 생성합니다.

(선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성

인프라가 네트워크 연결로 구성된 경우 이 섹션을 건너뛸 수 있습니다.

VPC에서만 호스트에 액세스할 수 있는 경우 다음 VPC 요구 사항을 따르고 계속 진행합니다.

VPC 요구 사항

VPC로 호스트를 생성하기로 선택할 수 있습니다. 다음은 설치에 대해 설정한 VPC에 따른 일반적인 VPC 요구 사항입니다.

  • 퍼블릭 및 프라이빗 서브넷을 사용하여 퍼블릭 VPC를 구성할 수 있습니다. 기본 CIDR 블록 또는 서브넷이 없는 경우 AWS 계정 에 기본 VPC를 사용할 수 있습니다.

  • 프라이빗 VPC를 구성하고 비공개 인증 기관을 사용하여 TLS 검증을 수행하도록 GitHub Enterprise Server 인스턴스를 구성한 경우 호스트 리소스에 대한 TLS 인증서를 제공해야 합니다.

  • 연결을 통해 호스트가 생성되면 웹후크의 VPC 엔드포인트 (PrivateLink) 가 자동으로 생성됩니다. 자세한 정보는 AWS CodeConnections 및 인터페이스 VPC 엔드포인트 ()AWS PrivateLink을 참조하세요.

  • 보안 그룹 구성:

    • 호스트 생성 시 사용되는 보안 그룹에는 네트워크 인터페이스가 Enterprise Server 인스턴스에 연결되도록 허용하는 인바운드 및 아웃바운드 규칙이 필요합니다. GitHub

    • GitHub Enterprise Server 인스턴스에 연결된 보안 그룹 (호스트 설정의 일부가 아님) 에는 연결을 통해 생성된 네트워크 인터페이스를 통한 인바운드 및 아웃바운드 액세스가 필요합니다.

  • VPC 서브넷들은 리전의 서로 다른 가용 영역에 상주해야 합니다. 각 가용 영역은 다른 가용 영역에서 발생한 장애를 격리시킬 수 있도록 서로 분리된 공간입니다. 각 서브넷은 단일 가용 영역 내에서만 존재해야 하며, 여러 영역으로 스케일 아웃할 수 없습니다.

VPC 및 서브넷 작업에 대한 자세한 내용은 Amazon VPC 사용 설명서에서 IPv4의 경우, VPC 및 서브넷 크기 조정을 참조하세요.

호스트 설정을 위해 제공하는 VPC 정보

다음 단계에서 연결의 호스트 리소스를 생성할 때 다음을 제공해야 합니다.

  • VPC ID: 엔터프라이즈 서버 인스턴스가 설치된 서버의 VPC ID 또는 VPN 또는 Direct Connect를 통해 설치된 GitHub GitHub 엔터프라이즈 서버 인스턴스에 액세스할 수 있는 VPC의 ID입니다.

  • 서브넷 ID 또는 ID: GitHub Enterprise Server 인스턴스가 설치된 서버의 서브넷 ID 또는 VPN 또는 Direct Connect를 통해 설치된 GitHub 엔터프라이즈 서버 인스턴스에 액세스할 수 있는 서브넷의 ID입니다.

  • 보안 그룹: GitHub Enterprise Server 인스턴스가 설치된 서버의 보안 그룹 또는 VPN 또는 Direct Connect를 통해 설치된 GitHub Enterprise Server 인스턴스에 액세스할 수 있는 보안 그룹입니다.

  • 엔드포인트: 서버 엔드포인트를 준비하고 다음 단계로 계속 진행합니다.

VPC 또는 호스트 연결 문제를 해결하는 등의 자세한 내용은 호스트의 VPC 구성 문제 해결 섹션을 참조하세요.

권한 요구 사항

호스트 생성 프로세스의 일부로 사용자를 대신하여 네트워크 리소스를 AWS CodeConnections 생성하여 VPC 연결을 용이하게 합니다. 여기에는 호스트의 데이터를 AWS CodeConnections 쿼리하기 위한 네트워크 인터페이스, 호스트가 웹후크를 통해 PrivateLink연결에 이벤트 데이터를 전송하는 VPC 엔드포인트 또는 VPC 엔드포인트가 포함됩니다. 이러한 네트워크 리소스를 생성하려면 호스트를 생성하는 역할에 다음 권한이 있어야 합니다.

ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints

VPC의 권한 또는 호스트 연결 문제를 해결하는 데 대한 자세한 내용은 호스트의 VPC 구성 문제 해결 섹션을 참조하세요.

웹후크 VPC 엔드포인트에 대한 자세한 내용은 AWS CodeConnections 및 인터페이스 VPC 엔드포인트 ()AWS PrivateLink 섹션을 참조하세요.

연결을 위한 호스트 생성(콘솔)

GitHub Enterprise Server 또는 GitLab 자체 관리형 서버와 같은 설치용 연결의 경우 호스트를 사용하여 타사 공급자가 설치된 인프라의 엔드포인트를 나타냅니다.

참고

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

VPC 호스트를 설정할 때 고려해야 할 사항에 대한 자세한 내용은 GitLab자체 관리형 연결을 생성하십시오. 섹션을 참조하세요.

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 을 참조하십시오 GitHub엔터프라이즈 서버 연결 생성 (콘솔). 콘솔이 자동으로 호스트를 생성합니다.

콘솔을 사용하여 호스트를 생성하고 GitLab 자체 관리형 연결을 생성하려면 을 참조하십시오 GitLab자체 관리형 연결을 생성하십시오.. 콘솔이 자동으로 호스트를 생성합니다.

참고

GitHub 엔터프라이즈 서버 또는 GitLab 자체 관리 계정당 한 번만 호스트를 생성할 수 있습니다. 특정 GitHub 엔터프라이즈 서버 또는 GitLab 자체 관리 계정에 대한 모든 연결은 동일한 호스트를 사용합니다.

연결을 위한 호스트 생성(CLI)

AWS Command Line Interface (AWS CLI) 를 사용하여 설치된 연결에 사용할 호스트를 만들 수 있습니다.

참고

GitHub 엔터프라이즈 서버 계정당 한 번만 호스트를 생성할 수 있습니다. 특정 GitHub 엔터프라이즈 서버 계정에 대한 모든 연결은 동일한 호스트를 사용합니다.

호스트를 사용하여 서드 파티 공급자가 설치된 인프라의 엔드포인트를 나타냅니다. CLI를 통해 호스트를 생성하려면 create-host 명령을 사용합니다. 호스트 생성을 완료하고 나면 호스트가 [보류 중(Pending)] 상태입니다. 그러면 호스트를 설정하여 [사용 가능(Available)] 상태로 전환합니다. 호스트를 사용할 수 있게 되면 연결을 생성하는 단계를 완료합니다.

중요

를 통해 생성된 AWS CLI 호스트는 기본적으로 Pending 상태입니다. CLI를 사용하여 호스트를 생성한 후 콘솔을 통해 호스트를 설정하여 호스트를 상태를 Available로 전환합니다.

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 을 참조하십시오 GitHub엔터프라이즈 서버 연결 생성 (콘솔). 콘솔이 자동으로 호스트를 생성합니다.

콘솔을 사용하여 호스트를 생성하고 GitLab 자체 관리형 연결을 생성하려면 을 참조하십시오 GitLab자체 관리형 연결을 생성하십시오.. 콘솔이 자동으로 호스트를 생성합니다.