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

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

호스트 생성

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

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

시작하기 전:

  • (선택 사항) 로 호스트를 생성하려면 네트워크 또는 가상 프라이빗 클라우드()를 이미 생성했어야 VPC합니다VPC.

  • 인스턴스를 이미 생성했어야 하며, 에 연결하려는 경우 에서 호스트를 VPC시작했어야 합니다VPC.

    참고

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

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

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 섹션을 참조하세요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 단원을 참조하십시오.

  • 보안 그룹 구성:

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

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

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

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

VPC 호스트 설정에 제공하는 정보

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

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

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

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

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

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

권한 요구 사항

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

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과 같은 설치 연결의 경우 호스트를 사용하여 타사 공급자가 설치된 인프라의 엔드포인트를 나타냅니다.

참고

2024년 7월 1일부터 콘솔은 리소스 codeconnections에서 를 사용하여 연결을 생성합니다ARN. 두 서비스 접두사가 모두 있는 리소스는 콘솔에 계속 표시됩니다.

에서 호스트를 설정하기 위한 고려 사항에 대한 자세한 내용은 섹션을 VPC참조하세요자체 관리형에 대한 GitLab 연결 생성.

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 섹션을 참조하세요Enterprise Server 연결 생성 GitHub(콘솔). 콘솔이 자동으로 호스트를 생성합니다.

콘솔을 사용하여 호스트와 GitLab 자체 관리형 연결을 생성하려면 섹션을 참조하세요자체 관리형에 대한 GitLab 연결 생성. 콘솔이 자동으로 호스트를 생성합니다.

참고

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

연결용 호스트 생성(CLI)

AWS Command Line Interface (AWS CLI)를 사용하여 설치된 연결을 위한 호스트를 생성할 수 있습니다.

참고

GitHub Enterprise Server 계정당 한 번만 호스트를 생성합니다. 특정 GitHub Enterprise Server 계정에 대한 모든 연결은 동일한 호스트를 사용합니다.

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

중요

를 통해 생성된 호스트 AWS CLI 는 기본적으로 Pending 상태에 있습니다. 로 호스트를 생성한 후 콘솔을 CLI사용하여 호스트가 상태를 로 만들도록 설정합니다Available.

콘솔을 사용하여 호스트를 생성하고 GitHub Enterprise Server에 연결하려면 섹션을 참조하세요Enterprise Server 연결 생성 GitHub(콘솔). 콘솔이 자동으로 호스트를 생성합니다.

콘솔을 사용하여 호스트와 GitLab 자체 관리형 연결을 생성하려면 섹션을 참조하세요자체 관리형에 대한 GitLab 연결 생성. 콘솔이 자동으로 호스트를 생성합니다.