Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SSH を使用した開発環境への接続
<a name="devenvironment-connect-ssh"></a>

SSH を使用して開発環境に接続し、ポート転送、ファイルのアップロードとダウンロード、その他の IDE の使用など、制限なくアクションを実行できます。

**注記**  
IDE タブまたはウィンドウを閉じた後も SSH を長時間使用し続ける場合は、IDE の非アクティブが原因で停止しないように、開発環境のタイムアウトを高く設定してください。

**前提条件**
+ 次のいずれかの OS が必要です。
  + Windows 10 以降で OpenSSH が有効になっている
  + macOS および Bash バージョン 3 以降
  + `yum`、`dpkg`、または `rpm` パッケージマネージャーと Bash バージョン 3 以降の Linux
+  AWS CLI バージョン 2.9.4 以降も必要です。<a name="devenvironment-connect-ssh-steps"></a>

**SSH を使用して開発環境に接続するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. SSH を使用して開発環境に接続したいプロジェクトに移動します。

1. ナビゲーションペインで、**[コード]** を選択します。

1. **[開発環境]** を選択します。

1. SSH を使用して接続する実行中の開発環境を選択します。

1. **[SSH 経由で接続]** を選択し、目的のオペレーティングシステムを選択し、以下を実行します。
   + まだ実行していない場合は、指定したターミナルで最初のコマンドを貼り付けて実行します。コマンドはスクリプトをダウンロードし、ローカル環境で次の変更を実行して、SSH を使用して開発環境に接続できるようにします。
     + [の Session Manager プラグインをインストールします AWS CLI](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
     + SSO ログインを実行できるように、ローカル を変更 AWS Config し、CodeCatalyst プロファイルを追加します。詳細については、「[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)」を参照してください。
     + ローカル SSH 設定を変更し、SSH を使用して開発環境に接続するために必要な設定を追加します。
     + SSH クライアントが開発環境に接続するために使用するスクリプトを `~/.aws/codecatalyst-dev-env` ディレクトリに追加します。このスクリプトは [CodeCatalyst StartDevEnvironmentSession API](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) を呼び出し、 AWS Systems Manager Session Manager プラグインを使用して開発環境との AWS Systems Manager セッションを確立します。このセッションは、ローカル SSH クライアントがリモート開発環境に安全に接続するために使用されます。
   + 2 番目のコマンドを使用して SSO を使用して Amazon CodeCatalyst AWS にサインインします。このコマンドは、`~/.aws/codecatalyst-dev-env` ディレクトリ内のスクリプトが [[CodeCatalyst StartDevEnvironmentSession API]](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) を呼び出すことができるように、認証情報をリクエストして取得します。このコマンドは、認証情報の有効期限が切れるたびに実行する必要があります。モーダル (ssh <destination>) で最後のコマンドを実行すると、認証情報の有効期限が切れているか、このステップで指示されているように SSO ログインを実行していない場合にエラーが発生します。
   + 3 番目のコマンドを使用して SSH を使用して、指定した開発環境に接続します。このコマンドの構造は次のとおりです。

     ```
     ssh codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
     ```

     このコマンドを使用して、ポート転送やファイルのアップロードやダウンロードなど、SSH クライアントで許可されるその他のアクションを実行することもできます。
     + ポート転送:

       ```
       ssh -L <local-port>:127.0.0.1:<remote-port> codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
       ```
     + 開発環境のホームディレクトリにファイルをアップロードする:

       ```
       scp -O </path-to-local-file> codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>:</path-to-remote-file-or-directory>
       ```