本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：使用 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：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1. 在導覽窗格中，選擇 **Build projects (建置專案)**。選擇建置專案，然後選擇**偵錯建置**。  
![\[主控台中的建置專案詳細資訊頁面。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/project-debug-build.png)

1. 在 **SSH 用戶端**索引標籤中，選擇**啟動沙盒**。  
![\[主控台中具有「啟動沙盒」按鈕的「SSH 用戶端」索引標籤。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/ssh-client-sandbox.png)

1. 沙盒初始化程序可能需要一些時間。當沙盒的狀態變更為 時，您可以連線到沙盒`RUN_SANDDBOX`。  
![\[狀態變更為 "RUN_SANDDBOX" 之後的 SSH 沙盒連線。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/run-sandbox.png)

## 步驟 2：修改本機 SSH 組態
<a name="sandbox-ssh-tutorial.modify-ssh"></a>

如果您是第一次連接到沙盒，則需要使用下列步驟執行一次性設定程序：

**在主控台中修改本機 SSH 組態**

1. 尋找您作業系統的設定命令。

1. 開啟您的本機終端機，然後複製並執行提供的命令，以下載並執行指令碼來設定本機 SSH 組態。例如，如果您的作業系統是 macOS，請使用下列命令：  
![\[主控台中 CodeBuild 沙盒的 SSH 連線 macOS 命令。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/modify-ssh-macOS.png)

1. 組態指令碼會新增連接到沙盒所需的組態。系統會提示您接受這些變更。

1. 成功組態後，將建立新的 CodeBuild 沙盒 SSH 組態項目。  
![\[成功的 SSH 沙盒連線。\]](http://docs.aws.amazon.com/zh_tw/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`許可。如需詳細資訊，請參閱《 第 *AWS 1 版命令列界面使用者指南*》中的[使用 的 IAM 使用者憑證進行身分驗證 AWS CLI](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>

連線後，您就可以偵錯建置失敗、測試建置命令、試驗組態變更，以及使用沙盒驗證環境變數和相依性。