# CodeCatalyst 및 AWS Toolkit for JetBrains 시작하기
<a name="codecatalyst-setup"></a>

JetBrains Gateway에서 CodeCatalyst 작업을 시작하려면 다음을 완료하세요.

**Topics**
+ [JetBrains Gateway 설치](#codecatalyst-setup-jbgateway)
+ [AWS Toolkit for JetBrains Gateway 설치](#codecatalyst-setup-toolkit)
+ [CodeCatalyst 계정 및 AWS Builder ID 생성](#codecatalyst-setup-id)
+ [CodeCatalyst와 JetBrains Gateway 연결](#codecatalyst-setup-connect)

## JetBrains Gateway 설치
<a name="codecatalyst-setup-jbgateway"></a>

AWS Toolkit를 CodeCatalyst 계정과 통합하기 전에 최신 버전의 JetBrains Gateway를 사용하고 있는지 확인합니다. 최신 버전의 JetBrains Gateway를 다운로드하려면 다음 링크에서 원하는 JetBrains Gateway 배포판을 선택합니다.
+ [JetBrains Gateway for Linux](https://download.jetbrains.com/product?code=GW&latest&distribution=linux)
+ [JetBrains Gateway for Windows]( https://download.jetbrains.com/product?code=GW&latest&distribution=windows)
+ [JetBrains Gateway for macOS](https://download.jetbrains.com/product?code=GW&latest&distribution=mac)
+ [JetBrains Gateway for macOS Apple Silicon](https://download.jetbrains.com/product?code=GW&latest&distribution=macM1)

## AWS Toolkit for JetBrains Gateway 설치
<a name="codecatalyst-setup-toolkit"></a>

JetBrains를 CodeCatalyst 계정과 연결하려면 최신 버전의 도구 키트 확장을 설치해야 합니다. JetBrains **Plugins Marketplace**에서 직접 최신 버전을 찾아 도구 키트 설치를 완료할 수 있습니다.

JetBrains **Plugins Marketplace**에서 AWS Toolkit 플러그인을 설치하려면 다음 단계를 완료하세요.

1. JetBrains Gateway 기본 화면에서 애플리케이션 왼쪽 하단에 있는 **Settings/Preferences ** 아이콘을 선택합니다.

1. **Settings/Preferences**를 선택하여 **Settings/Preferences** 뷰를 엽니다.

1. **Settings/Preferences** 뷰에서 **Plugins**을 선택하여 **Plugins** 뷰를 엽니다.
**참고**  
**Marketplace** 뷰 또는 **Installed** 뷰로 **Plugins** 뷰를 열 수 있습니다.  
AWS Toolkit for JetBrains Gateway를 처음 설치하는 경우 **Plugins Marketplace** 뷰를 선택하여 계속합니다.
이전 버전의 AWS Toolkit for JetBrains Gateway가 있는 경우 **Installed** 뷰에서 업데이트합니다.

1. **Marketplace** 뷰에서 `AWS Toolkit`를 입력하고 **AWS Toolkit** 플러그인 항목이 나타나면 선택합니다.

1. **Install**을 선택하여 **AWS Toolkit for JetBrains Gateway**를 다운로드하고 설치합니다.
**참고**  
JetBrains Gateway에는 다운로드 및 설치 진행 상태가 표시됩니다. 도구 키트가 성공적으로 설치되면 JetBrains Gateway **Connections** 탐색기가 **Amazon CodeCatalyst** 플러그인 아이콘으로 업데이트됩니다.

## CodeCatalyst 계정 및 AWS Builder ID 생성
<a name="codecatalyst-setup-id"></a>

JetBrains Gateway에 연결하려면 최신 버전의 AWS Toolkit for JetBrains 설치 외에도 활성 AWS Builder ID와 CodeCatalyst 계정이 필요합니다. 활성 AWS Builder ID 또는 CodeCatalyst 계정이 없는 경우 *CodeCatalyst* User Guide의 [Setting up with CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) 섹션을 참조하세요.

**참고**  
AWS Builder ID는 AWS 보안 인증과 다릅니다. AWS 보안 인증은 AWS에서 액세스할 수 있는 대부분의 AWS 서비스에 필요합니다. AWS Builder ID는 새 CodeCatalyst 계정을 생성하고 기존 CodeCatalyst 계정에서 작업하는 데 필요합니다. 여기에는 AWS Toolkit에서 제공되는 모든 CodeCatalyst 기능을 사용한 작업이 포함됩니다.

## CodeCatalyst와 JetBrains Gateway 연결
<a name="codecatalyst-setup-connect"></a>

JetBrains Gateway를 CodeCatalyst 계정과 연결하려면 다음 단계를 완료하세요.

1. JetBrains Gateway **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택하여 **Amazon CodeCatalyst** 플러그인 뷰를 엽니다.

1. **CodeCatalyst** 플러그인 뷰에서 **Sign in with AWS Builder ID**를 선택하여 **AWS Login Required** 프롬프트를 엽니다.

1. **AWS Login Required** 프롬프트에서 **Open Browser**를 선택하여 기본 웹 브라우저에서 CodeCatalyst 콘솔 로그인 화면을 엽니다.

1. 제공된 필드에 AWS Builder ID를 입력하고 지침에 따라 계속합니다.

1. 메시지가 표시되면 **Allow**를 선택하여 JetBrains와 CodeCatalyst 계정 간 연결을 확인하세요. 연결 프로세스가 완료되면 브라우저를 닫아도 안전하다는 확인 메시지가 표시됩니다.

1. JetBrains Gateway에서 **CodeCatalyst** 플러그인 뷰가 **Dev Environments** 뷰로 업데이트됩니다.