# Amazon CodeCatalyst for JetBrains
<a name="codecatalyst-service"></a>

## Amazon CodeCatalyst란?
<a name="codecatalyst-intro"></a>

Amazon CodeCatalyst는 소프트웨어 개발 팀을 위한 클라우드 기반 협업 공간입니다. AWS Toolkit for JetBrains Gateway를 사용하면 JetBrains Gateway에서 직접 CodeCatalyst 리소스를 보고 관리할 수 있습니다. 또한 도구 키트를 사용하여 개발 환경 가상 컴퓨팅 환경을 시작, 관리, 편집할 수 있습니다. Codecatalyst에 대한 자세한 내용은 [Amazon CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/welcome.html) 사용 설명서를 참조하세요.

다음 주제에서는 AWS Toolkit for JetBrains Gateway를 CodeCatalyst와 연결하는 방법과 JetBrains Gateway를 통해 CodeCatalyst 작업을 수행하는 방법을 설명합니다.

**Topics**
+ [

## Amazon CodeCatalyst란?
](#codecatalyst-intro)
+ [CodeCatalyst 시작하기](codecatalyst-setup.md)
+ [CodeCatalyst 작업](codecatalyst-overview.md)

# 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** 뷰로 업데이트됩니다.

# JetBrains Gateway에서 Amazon CodeCatalyst 작업
<a name="codecatalyst-overview"></a>

JetBrains에서 개발 환경이라는 가상 컴퓨팅 환경을 시작할 수 있습니다. 개발 환경은 스페이스의 여러 팀원 간에 복사하고 공유할 수 있는 사용자 지정 가능한 클라우드 개발 환경입니다. 개발 환경에 대한 자세한 내용과 CodeCatalyst에서 이에 액세스하는 방법은 **Amazon CodeCatalyst User Guide의 [Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/codecatalyst/latest/userguide/devenvironment.html) 섹션을 참조하세요.

다음 섹션에서는 JetBrains Gateway에서 개발 환경을 생성하고 열고 작업하는 방법을 설명합니다.

**Topics**
+ [

## 개발 환경 열기
](#codecatalyst-overview-open)
+ [

## Dev Environment 생성
](#codecatalyst-overview-creating)
+ [

## 타사 리포지토리에서 개발 환경 생성
](#codecatalyst-overview-creating-source-repo)
+ [

## 개발 환경 설정 구성
](#codecatalyst-overview-configure)
+ [

## 개발 환경 일시 중지
](#codecatalyst-overview-pause)
+ [

## Dev Environment 재개
](#codecatalyst-overview-resume)
+ [

## Dev Environment 삭제
](#codecatalyst-overview-delete)
+ [

## 개발 환경 기본값 구성
](#codecatalyst-overview-default)

## 개발 환경 열기
<a name="codecatalyst-overview-open"></a>

JetBrains Gateway에서 기존 개발 환경을 열려면 다음 단계를 완료하세요.

1. **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 본문에서 열려는 개발 환경의 상위 스페이스와 프로젝트로 이동합니다.

1. 열려는 개발 환경을 선택합니다.

1. 개발 환경에 대한 열기 프로세스를 확인하여 계속합니다.
**참고**  
새 상태 창에 진행 상황이 표시됩니다. 열기 프로세스가 완료되면 개발 환경이 새 창에서 열립니다.

## Dev Environment 생성
<a name="codecatalyst-overview-creating"></a>

새 개발 환경 생성

1. **Connections** 탐색기에서 **CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 헤더 섹션에서 **Create a Dev Environment** 링크를 선택하여 **New CodeCatalyst Dev Environment** 뷰를 엽니다.

1. **New CodeCatalyst Dev Environment** 뷰에서 다음 필드를 사용하여 개발 환경 기본 설정을 구성합니다.
   + **IDE**: 개발 환경에서 실행할 기본 JetBrains IDE를 선택합니다.
   + **CodeCatalyst Project**: 개발 환경의 CodeCatalyst Space와 프로젝트를 선택합니다.
   + **Dev Environment Alias**: 개발 환경의 대체 이름을 입력합니다.
   + **Compute**: 개발 환경의 가상 하드웨어 구성을 선택합니다.
   + **Persistent storage**: 개발 환경의 영구 스토리지 양을 선택합니다.
   + **Inactivity timeout**: 개발 환경이 대기로 전환되기 전에 경과되는 시스템 유휴 시간을 선택합니다.

1. 개발 환경을 생성하려면 **개발 환경 생성**을 선택합니다.
**참고**  
**Create Dev Environment**를 선택하면 **New Dev Environment** 뷰가 닫히고 개발 환경을 생성하는 프로세스가 시작됩니다. 이 프로세스는 몇 분 정도 걸릴 수 있으며 개발 환경이 생성될 때까지 다른 JetBrains Gateway 기능을 사용할 수 없습니다.  
새 상태 창에 진행 상황이 표시됩니다. 프로세스가 완료되면 개발 환경이 새 창에서 열립니다.

## 타사 리포지토리에서 개발 환경 생성
<a name="codecatalyst-overview-creating-source-repo"></a>

리포지토리에 소스로 연결하여 타사 리포지토리에서 개발 환경을 생성할 수 있습니다.

타사 리포지토리에 소스로 연결은 CodeCatalyst의 프로젝트 수준에서 처리됩니다. 개발 환경에 타사 리포지토리를 연결하는 방법에 대한 지침과 추가 세부 정보는 **Amazon CodeCatalyst User Guide의 [Linking a source repository](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html) 주제를 참조하세요.

## 개발 환경 설정 구성
<a name="codecatalyst-overview-configure"></a>

JetBrains Gateway에서 기존 개발 환경의 설정을 변경하려면 다음 단계를 완료하세요.

**참고**  
개발 환경이 생성되면 개발 환경에 할당한 스토리지 양을 수정할 수 없습니다.

1. **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 본문에서 구성하려는 개발 환경의 상위 스페이스와 프로젝트로 이동합니다.

1. 구성하려는 개발 환경 옆의 **Settings** 아이콘을 선택하여 **Configure Dev Environment:** 설정을 엽니다.

1. **Configure Dev Environment:** 설정 메뉴에서 다음 옵션을 변경하여 개발 환경을 구성합니다.
   + **개발 환경 별칭**: 개발 환경의 대체 이름을 지정하는 선택적 필드입니다.
   + **IDE:** 개발 환경 내에서 시작하려는 JetBrains IDE를 선택합니다.
   + **Compute**: 개발 환경의 가상 하드웨어 구성을 선택합니다.
   + **Inactivity timeout**: 개발 환경이 대기로 전환되기 전에 경과되는 시스템 유휴 시간을 선택합니다.

## 개발 환경 일시 중지
<a name="codecatalyst-overview-pause"></a>

개발 환경 내 활동은 영구적으로 저장됩니다. 따라서 작업 손실 없이 개발 환경을 일시 중지하고 재개할 수 있습니다.

개발 환경을 일시 중지하려면 다음 단계를 완료하세요.

1. **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 본문에서 일시 중지하려는 개발 환경의 상위 스페이스와 프로젝트로 이동합니다.

1. 활성 개발 환경 옆의 **Pause** 아이콘을 선택하여 **Confirm Pause** 대화 상자를 엽니다.

1. **Yes**를 선택하여 **Confirm Pause** 대화 상자를 닫고 일시 중지 프로세스를 시작합니다.
**참고**  
새 상태 창에 일시 중지 프로세스의 진행 상황이 표시됩니다. 개발 환경이 중지되면 **Pause** 아이콘이 사용자 인터페이스에서 제거됩니다.

## Dev Environment 재개
<a name="codecatalyst-overview-resume"></a>

개발 환경 내 활동은 영구적으로 저장됩니다. 따라서 이전 작업의 손실 없이 일시 중지된 개발 환경을 재개할 수 있습니다.

일시 중지된 개발 환경을 재개하려면 다음 단계를 완료하세요.

1. **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 본문에서 재개하려는 개발 환경의 상위 스페이스와 프로젝트로 이동합니다.

1. 재개하려는 개발 환경을 선택합니다.
**참고**  
새 상태 창에 재개 프로세스의 진행 상황이 표시됩니다. 개발 환경이 재개되면 개발 환경의 **Settings** 아이콘 옆에 **Pause** 아이콘이 추가됩니다.

## Dev Environment 삭제
<a name="codecatalyst-overview-delete"></a>

개발 환경을 삭제하려면 다음 단계를 완료하세요.

1. **Connections** 탐색기에서 **Amazon CodeCatalyst** 플러그인을 선택합니다.

1. **Remote Development** 마법사 본문에서 삭제하려는 개발 환경의 상위 스페이스와 프로젝트로 이동합니다.

1. 개발 환경 옆의 **X** 아이콘 버튼을 선택하여 **Confirm Deletion** 대화 상자를 엽니다.

1. **Yes**를 선택하여 대화 상자를 닫고 개발 환경을 삭제합니다.
**중요**  
**Yes**를 선택하면 개발 환경이 삭제되고 검색할 수 없습니다. 개발 환경을 삭제하기 전에 코드 변경 사항을 커밋하고 원본 소스 리포지토리에 푸시해야 합니다. 그렇지 않으면 저장하지 않은 변경 사항이 영구적으로 손실됩니다.  
개발 환경이 삭제되면 **Remote Development** 마법사가 업데이트되고 개발 환경이 더 이상 리소스에 나열되지 않습니다.

## 개발 환경 기본값 구성
<a name="codecatalyst-overview-default"></a>

개발 환경의 `devfile`에서 개발 환경 기본 설정을 구성할 수 있습니다. `devfile` 사양은 YAML 문서에서 업데이트할 수 있는 개방형 표준입니다.

`devfile`을 정의하고 구성하는 방법에 대한 자세한 내용은 [devfile.io](https://devfile.io/)를 참조하세요.

JetBrains Gateway Dev Environment 인스턴스에서 `devfile`을 열고 편집하려면 다음 단계를 완료하세요.

1. 활성 JetBrains Dev Environment의 **Navigation bar**에서 **Amazon CodeCatalyst Dev Environment** 노드를 확장하여 **Backend Status Details** 메뉴를 엽니다.

1. **Configure Dev Environment** 탭을 선택하고 **Open Devfile**을 선택하여 JetBrains **Editor**에서 `devfile`을 엽니다.

1. **편집기**에서 `devfile`을 변경하고 작업을 저장합니다.

1. 변경 사항 저장 시 **Amazon CodeCatalyst Dev Environment** 노드가 개발 환경을 재구축해야 한다는 알림을 표시합니다.

1. **Amazon CodeCatalyst Dev Environment** 노드를 확장하고 **Configure Dev Environment** 탭에서 **Rebuild Dev Environment** 노드를 선택합니다.