기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# GitHub에 대한 연결 생성
AWS Management Console 또는 AWS Command Line Interface (AWS CLI)를 사용하여 GitHub에 대한 연결을 생성할 수 있습니다.
시작하기 전:
+ GitHub 계정이 이미 생성되어 있어야 합니다.
+ 서드 파티 코드 리포지토리가 이미 생성되어 있어야 합니다.
**참고**
연결을 생성하려면 GitHub 조직 소유자여야 합니다. 조직 소속이 아닌 리포지토리의 경우 리포지토리 소유자여야 합니다.
**Topics**
+ [GitHub에 대한 연결 생성(콘솔)](#connections-create-github-console)
+ [GitHub에 대한 연결 생성(CLI)](#connections-create-github-cli)
## GitHub에 대한 연결 생성(콘솔)
콘솔을 사용하여 GitHub에 대한 연결을 생성할 수 있습니다.
**참고**
2024년 7월 1일부터 콘솔은 리소스 ARN`codeconnections`에서 와의 연결을 생성합니다. 두 서비스 접두사가 모두 있는 리소스는 콘솔에 계속 표시됩니다.
1. 에 로그인 AWS Management Console하고에서 개발자 도구 콘솔을 엽니다[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. [**설정(Settings)] > [연결(Connections)**]을 선택한 다음 [**연결 생성(Create connection)**]을 선택합니다.
1. GitHub 또는 GitHub Enterprise Cloud 리포지토리에 대한 연결을 생성하려면 [**공급자 선택(Select a provider)**]을 선택하고 [**GitHub**]를 선택합니다. [**연결 이름(Connection name)**]에 생성하려는 연결의 이름을 입력합니다. [**GitHub에 연결(Connect to GitHub)**]을 선택하고 2단계로 진행합니다.
![\[Bitbucket에 대해 선택한 연결 옵션을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/github-conn.png)
**GitHub에 대한 연결을 생성하려면**
1. **GitHub connection settings**(GitHub 연결 설정) 아래의 **Connection name**(연결 이름)에 연결 이름이 표시됩니다. **GitHub에 연결**을 선택합니다. 액세스 요청 페이지가 표시됩니다.
![\[GitHub 계정 액세스 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/github-conn-access.png)
1. **GitHub용 AWS 커넥터 권한 부여**를 선택합니다. 연결 페이지가 나타나고 [**GitHub 앱(GitHub Apps)**] 필드가 표시됩니다.
![\[GitHub 앱 필드가 있는 초기 GitHub 연결 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/github-conn-access-app.png)
1. [**GitHub 앱(GitHub apps)**]에서 앱 설치를 선택하거나 [**새 앱 설치(Install a new app)**]을 선택하여 앱을 새로 만듭니다.
**참고**
특정 공급자에 대한 모든 연결에 대해 하나의 앱을 설치합니다. AWS Connector for GitHub 앱을 이미 설치한 경우 해당 앱을 선택하고이 단계를 건너뜁니다.
1. **AWS Connect for GitHub** 설치 페이지에서 앱을 설치할 계정을 선택합니다.
![\[GitHub용 AWS 커넥터 설치 페이지를 보여주는 콘솔 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/github-conn-access-app-install1.png)
**참고**
각 GitHub 계정마다 앱을 한 번만 설치합니다. 이전에 앱을 설치한 경우 [**구성(Configure)**]을 선택하여 앱 설치의 수정 페이지로 이동하거나 뒤로 버튼을 사용하여 콘솔로 돌아갈 수 있습니다.
1. **GitHub용 AWS 커넥터 설치** 페이지에서 기본값을 그대로 두고 **설치를** 선택합니다.
![\[GitHub용 두 번째 AWS 커넥터 설치 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/github-conn-access-app-install2.png)
이 단계를 마치면 업데이트된 권한 페이지가 GitHub에 표시될 수 있습니다.
1. AWS Connector for GitHub 앱에 대한 업데이트된 권한이 있다는 페이지가 표시되면 **Accept new permissions**(새 권한 수락)를 선택합니다.
![\[GitHub용 AWS 커넥터 업데이트된 권한 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/accept-new-permissions.png)
1. **Connect to GitHub**(GitHub에 연결) 페이지로 돌아가게 됩니다. **GitHub Apps**(GitHub 앱)에 새 설치의 연결 ID가 표시됩니다. **연결**을 선택합니다.
### 생성한 연결 보기
+ 생성된 연결이 연결 목록에 표시됩니다.
![\[연결이 성공적으로 생성된 연결의 목록을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/dtconsole/latest/userguide/images/connections-create-ghe-complete.png)
## GitHub에 대한 연결 생성(CLI)
AWS Command Line Interface (AWS CLI)를 사용하여 GitHub에 대한 연결을 생성할 수 있습니다.
이렇게 하려면 **create-connection** 명령을 사용합니다.
**중요**
AWS CLI 또는를 통해 생성된 연결 AWS CloudFormation 은 기본적으로 `PENDING` 상태입니다. CLI 또는 와의 연결을 생성한 후 콘솔을 CloudFormation사용하여 연결을 편집하여 상태를 로 설정합니다`AVAILABLE`.
**GitHub에 대한 연결을 생성하려면**
1. 터미널(Linux, macOS, Unix) 또는 명령 프롬프트(Windows)를 엽니다. AWS CLI 를 사용하여 연결을 `--connection-name` 위해 `--provider-type` 및를 지정하여 **create-connection** 명령을 실행합니다. 이 예제에서 타사 공급자 이름은 `GitHub`이고 지정된 연결 이름은 `MyConnection`입니다.
```
aws codeconnections create-connection --provider-type GitHub --connection-name MyConnection
```
이 명령이 제대로 실행되면 다음과 비슷한 연결 ARN 정보가 반환됩니다.
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. 콘솔을 사용하여 연결을 완료합니다. 자세한 내용은 [보류 중인 연결 업데이트](connections-update.md) 단원을 참조하십시오.