JetBrains Gateway に接続して操作する

JetBrains Gateway を起動し、リモートサーバーに接続する

1. インストールシナリオの 1 つを使用して、リモート開発ウィザードを開きます。

2. SSH 接続プロバイダーの新規接続をクリックします。

   

3. ウィザードの次のページで、リモートサーバーに接続するための SSH 構成を指定します。

   

   または、 をクリックして SSH 構成ダイアログを開き、SSH 設定を構成します。

   SSH 構成ダイアログで、次の情報を追加します。

   

   • ホスト : リモートサーバーのアドレスを指定します。

   • ポート : SSH ポートを指定します。デフォルトは 22 です。

   • ローカルポート : 発信ポートを指定します。

     例: TCP 10.101.0.1:50705->13.49.137.87:22 (ESTABLISHED)

   • ユーザー名 : リモートサーバーへの接続に使用されるユーザーの名前を指定します。

   • 認証タイプ : 次の認証方法のいずれかを選択します。

     • パスワード : パスワードを使用してホストにアクセスします。IntelliJ IDEA にパスワードを保存するには、「パスワードを保存」チェックボックスを選択します。

     • キーペア (OpenSSH または PuTTY) : キーペアと一緒に SSH 認証(英語)を使用します。この認証方法を適用するには、クライアントマシンに秘密鍵、リモートサーバーに公開鍵が必要です。IntelliJ IDEA は、OpenSSH(英語) ユーティリティで生成された秘密鍵をサポートしています。

       秘密鍵が保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。IntelliJ IDEA にパスフレーズを記憶させるには、「パスフレーズを保存」チェックボックスを選択します。

     • 構成ファイル ~/.ssh/config の構文解析 : JetBrains Gateway で .ssh/config ファイルを使用する場合は、このオプションを選択します。

   • 接続のテスト : このボタンをクリックして、接続が確立されているかどうかを確認します。

   • 接続パラメーター : このセクションを使用して、接続の追加パラメーターを構成します。

   • HTTP/SOCKS プロキシ : このセクションを使用して、プロキシ設定を構成します。詳細については、プロキシ設定を参照してください。

   OK をクリックして変更を保存し、JetBrains Gateway へようこそダイアログに戻ります。

   接続を確認して続行をクリックして、接続が確立されているかどうかを確認します。

4. 次のページで、リモートサーバーにダウンロードする IntelliJ IDEA バージョンを指定します。JetBrains Gateway には、ダウンロード可能な IDE バージョンとすでにインストールされている IDE バージョンのリストが表示されます。

   「その他のオプション」を使用して、IDE インストーラーの代替ソースを設定することもできます。

   ローカルマシンにダウンロードされた JetBrains Client のバージョンは、常にリモート IDE のバージョンと一致します。

デフォルトでは、ダウンロードされた IntelliJ IDEA は、リモートサーバー上の次のフォルダーにあります: ~/.cache/JetBrains/RemoteDev/dist。ただし、次の手順で変更して IntelliJ IDEA をカスタムの場所にインストールできます。

1. その他のオプションをクリックして、インストールパスのカスタマイズオプションを選択します。

2. インストールパスフィールドに、インストールに必要な場所を追加します。

リモートホスト上のプロジェクトへのパスを追加します。

IDE をアップロードして接続をクリックします。

JetBrains Gateway は IDE をダウンロードし、リモートプロジェクトを JetBrains Client で開きます。接続は JetBrains Gateway ウィンドウに表示され、そこから他の IDE に接続したり、接続を無効にしたりできます。このウィンドウは、デフォルトではトレイに対して非表示になっています。

-Xmx VM オプションを上書きする

1. JetBrains Gateway を起動します。

2. ウィザードの手順に従います。接続を確認して続行をクリックします。

3. 開いたページの「IDE バージョン」フィールドで、「インストールオプション」をクリックします。

4. ドロップダウンリストからヒープサイズのカスタマイズを選択します。

   

5. 最大ヒープサイズフィールドで、必要に応じてデフォルトのヒープサイズをオーバーライドします。

   

   このフィールドには数値のみを含めることができ、INT_MAX 値を超えることはできないことに注意してください。

6. 構成が完了したら、「IDE をダウンロードして接続」をクリックしてプロジェクトを開始します。

最近のプロジェクトを開く

1. JetBrains Gateway ウィザードで、左側のオプションから SSH を選択します。

2. 検索フィールドにプロジェクトの名前を入力すると、すぐにそのプロジェクトに移動できます。

   

   ターミナルにすばやくアクセスする必要がある場合は、 をクリックします。

バックエンドのバージョンを変更する

• JetBrains Gateway ウィザードで、最近のプロジェクトの名前の横にある をクリックし、プロジェクトを開くために使用するバックエンドのバージョンを選択します。

  

  必要なバージョンがリストに見つからない場合は、「別の IDE を選択」をクリックし、「IDE バージョン」フィールドで目的の IDE バージョンを選択します。

  

実行中のインスタンスを停止する

1. JetBrains Gateway ウィザードで、左側のオプションから SSH を選択します。

2. リモートセッションがアクティブな場合、プロジェクトの横に実行インジケーターが表示されます。

   

   プロジェクトの横にある をクリックし、IDE バックエンドの停止を選択して、そのプロジェクトのリモートセッションを停止します。

   

   最近のプロジェクトから除去を選択して、ページにリストされているプロジェクトを完全に削除することもできます。

バックエンド IDE バージョンをアンインストールする

1. JetBrains Gateway ウィザードで、リモートサーバーの名前に対して をクリックし、IDE バックエンドの管理を選択して、インストールされている IDE バージョンのリストを開きます。

   

2. 開いたウィンドウで、アンインストールする必要があるバックエンド IDE バージョンの横にある をクリックし、はいをクリックしてアクションを確認します。

1. リモート IDE でバックエンドプロジェクトを開始します。

2. バックエンドによって生成された接続リンクの 1 つを選択します。

3. ローカルマシンでリンクを開きます。

リモート IDE に接続する

1. JetBrains Gateway をダウンロードしてインストールしているか、ローカルマシンに JetBrains Gateway プラグインを備えた IDE があることを確認してください。

2. SSH 経由で IntelliJ IDEA を使用してリモートマシンに接続していることを確認します。

3. リモートサーバーのターミナルで、次のコマンドを実行します。

   remote-dev-server.sh run /path_to_project/ --ssh-link-host host_server_address --ssh-link-user remote_side_user --ssh-link-port ssh_connection_port

   次の例を確認してください。

   ~/ideaIU-213.3469/bin/remote-dev-server.sh run ~/spring-boot-example/ --ssh-link-host ec2-11-50-136-85.eu-north-1.compute.amazonaws.com --ssh-link-user ubuntu

   パラメーターを渡さない場合、スクリプトはデフォルトのパラメーターを使用します。ポート、システムユーザーのユーザー名、hostname コマンドのホストに 22 を使用します。

4. プロジェクトが正常に開始すると、出力としてターミナルに次の 3 つのリンクが表示されます。

   • リンクに参加: tcp://127.0.0.1:5990...[ ] : リモート IDE が現在リッスンしているローカルアドレスとポートが含まれています。

     例:

     tcp://127.0.0.1:5991#jt=71e779a1-070e-4fd3-a4e6-83c1f8cb65a5&p=IU&fp=A42F6041C2878D7A22339ECABF4A9C294F643BG05E91E3DFC06035E03DB71BF8&cb=222.4167.29&jb=17.0.4b469.53

     これを使用するには、リモートマシンがこのローカルアドレスからアクセス可能であることを確認してください。例: 転送 / オープンポートを備えた内部 DockerIDE の場合。

   • Http リンク: https://code-with-me.jetbrains.com/remoteDev...[ ] : host-port-user、IDE、そのバージョンに関する情報が含まれています。

     例:

     https://code-with-me.jetbrains.com/remoteDev#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false

     ローカルブラウザーで開くと、ようこそページが表示され、事前に入力された接続設定値を使用してローカルゲートウェイアプリケーションの呼び出しが試行されます。

     JetBrains Gateway アプリケーションがローカルマシン上に見つからない場合は、ようこそページからダウンロードできます。

   • ゲートウェイリンク: jetbrains-gateway://connect#idePath ... [] : host-port-user、IDE、そのバージョンに関する情報も含まれています。

     例:

     jetbrains-gateway://connect#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false

     ローカルブラウザーで開くと、ようこそページなしでローカル JetBrains Gateway アプリケーションが直接起動します。

5. 生成されたリンクをコピーし、ローカルブラウザーに貼り付けて、JetBrains Gateway を開くを許可します。

6. これらのリンクはすべて、すでに発売されている JetBrains Gateway でも開くことができます。

   このためには、JetBrains Gateway のウェルカム画面で実行中の IDE に接続するフィールドにリンクを貼り付け、接続をクリックします。

   IntelliJ IDEA は、必要なバージョンの JetBrains Client をダウンロードし、その中にあるリモートプロジェクトを開きます。

以前にインストールしたリモート IDE を登録する

バージョン 221.5481 以降では、既存のバックエンド IDE をリモートサーバーに手動で登録し、ゲートウェイに表示できるようになります。

インストールされている IDE を登録し、利用可能なビルドのリストに表示するには、次の手順に従います。

1. SSH 経由でリモートサーバーに接続します。

2. 解凍された IDE が含まれるフォルダーを見つけて、bin ディレクトリを開きます。

3. コマンドラインを使用して次のコマンドを実行します。

   remote-dev-server.sh registerBackendLocationForGateway

   例:

   sh WebStorm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway

Google Cloud のワークステーションに接続する

1. JetBrains Gateway を起動します。

2. 左側のオプションからすべてのプロバイダーを選択します。

3. 他のプロバイダーをインストールセクションで、Google Cloud を見つけて、インストールをクリックします。

   

   プラグインがインストールされたら、IDE をリモートで実行セクションで見つけることができます。

4. 左側のオプションからクラウドワークステーションを見つけて、Google Cloud に接続するをクリックします。

5. 開いたウィンドウで、優先するワークステーションを選択し、「次へ」をクリックします。

   

6. 次のページで、構成ファイルのコードプロバイダーとして選択した IDE バージョンと、作業するプロジェクトを選択します。

   

   接続が確立され、プロジェクトのあるワークステーションが JetBrains Client で開き、IDE 内でさらに作業できるようになります。

Gitpod でワークスペースに接続する

1. JetBrains Gateway を起動します。

2. 左側のオプションからリモート開発を選択します。

3. 他のプロバイダーをインストールセクションで、Gitpod を見つけて、インストールをクリックします。

   

   プラグインがインストールされると、他のプロバイダーをインストールセクションだけでなくリモート開発ノードにもプラグインを見つけることができます。

4. 右側のオプションから Gitpod を見つけて、Gitpod に接続するをクリックします。

   

   .

5. 開いたウィンドウで、使用する IDE を選択します。

   

6. 新しいワークスペースをクリックします。

   JetBrains Gateway は、ブラウザーで Gitpod ワークスペースに接続します。Gitpod はワークスペースを準備し、JetBrains Client 内でワークスペースを開くことに関する通知を表示します。

   

   認証ダイアログで許可、はいの順にクリックします。

   接続が確立され、プロジェクトを含むワークスペースが JetBrains Client で開き、IDE 内でさらに作業できるようになります。

   作成されたワークスペースは、最近使ったワークスペースセクションに追加されます。既存のワークスペースがある場合は、最近のワークスペースのリストに追加され、必要なワークスペースに対して接続をクリックすることでいつでも接続できます。

   

Codespaces 開発者環境に接続する

1. JetBrains Gateway を起動します。

2. 画面下部の をクリックし、プロバイダーの管理を選択します。

3. 開いたページのマーケットプレースタブで GitHub Codespaces を見つけ、プラグインをインストールして有効にします。

   

   プラグインが接続リストに追加されます。

4. 左側のオプションからすべてのプロバイダーを選択します。

5. 右側のオプションから GitHub Codespaces を見つけて、Codespace に接続するをクリックします。

   

6. 次のページで、GitHub Codespaces の手順に従って、GitHub でアカウントを承認します。

7. 認証が完了すると、利用可能な GitHub コードスペースのリストが表示され、目的のプロジェクトを選択できます。

   

8. 実行する IDE バージョンを選択し、接続をクリックします。

   

   接続が確立されます。

   

   選択したプロジェクトを含む GitHub Codespaces 開発環境が JetBrains Client で開かれ、IDE 内でさらに作業を進めることができます。

JetBrains Gateway から開発環境に接続する

1. JetBrains Gateway を起動します。

2. 画面下部の をクリックし、プロバイダーの管理を選択します。

3. 開いたページのマーケットプレースタブで AWS Toolkit を見つけ、プラグインをインストールして有効にします。

   プラグインが接続リストに追加されます。

4. 左側のオプションからすべてのプロバイダーを選択します。

5. 右側のオプションから Amazon CodeCatalyst を見つけて、AWS ビルダー ID にログインをクリックします。

6. ウィザードの次のページで、AWS アカウントにログインします。

   

7. IDE を選択し、必要な情報を追加して開発環境を作成し、開発環境の作成をクリックします。

   

   開発環境が作成され、IDE 内でプロジェクトが開きます。

   

Amazon CodeCatalyst から接続

1. Amazon CodeCatalyst アカウントにログインします。

2. 作成されたスペースで、プロジェクトを見つけて開きます。

3. 開発環境をセットアップしていない場合は、開発環境の作成をクリックします。

4. 利用可能な IDE のリストで必要なものを選択し、必要な情報を追加して作成をクリックします。

   

   開発環境が作成され、アクティビティステータスが表示されます。

5. 再開をクリックして JetBrains Gateway とプロジェクトを JetBrains Client で開きます。

   

   開発環境の準備が整うと、IDE 内でプロジェクトが開き、さらに作業を進めることができます。

Coder ワークスペースに接続する

1. JetBrains Gateway を起動します。

2. 画面下部の をクリックし、プロバイダーの管理を選択します。

3. 開いたページのマーケットプレースタブで Coder を見つけ、プラグインをインストールして有効にします。

   プラグインが接続リストに追加されます。

4. 左側のオプションからすべてのプロバイダーを選択します。

   

5. Coder(英語) でワークスペースが構成されていることを確認し、アクセス URL をコピーします。

   

6. JetBrains Gateway で、「Coder に接続する」をクリックします。

7. ウィザードの次のページの URL フィールドに、コピーした URL を貼り付けて接続をクリックします。

   

8. ブラウザーからセッショントークンをコピーし、セッショントークンフィールドの JetBrains Gateway に貼り付けます。

   

   OK をクリックします。

9. すべてが認証されると、構成されたワークスペースのリストが表示され、必要なワークスペースを選択して、IDE とプロジェクトを選択しますをクリックします。

10. ウィザードの次のページで、必要な IDE を選択し、ワークスペース内のプロジェクトへのパスを指定します。ワークスペースターミナルを使用する必要がある場合は、ターミナルを使用するをクリックします。

    

    すべてを選択したら、「IDE を起動して接続」をクリックします。

    選択したプロジェクトを含む Coder 開発環境が JetBrains Client で開かれ、IDE 内でさらに作業を進めることができます。

コードキャンバス開発環境に接続する

1. JetBrains Gateway を起動します。

   CodeCanvas プラグインはデフォルトで有効になっています。

2. 左側のオプションからすべてのプロバイダーを選択します。

   

3. JetBrains Gateway で、「CodeCanvas に接続する」をクリックします。

4. ウィザードの次のページで、アクセス URL を入力し、ブラウザーで続行をクリックします。

5. 開いたブラウザーウィンドウで、受諾をクリックして必要な権限を付与します。CodeCanvas Web アプリにまだログインしていない場合は、ユーザー名とパスワードの入力も求められます。その後、JetBrains Gateway にリダイレクトされます。

6. 新しい環境をクリックして、新しい開発環境を構成します (プロジェクトに必要な開発環境がすでにある場合は、この手順をスキップします)。

   • 開発環境に使用するテンプレート(英語)を選択します。

   • 環境名が自動的に選択されます。

   • 必要なブランチと、使用可能な場合はウォームアップスナップショットを選択します。

   環境を作成するをクリックします。

   

7. 開発環境が作成されると、プロジェクトが JetBrains Client で開かれ、コーディングを開始できます。

   既存の開発環境のリストを表示するには、Jetbrains Gateway のウェルカム画面の接続ノードにある JetBrains コードキャンバスを選択します。

   

WSL に接続

1. JetBrains Gateway を起動します。

2. すべてのプロバイダーリストで WSL を選択します。

3. 右側のオプションから、新規接続をクリックします。

   

4. 次のページで、WSL インスタンスを選択して次へをクリックします。

   

5. 次のページで、開く IDE バージョンとプロジェクトを選択します。IDE を起動して接続をクリックします。

   

   接続が確立され、バックエンド IDE がダウンロードされ、JetBrains Client でプロジェクトが開きます。