ローカルマシンの準備

リモート開発環境でプロジェクトの作業を開始する前に、ローカルマシンを準備する必要があります。Git の認証方法や使用する IDE など、設定によって手順が異なる場合があるため、一部の手順は省略可能です。ご自身に関係のない手順はスキップしてください。

クライアントアプリケーションをインストールする

リモート開発環境に接続するにはクライアントアプリケーションが必要です。JetBrains Gateway または JetBrains、Toolbox のいずれかをご利用いただけます。Toolbox のサポートは現在ベータ版です。

ご使用のオペレーティングシステム用の JetBrains Gateway をダウンロードしてインストールします。
アプリを起動します。

ご使用のオペレーティングシステム用の JetBrains Toolbox をダウンロードしてインストールします。
アプリを起動します。

Git 認証を構成する (SSH)

SSH キーまたは SSH エージェントを使用して Git サーバーに認証できます。

この方法では、Git ホスティングサーバーが公開 SSH キーを保持し、開発環境の IDE は対応する秘密鍵を使用して認証します。

SSH キーペアがない場合は生成します。
ssh-keygen -t ed25519
その結果、my-git-key (秘密鍵) と my-git-key.pub (公開鍵) の 2 つのファイルが生成されます。
公開鍵をクリップボードにコピーし、Git ホスティングサービスに追加します。例:
- GitHub
  プロファイル設定を開き、SSH キーと GPG キーに移動して新しい SSH キーをクリックします。公開鍵をキーフィールドに貼り付けて、SSH キーを追加するをクリックします。
  詳細については、GitHub のドキュメント(英語)を参照してください。
- GitLab
  プロファイル環境設定を開き、SSH キーに移動して新しいキーを追加をクリックします。公開鍵をキーフィールドに貼り付けて、Key の追加をクリックします。
  詳細については、GitLab ドキュメント(英語)を参照してください。
- Bitbucket
  個人用 Bitbucket 設定を開きます。セキュリティにある SSH キーを開き、Key の追加をクリックします。公開鍵をキーの欄に貼り付け、Key の追加をクリックします。
  詳細については、Bitbucket のドキュメント(英語)を参照してください。
秘密鍵はローカルマシン上の安全な場所に保存してください。開発環境から Git リポジトリに初めてアクセスする際には、IDE に秘密鍵ファイルを提供する必要があります。

あるいは、秘密 SSH キーをローカル SSH エージェントに読み込むこともできます。キーはマシンから外部に持ち出されることはありません。CodeCanvas が SSH エージェントを開発環境に転送します。

SSH キーペアがない場合は生成します。
ssh-keygen -t ed25519
その結果、my-git-key (秘密鍵) と my-git-key.pub (公開鍵) の 2 つのファイルが生成されます。
公開鍵をクリップボードにコピーし、Git ホスティングサービスに追加します。例:
- GitHub
  プロファイル設定を開き、SSH キーと GPG キーに移動して新しい SSH キーをクリックします。公開鍵をキーフィールドに貼り付けて、SSH キーを追加するをクリックします。
  詳細については、GitHub のドキュメント(英語)を参照してください。
- GitLab
  プロファイル環境設定を開き、SSH キーに移動して新しいキーを追加をクリックします。公開鍵をキーフィールドに貼り付けて、Key の追加をクリックします。
  詳細については、GitLab ドキュメント(英語)を参照してください。
- Bitbucket
  個人用 Bitbucket 設定を開きます。セキュリティにある SSH キーを開き、Key の追加をクリックします。公開鍵をキーの欄に貼り付け、Key の追加をクリックします。
  詳細については、Bitbucket のドキュメント(英語)を参照してください。
SSH エージェントに秘密鍵を追加します。
ssh-add ~/.ssh/my-git-key
SSH エージェントが実行中で、ターミナルセッションで利用できることを確認してください。macOS および Linux では、通常は事前に設定されています。Windows の場合は、(Windows のみ) SSH エージェントを有効にするを参照してください。
開発環境から Git リポジトリと初めて対話するときは、認証に SSH エージェントを使用するオプションを選択します。

(Windows のみ) SSH エージェントを有効にする

Linux および macOS には SSH エージェントがプリインストールされています。Windows 版 10 および 11 では、プリインストールされた OpenSSH クライアントを使用できますが、SSH エージェントを有効にする必要があります。

(Windows のみ) SSH エージェントを有効にするには

Windows のスタートメニューを開き、Services と入力して、Enter を押します。
サービスウィンドウで、OpenSSH 認証エージェントサービスを見つけます。
サービスを右クリックし、Properties を選択します。
Properties ウィンドウで、スタートアップの種類を自動に設定します。
開始をクリックしてサービスを開始し、次に OK をクリックします。

リモートアクセス用の SSH エージェントを構成する

SSH キーペアがない場合は生成します。
ssh-keygen -t ed25519
その結果、mykey (秘密鍵) と mykey.pub (公開鍵) の 2 つのファイルが生成されます。
公開鍵をクリップボードにコピーし、CodeCanvas に追加します。
1. 右上隅で自分の名前をクリックし、プロファイルを選択します。
2. サイドバーメニューで、SSH キーを選択します。
3. SSH キーを追加をクリックします。
4. 公開鍵をキーフィールドに貼り付け、説明を追加して、追加をクリックします。
ローカルマシンで、SSH エージェントに秘密 SSH キーを追加します。
ssh-add ~/.ssh/mykey
~/.ssh/mykey を秘密鍵への実際のパスに置き換えます。
Identity added: ~/.ssh/mykey のようなメッセージが表示されるはずです。
SSH キーの保存にパスワードマネージャーを使用している場合は、環境変数 SSH_AUTH_SOCK を設定してください。この変数は、パスワードマネージャーが提供する SSH エージェントソケットを指す必要があります。例: 1Password の場合は、SSH クライアント設定ガイド(英語)を参照してください。

2025 年 6 月 24 日

JetBrains CodeCanvas 2025.3 ヘルプ