기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 호스트 작업
GitHub Enterprise Server와 같은 설치된 공급자 유형에 대한 연결을 생성하려면 먼저 AWS Management Console을 사용하여 호스트를 생성합니다. 호스트는 공급자가 설치된 인프라를 나타내기 위해 생성하는 리소스입니다. 그런 다음 해당 호스트를 사용하여 연결을 생성합니다. 자세한 내용은 [연결 관련 작업](connections.md) 단원을 참조하십시오.
예를 들어 인프라를 나타낼 공급자의 서드 파티 앱을 등록할 수 있도록 연결을 위한 호스트를 생성합니다. 공급자 유형별로 하나의 호스트를 생성한 다음 해당 공급자 유형에 대한 모든 연결에 해당 호스트를 사용합니다.
콘솔을 사용하여 GitHub Enterprise Server와 같은 설치된 공급자 유형에 대한 연결을 생성할 경우, 콘솔이 자동으로 호스트 리소스를 생성합니다.
**Topics**
+ [호스트 생성](connections-host-create.md)
+ [보류 중인 호스트 설정](connections-host-setup.md)
+ [호스트 나열](connections-host-list.md)
+ [호스트 편집](connections-host-edit.md)
+ [호스트 삭제](connections-host-delete.md)
+ [호스트 세부 정보 보기](connections-host-view.md)
# 호스트 생성
AWS Management Console 또는 AWS Command Line Interface (AWS CLI)를 사용하여 인프라에 설치된 타사 코드 리포지토리에 대한 연결을 생성할 수 있습니다. 예를 들어 GitHub Enterprise Server가 Amazon EC2 인스턴스에서 가상 머신으로 실행될 수 있습니다. GitHub Enterprise Server에 대한 연결을 생성하기 전에 연결에 사용할 호스트를 생성합니다.
설치된 공급자의 호스트 생성 워크플로에 대한 개요는 [호스트 생성 또는 업데이트 워크플로우](welcome-hosts-workflow.md) 섹션을 참조하십시오.
시작하기 전:
+ (선택 사항) VPC로 호스트를 생성하려면 네트워크 또는 Virtual Private Cloud(VPC)가 이미 생성되어 있어야 합니다.
+ 인스턴스가 이미 생성되어 있어야 하며, VPC와 연결하려는 경우 VPC로 호스트를 시작한 상태여야 합니다.
**참고**
각 VPC는 한 번에 하나의 호스트와만 연결할 수 있습니다.
VPC로 호스트를 구성할 수도 있습니다. 호스트 리소스의 네트워크 및 VPC 구성에 대한 자세한 내용은 [(선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성](#connections-create-host-prereq) 및 [호스트의 VPC 구성 문제 해결](troubleshooting-connections.md#troubleshooting-connections-host-vpc)의 VPC 사전 요구 사항을 참조하십시오.
콘솔을 사용하여 GitHub Enterprise Server에 대한 호스트 및 연결을 생성하려면 [GitHub Enterprise Server 연결 생성(콘솔)](connections-create-gheserver-console.md#connections-create-gheserver-connection) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
콘솔을 사용하여 GitLab 자체 관리형에 대한 호스트 및 연결을 생성하려면 [GitLab 자체 관리형에 대한 연결 생성](connections-create-gitlab-managed.md) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
## (선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 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)](vpc-interface-endpoints.md) 단원을 참조하십시오.
+ 보안 그룹 구성:
+ 호스트 생성 중에 사용되는 보안 그룹에는 네트워크 인터페이스가 GitHub Enterprise Server 인스턴스에 연결할 수 있도록 허용하는 인바운드 및 아웃바운드 규칙이 필요합니다.
+ 호스트 설정에 포함되지 않은 GitHub Enterprise Server 인스턴스에 연결된 보안 그룹에는 연결에 의해 생성된 네트워크 인터페이스로부터의 인바운드 및 아웃바운드 액세스가 필요합니다.
+ VPC 서브넷들은 리전의 서로 다른 가용 영역에 상주해야 합니다. 각 가용 영역은 다른 가용 영역에서 발생한 장애를 격리시킬 수 있도록 서로 분리된 공간입니다. 각 서브넷은 단일 가용 영역 내에서만 존재해야 하며, 여러 영역으로 스케일 아웃할 수 없습니다.
VPC 및 서브넷 작업에 대한 자세한 내용은 *Amazon VPC 사용 설명서*에서 [IPv4의 경우, VPC 및 서브넷 크기 조정](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4)을 참조하세요.
**호스트 설정을 위해 제공하는 VPC 정보**
다음 단계에서 연결의 호스트 리소스를 생성할 때 다음을 제공해야 합니다.
+ **VPC ID: **GitHub Enterprise Server 인스턴스가 설치된 서버의 VPC ID이거나, VPN 또는 Direct Connect를 통해 설치된 GitHub Enterprise Server 인스턴스에 액세스할 수 있는 VPC의 ID입니다.
+ **서브넷 ID 또는 ID:** GitHub Enterprise Server 인스턴스가 설치된 서버의 서브넷 ID이거나, VPN 또는 Direct Connect를 통해 설치된 GitHub Enterprise Server 인스턴스에 액세스할 수 있는 서브넷의 ID입니다.
+ **보안 그룹 또는 그룹:** GitHub Enterprise Server 인스턴스가 설치된 서버의 보안 그룹이거나, VPN 또는 Direct Connect를 통해 설치된 GitHub Enterprise Server 인스턴스에 액세스할 수 있는 보안 그룹입니다.
+ **엔드포인트:** 서버 엔드포인트를 준비하고 다음 단계로 계속 진행합니다.
VPC 또는 호스트 연결 문제를 해결하는 등의 자세한 내용은 [호스트의 VPC 구성 문제 해결](troubleshooting-connections.md#troubleshooting-connections-host-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 구성 문제 해결](troubleshooting-connections.md#troubleshooting-connections-host-vpc) 섹션을 참조하세요.
웹후크 VPC 엔드포인트에 대한 자세한 내용은 [AWS CodeConnections 및 인터페이스 VPC 엔드포인트(AWS PrivateLink)](vpc-interface-endpoints.md) 섹션을 참조하세요.
**Topics**
+ [(선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성](#connections-create-host-prereq)
+ [연결을 위한 호스트 생성(콘솔)](#connections-host-create-console)
+ [연결을 위한 호스트 생성(CLI)](#connections-host-create-cli)
## 연결을 위한 호스트 생성(콘솔)
GitHub Enterprise Server 또는 GitLab 자체 관리형을 통한 설치 연결의 경우 호스트를 사용하여 서드 파티 공급자가 설치된 인프라의 엔드포인트를 나타냅니다.
**참고**
2024년 7월 1일부터 콘솔은 리소스 ARN`codeconnections`에서 와의 연결을 생성합니다. 두 서비스 접두사가 모두 있는 리소스는 콘솔에 계속 표시됩니다.
VPC 호스트를 설정할 때 고려해야 할 사항에 대한 자세한 내용은 [GitLab 자체 관리형에 대한 연결 생성](connections-create-gitlab-managed.md) 섹션을 참조하세요.
콘솔을 사용하여 GitHub Enterprise Server에 대한 호스트 및 연결을 생성하려면 [GitHub Enterprise Server 연결 생성(콘솔)](connections-create-gheserver-console.md#connections-create-gheserver-connection) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
콘솔을 사용하여 GitLab 자체 관리형에 대한 호스트 및 연결을 생성하려면 [GitLab 자체 관리형에 대한 연결 생성](connections-create-gitlab-managed.md) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
**참고**
GitHub Enterprise Server 또는 GitLab 자체 관리형 계정별로 한 번만 호스트를 생성할 수 있습니다. 특정 GitHub Enterprise Server 또는 GitLab 자체 관리형 계정에 대한 모든 연결은 동일한 호스트를 사용합니다.
## 연결을 위한 호스트 생성(CLI)
AWS Command Line Interface (AWS CLI)를 사용하여 설치된 연결을 위한 호스트를 생성할 수 있습니다.
**참고**
GitHub Enterprise Server 계정별로 한 번만 호스트를 생성합니다. 특정 GitHub Enterprise Server 계정에 대한 모든 연결은 동일한 호스트를 사용합니다.
호스트를 사용하여 서드 파티 공급자가 설치된 인프라의 엔드포인트를 나타냅니다. CLI를 통해 호스트를 생성하려면 **create-host** 명령을 사용합니다. 호스트 생성을 완료하고 나면 호스트가 [**보류 중(Pending)**] 상태입니다. 그러면 호스트를 *설정*하여 [**사용 가능(Available)**] 상태로 전환합니다. 호스트를 사용할 수 있게 되면 연결을 생성하는 단계를 완료합니다.
**중요**
를 통해 생성된 호스트 AWS CLI 는 기본적으로 `Pending` 상태입니다. CLI를 사용하여 호스트를 생성한 후 콘솔을 통해 호스트를 설정하여 호스트를 상태를 `Available`로 전환합니다.
콘솔을 사용하여 GitHub Enterprise Server에 대한 호스트 및 연결을 생성하려면 [GitHub Enterprise Server 연결 생성(콘솔)](connections-create-gheserver-console.md#connections-create-gheserver-connection) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
콘솔을 사용하여 GitLab 자체 관리형에 대한 호스트 및 연결을 생성하려면 [GitLab 자체 관리형에 대한 연결 생성](connections-create-gitlab-managed.md) 섹션을 참조하십시오. 콘솔이 자동으로 호스트를 생성합니다.
# 보류 중인 호스트 설정
AWS Command Line Interface (AWS CLI) 또는 SDK를 통해 생성된 호스트는 기본적으로 `Pending` 상태입니다. 콘솔 AWS CLI또는 SDK와의 연결을 생성한 후 콘솔을 사용하여 호스트가 상태가 되도록 설정합니다`Available`.
호스트가 이미 생성되어 있어야 합니다. 자세한 내용은 [호스트 생성](connections-host-create.md)을 참조하세요.
**보류 중인 호스트를 설정하려면**
생성된 호스트는 [**보류 중(Pending)**] 상태입니다. 호스트를 [**보류 중(Pending)**] 상태에서 [**사용 가능(Available)**] 상태로 전환하려면 다음 단계를 완료합니다. 이 프로세스는 타사 공급자와 핸드셰이크를 수행하여 호스트에 AWS 연결 앱을 등록합니다.
1. AWS 개발자 도구 콘솔에서 호스트가 **보류** 중 상태가 되면 **호스트 설정을** 선택합니다.
1. GitLab 자체 관리형 호스트를 만드는 경우 **설정** 페이지가 표시됩니다. **개인용 액세스 토큰 제공**에서 GitLab PAT에 다음과 같은 범위 축소 권한인 api.만 제공하십시오.
1. 서드 파티 설치 공급자 로그인 페이지(예: **GitHub Enterprise Server** 로그인 페이지)에서 메시지가 표시되면 계정 자격 증명으로 로그인합니다.
1. 앱 설치 페이지의 [**GitHub 앱 이름(GitHub App name)**]에 호스트용으로 설치할 앱의 이름을 입력합니다. [**GitHub 앱 생성(Create GitHub App)**]을 선택합니다.
1. 호스트가 성공적으로 등록되면 호스트 세부 정보 페이지가 나타나고 호스트 상태가 [**사용 가능(Available)**]으로 표시됩니다.
![\[호스트 설정이 완료되었으며 사용 가능 상태임을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/connections-create-host-register-complete.png)
1. 호스트를 사용할 수 있게 되면, 이어서 연결을 생성할 수 있습니다. 성공 배너에서 [**연결 생성(Create connection)**]을 선택합니다. [[연결 생성(Create a connection)](connections-create-gheserver-console.md)]의 단계를 수행합니다.
# 호스트 나열
개발자 도구 콘솔 또는 AWS Command Line Interface (AWS CLI)의 **list-connections** 명령을 사용하여 계정의 연결 목록을 볼 수 있습니다.
## 호스트 나열(콘솔)
**호스트를 나열하려면**
1. [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)에서 개발자 도구 콘솔을 엽니다.
1. [**호스트(Hosts)**] 탭을 선택합니다. 호스트의 이름, 상태, ARN을 봅니다.
## 호스트 나열(CLI)
를 사용하여 설치된 타사 공급자 연결에 대한 호스트를 나열 AWS CLI 할 수 있습니다.
이렇게 하려면 **list-hosts** 명령을 사용합니다.
**호스트를 나열하는 방법**
+ 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI 를 사용하여 **list-hosts** 명령을 실행합니다.
```
aws codeconnections list-hosts
```
이 명령은 다음 출력을 반환합니다.
```
{
"Hosts": [
{
"Name": "My-Host",
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://my-instance.test.dev",
"Status": "AVAILABLE"
}
]
}
```
# 호스트 편집
`Pending` 상태인 호스트의 호스트 설정을 편집할 수 있습니다. 호스트 이름, URL 또는 VPC 구성을 편집할 수 있습니다.
둘 이상의 호스트에 동일한 URL을 사용할 수 없습니다.
**참고**
VPC 호스트를 설정할 때 고려해야 할 사항에 대한 자세한 내용은 [(선택 사항) 사전 요구 사항: 연결을 위한 네트워크 또는 Amazon VPC 구성](connections-host-create.md#connections-create-host-prereq) 섹션을 참조하세요.
**호스트를 편집하려면**
1. [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)에서 개발자 도구 콘솔을 엽니다.
1. [**설정(Settings)] > [연결(Connections)**]을 선택합니다.
1. [**호스트(Hosts)**] 탭을 선택합니다.
AWS 계정과 연결되고 선택한 AWS 리전에서 생성된 호스트가 표시됩니다.
1. 호스트 이름을 편집하려면 [**이름(Name)**]에 새 값을 입력합니다.
1. 호스트 엔드포인트를 편집하려면 [**URL**]에 새 값을 입력합니다.
1. 호스트 VPC 구성을 편집하려면 [**VPC ID**]에 새 값을 입력합니다.
1. [**호스트 편집(Edit host)**]을 선택합니다.
1. 업데이트된 설정이 표시됩니다. [**보류 중인 호스트 설정(Set up Pending host)**]을 선택합니다.
# 호스트 삭제
개발자 도구 콘솔 또는 AWS Command Line Interface (AWS CLI)의 **delete-host** 명령을 사용하여 호스트를 삭제할 수 있습니다.
**Topics**
+ [호스트 삭제(콘솔)](#connections-host-delete-console)
+ [호스트 삭제(CLI)](#connections-host-delete-cli)
## 호스트 삭제(콘솔)
**호스트를 삭제하려면**
1. [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)에서 개발자 도구 콘솔을 엽니다.
1. [**호스트(Hosts)**] 탭을 선택합니다. [**이름(Name)**]에서 삭제할 호스트의 이름을 선택합니다.
1. **Delete**(삭제)를 선택합니다.
1. 필드에 **delete**를 입력하여 확인한 후, **삭제**를 선택합니다.
**중요**
이 작업은 실행을 취소할 수 없습니다.
## 호스트 삭제(CLI)
AWS Command Line Interface (AWS CLI)를 사용하여 호스트를 삭제할 수 있습니다.
이렇게 하려면 **delete-host** 명령을 사용합니다.
**중요**
호스트를 삭제하려면 먼저 호스트와 연결된 모든 연결을 삭제해야 합니다.
명령을 실행하면 호스트가 삭제됩니다. 확인 대화 상자는 표시되지 않습니다.
**호스트를 삭제하려면**
+ 터미널(Linux, macOS, Unix) 또는 명령 프롬프트(Windows)를 엽니다. AWS CLI 를 사용하여 **delete-host** 명령을 실행하고 삭제할 호스트의 Amazon 리소스 이름(ARN)을 지정합니다.
```
aws codeconnections delete-host --host-arn "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
```
이 명령은 아무 것도 반환하지 않습니다.
# 호스트 세부 정보 보기
개발자 도구 콘솔 또는 AWS Command Line Interface (AWS CLI)의 **get-host** 명령을 사용하여 호스트의 세부 정보를 볼 수 있습니다.
**호스트 세부 정보를 보려면(콘솔)**
1. AWS Management Console 에 로그인하고 [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)에서 개발자 도구 콘솔을 엽니다.
1. [**설정(Settings)] > [연결(Connections)**]을 선택한 다음 [**호스트(Hosts)**] 탭을 선택합니다.
1. 보려는 호스트 옆에 있는 버튼을 선택한 다음 [**세부 정보 보기(View details)**]를 선택합니다.
1. 호스트에 대해 다음과 같은 정보가 나타납니다.
+ 호스트 이름
+ 연결의 공급자 유형
+ 공급자가 설치된 인프라의 엔드포인트
+ 호스트의 설정 상태 연결에 사용할 준비가 된 호스트는 [**사용 가능(Available)**] 상태로 표시됩니다. 호스트가 생성되었지만 설치가 완료되지 않은 경우 호스트가 다른 상태일 수 있습니다.
사용 가능한 상태는 다음과 같습니다.
+ PENDING - 호스트가 생성 완료되었으며 호스트에 공급자 앱을 등록하여 설정을 시작할 준비가 되었습니다.
+ AVAILABLE - 호스트가 생성 및 설정 완료되었으며 연결에 사용할 수 있습니다.
+ ERROR - 호스트 생성 또는 등록 중에 오류가 발생했습니다.
+ VPC\$1CONFIG\$1VPC\$1INITIALIZING - 호스트의 VPC 구성을 생성하는 중입니다.
+ VPC\$1CONFIG\$1VPC\$1FAILED\$1INITIALIZATION - 호스트의 VPC 구성에서 오류가 발생하여 실패했습니다.
+ VPC\$1CONFIG\$1VPC\$1AVAILABLE - 호스트의 VPC 구성이 설정 완료되었으며 사용할 수 있습니다.
+ VPC\$1CONFIG\$1VPC\$1DELETING - 호스트의 VPC 구성을 삭제하는 중입니다.
![\[사용 가능 상태인 호스트의 호스트 세부 정보를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/connections-view-host-screen.png)
1. 호스트를 삭제하려면 [**삭제(Delete)**]를 선택합니다.
1. 호스트가 [**보류 중(Pending)**] 상태인 경우 설정을 완료하려면 [**호스트 설정(Set up host)**]을 선택합니다. 자세한 내용은 [보류 중인 호스트 설정](connections-host-setup.md) 섹션을 참조하세요.
**호스트 세부 정보를 보려면(CLI)**
+ 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI 를 사용하여 세부 정보를 보려는 호스트의 Amazon 리소스 이름(ARN)을 지정하여 **get-host** 명령을 실행합니다.
```
aws codeconnections get-host --host-arn arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605
```
이 명령은 다음 출력을 반환합니다.
```
{
"Name": "MyHost",
"Status": "AVAILABLE",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://test-instance-1.dev/"
}
```