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

# チュートリアル: SSH を使用してサンドボックスに接続する
<a name="sandbox-ssh-tutorial"></a>

このチュートリアルでは、SSH クライアントを使用して CodeBuild サンドボックスに接続する方法を示します。

このチュートリアルを完了するには、まず以下を行う必要があります。
+ 既存の AWS CodeBuild プロジェクトがあることを確認します。
+ CodeBuild プロジェクトロール用に設定された適切な IAM アクセス許可を設定します。
+ ローカルマシン AWS CLI に をインストールして設定します。

## ステップ 1: サンドボックスを開始する
<a name="sandbox-ssh-tutorial.start-sandbox"></a>

**コンソールで CodeBuild サンドボックスを起動するには**

1. [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) で AWS CodeBuild コンソールを開きます。

1. ナビゲーションペインで、**[ビルドプロジェクト]** を選択します。ビルドプロジェクトを選択した後、[**ビルドの開始**] を選択します。  
![\[コンソールのプロジェクトのビルドの詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/project-debug-build.png)

1. [**SSH クライアント**] タブで、[**サンドボックスを開始する**] を選択します。  
![\[コンソールの [SSH クライアント] タブと [サンドボックスを開始する] ボタン。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/ssh-client-sandbox.png)

1. サンドボックスの初期化プロセスには時間がかかる場合があります。サンドボックスのステータスが `RUN_SANDDBOX` に変わったら、サンドボックスに接続できます。  
![\[ステータスが「RUN_SANDDBOX」に変わった後の SSH サンドボックス接続。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/run-sandbox.png)

## ステップ 2: ローカル SSH 設定を変更する
<a name="sandbox-ssh-tutorial.modify-ssh"></a>

サンドボックスに初めて接続する場合は、次の手順を使用して 1 回限りのセットアッププロセスを実行する必要があります。

**コンソールでローカル SSH 設定を変更するには**

1. オペレーティングシステムのセットアップコマンドを見つけます。

1. ローカルターミナルを開き、提供されたコマンドをコピーして実行した後、スクリプトをダウンロードして実行し、ローカル SSH 設定をセットアップします。たとえば、オペレーティングシステムが macOS の場合は、次のコマンドを使用します。  
![\[コンソールの CodeBuild サンドボックスへの SSH 接続用の macOS コマンド。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/modify-ssh-macOS.png)

1. 設定スクリプトにより、サンドボックスに接続するために必要な設定が追加されます。これらの変更を受け入れるよう求められます。

1. 設定に成功すると、CodeBuild サンドボックスの新しい SSH 設定エントリが作成されます。  
![\[SSH サンドボックス接続に成功しました。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/ssh-terminal-success.png)

## ステップ 3: サンドボックスに接続する
<a name="sandbox-ssh-tutorial.connect-sandbox"></a>

**コンソールでローカル SSH 設定を変更するには**

1.  AWS CLI 認証を設定し、 AWS CLI ユーザーに アクセス`codebuild:StartSandboxConnection`許可があることを確認します。詳細については、「*バージョン 1 のAWS Command Line Interface ユーザーガイド*」の「[AWS CLIの IAM ユーザー認証情報を使用した認証](https://docs.aws.amazon.com/cli/v1/userguide/cli-authentication-user.html)」を参照してください。

1. 次のコマンドを使用してサンドボックスに接続します。

   ```
   ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>
   ```
**注記**  
接続障害のトラブルシューティングを行うには、`-v` フラグを使用して詳細な出力を有効にします。例えば、`ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>`。  
他のトラブルシューティングガイダンスについては、「[AWS CodeBuild サンドボックス SSH 接続の問題のトラブルシューティング](sandbox-troubleshooting.md)」を参照してください。

## ステップ 4: 結果を確認する
<a name="sandbox-ssh-tutorial.review-results"></a>

接続すると、ビルド障害のデバッグ、ビルドコマンドのテスト、設定変更の実験、サンドボックスでの環境変数と依存関係の検証を行うことができます。