# JetBrains Gateway で Amazon CodeCatalyst を使用する
<a name="codecatalyst-overview"></a>

JetBrains から、開発環境と呼ばれる仮想コンピューティング環境を起動できます。開発環境はカスタマイズ可能なクラウド開発環境であり、スペース内のさまざまなチームメンバー間でコピーや共有をすることができます。開発環境の詳細と CodeCatalyst からアクセスする方法については、「Amazon CodeCatalyst」ユーザーガイドの「[開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/codecatalyst/latest/userguide/devenvironment.html)」セクションを参照してください。

以下のセクションでは、JetBrains Gateway から開発環境を作成し、開き、使用する方法について説明します。

**Topics**
+ [開発環境を開く](#codecatalyst-overview-open)
+ [開発環境の作成](#codecatalyst-overview-creating)
+ [サードパーティのリポジトリから開発環境を作成する](#codecatalyst-overview-creating-source-repo)
+ [開発環境設定を構成する](#codecatalyst-overview-configure)
+ [開発環境の一時停止](#codecatalyst-overview-pause)
+ [開発環境の再開](#codecatalyst-overview-resume)
+ [開発環境の削除](#codecatalyst-overview-delete)
+ [開発環境のデフォルトを設定する](#codecatalyst-overview-default)

## 開発環境を開く
<a name="codecatalyst-overview-open"></a>

JetBrains Gateway から既存の開発環境を開くには、次のステップを実行します。

1. **[接続]** エクスプローラーから **[Amazon CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードの本文で、開きたい開発環境の親スペースとプロジェクトに移動します。

1. 開く開発環境を選択します。

1. 開発環境を開くためのプロセスを確認して続行します。
**注記**  
JetBrains の新しいステータスウィンドウに進行状況が表示されます。オープンプロセスが完了すると、新しいウィンドウに開発環境が開きます。

## 開発環境の作成
<a name="codecatalyst-overview-creating"></a>

新しい開発環境を作成する方法

1. **[接続]** エクスプローラーから **[CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードのヘッダーセクションから、**[開発環境の作成]** リンクをクリックして、**[新規 CodeCatalyst 開発環境]** ビューを開きます。

1. **[新規 CodeCatalyst 開発環境]** ビューで、以下のフィールドを使用して開発環境の設定を構成します。
   + **[IDE]**: 開発環境で起動する優先 JetBrains IDE を選択します。
   + **[CodeCatalyst プロジェクト]**: 開発環境用の CodeCatalyst スペースとプロジェクトを選択します。
   + **[開発環境のエイリアス]**: 開発環境の代替名を入力します。
   + **[コンピューティング]**: 開発環境の仮想ハードウェア構成を選択します。
   + **[永続ストレージ]**: 開発環境用の永続ストレージの容量を選択します。
   + **[非アクティブタイムアウト]**: 開発環境がスタンバイ状態になるまでに経過する、システムのアイドル時間を選択します。

1. 新しい開発環境を作成するには、**[開発環境の作成]** を選択します。
**注記**  
**[開発環境の作成]** を選択すると、**[新規開発環境]** ビューが閉じられて、開発環境を作成するプロセスが開始されます。このプロセスには数分かかることがあり、開発環境が作成されるまでは、他の JetBrains Gateway 機能を使用することはできません。  
JetBrains の新しいステータスウィンドウに進行状況が表示されます。プロセスが完了すると、新しいウィンドウに開発環境が開きます。

## サードパーティのリポジトリから開発環境を作成する
<a name="codecatalyst-overview-creating-source-repo"></a>

リポジトリをソースとしてリンクすることで、サードパーティのリポジトリから開発環境を作成できます。

ソースとしてサードパーティのリポジトリにリンクすると、CodeCatalyst のプロジェクトレベルで処理されます。サードパーティのリポジトリを開発環境に接続する方法の手順や詳細については、「Amazon CodeCatalyst ユーザーガイド」の「[ソースリポジトリをリンクする](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html)」トピックを参照してください。

## 開発環境設定を構成する
<a name="codecatalyst-overview-configure"></a>

JetBrains Gateway から既存の開発環境の設定を変更するには、次のステップを実行します。

**注記**  
作成した後に、開発環境に割り当てられたストレージ容量を変更することはできません。

1. **[接続]** エクスプローラーから **[Amazon CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードの本文から、設定する開発環境の親スペースとプロジェクトに移動します。

1. 設定する開発環境の横にある **[設定]** アイコンを選択し、**[開発環境の構成]** 設定を開きます。

1. **[開発環境の設定]**: 設定メニューで、以下のオプションを変更して開発環境を設定します。
   + **[開発環境のエイリアス]**: 開発環境の代替名を指定するオプションのフィールド。
   + **[IDE]**: 開発環境内で起動する JetBrains IDE を選択します。
   + **[コンピューティング]**: 開発環境の仮想ハードウェア構成を選択します。
   + **[非アクティブタイムアウト]**: 開発環境がスタンバイ状態になるまでに経過する、システムのアイドル時間を選択します。

## 開発環境の一時停止
<a name="codecatalyst-overview-pause"></a>

開発環境内のアクティビティは永続的に保存されます。つまり、作業内容を失うことなく、開発環境を一時停止して再開することができます。

開発環境を一時停止するには、次のステップを実行します。

1. **[接続]** エクスプローラーから **[Amazon CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードの本文で、一時停止したい開発環境の親スペースとプロジェクトに移動します。

1. アクティブな開発環境の横にある **[一時停止]** アイコンを選択して、**[一時停止を確認]** ダイアログを開きます。

1. **[はい]** を選択して **[一時停止を確認]** ダイアログを閉じ、一時停止プロセスを開始します。
**注記**  
JetBrains の新しいステータスウィンドウに一時停止プロセスの進行状況が表示されます。開発環境が停止すると、**[一時停止]** アイコンがユーザーインターフェイスから消えます。

## 開発環境の再開
<a name="codecatalyst-overview-resume"></a>

開発環境内のアクティビティは永続的に保存されます。つまり、一時停止した開発環境は、作業内容を失うことなく、再開することができます。

一時停止した開発環境を再開するには、次のステップを実行します。

1. **[接続]** エクスプローラーから **[Amazon CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードの本文で、再開したい開発環境の親スペースとプロジェクトに移動します。

1. 再開する開発環境を選択します。
**注記**  
JetBrains の新しいステータスウィンドウに再開プロセスの進行状況が表示されます。開発環境が再開されると、**[一時停止]** アイコンが開発環境の **[設定]** アイコンの横に追加されます。

## 開発環境の削除
<a name="codecatalyst-overview-delete"></a>

開発環境を削除するには、次のステップを実行します。

1. **[接続]** エクスプローラーから **[Amazon CodeCatalyst]** プラグインを選択します。

1. **[リモート開発]** ウィザードの本文で、削除したい開発環境の親スペースとプロジェクトに移動します。

1. 開発環境の横にある **[X]** アイコンボタンを選択して、**[削除を確認]** ダイアログを開きます。

1. **[はい]** を選択してダイアログを閉じ、開発環境を削除します。
**重要**  
**[はい]** を選択した後、開発環境は削除され、元に戻すことはできません。開発環境を削除する前に、必ずコードの変更をコミットして元のソースリポジトリにプッシュしてください。そうしなかった場合、保存されていない変更は永続的に失われます。  
開発環境を削除すると、**[リモート開発]** ウィザードのアップデートと開発環境がリソースに含まれなくなります。

## 開発環境のデフォルトを設定する
<a name="codecatalyst-overview-default"></a>

開発環境のデフォルト設定は、開発環境の `devfile` で設定できます。`devfile` の仕様はオープンスタンダードであり、YAML ドキュメントで更新できます。

`devfile` を定義および設定する方法の詳細については、「[devfile.io](https://devfile.io/)」を参照してください。

JetBrains Gateway 開発環境インスタンスから `devfile` を開いて編集するには、次のステップを実行します。

1. アクティブな JetBrains 開発環境の **[ナビゲーションバー]** で、**[Amazon CodeCatalyst 開発環境]** ノードを展開して **[バックエンドステータスの詳細]** メニューを開きます。

1. **[開発環境の設定]** タブ、次に **[Devfile を開く]** の順に選択して、JetBrains **[エディター]** で `devfile` を開きます。

1. **[エディター]** で、`devfile` に変更を加えて作業を保存します。

1. 変更を保存すると、**[Amazon CodeCatalyst 開発環境]** ノードに開発環境の再構築が必要であることを示すアラートが表示されます。

1. **[Amazon CodeCatalyst 開発環境]** ノードを展開し、**[開発環境の設定]** タブから **[開発環境の再構築]** ノードを選択します。