# 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** 노드를 선택합니다.