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

# 在開發環境中使用 Toolkit
<a name="codecatalyst-devenvironment"></a>

開發環境是 Amazon CodeCatalyst 的虛擬運算環境。下列各節說明如何使用 從開發環境建立、啟動和運作 AWS Toolkit for Visual Studio Code。

如需開發環境的詳細資訊，請參閱《*Amazon CodeCatalyst* 使用者指南》中的[開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)主題。

## 使用 devfile 設定開發環境
<a name="codecatalyst-devenvironment-devfile"></a>

`devfile` 規格是 YAML 的開放標準格式，可用於定義開發環境的組態。每個開發環境都有一個 devfile。如果您建立的開發環境沒有儲存庫，或從不包含 devfile 的儲存庫建立，則會自動將預設值套用至來源。您可以從 CodeCatalyst 或您的 IDE 更新 Devfile。在 VS Code 的本機或遠端執行個體中更新 devfile 的程序是相同的，但如果您在本機更新 devfile，您必須在更新生效之前將更新推送到您的來源儲存庫。

如需使用 devfile 設定開發環境的詳細資訊，請參閱《*Amazon CodeCatalyst* 使用者指南》中的[設定開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-devfile.html)主題。

下列程序說明如何在開發環境中執行時，從 Toolkit 的遠端執行個體編輯您的 devfile。

**重要**  
如果您`Devfile`從 VS 程式碼編輯 ，請注意下列事項：  
變更 devfile 的名稱或 devfile 元件名稱會取代根目錄的內容。所有先前的內容都會遺失且無法復原。
如果您在根資料夾中建立沒有 devfile 的開發環境，或未與來源儲存庫建立關聯的開發環境，則當您建立開發環境時，會產生具有預設組態設定的 devfile。
如需如何定義和設定 的說明`Devfile`，請參閱 [https：// 網站上的新增命令](https://devfile.io/docs/2.1.0/adding-commands)文件。 [devfile.io](https://devfile.io/) 

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst**，然後在您目前的開發環境中，選擇**開啟開發檔案**以在`devfile.yaml`新的編輯器視窗中開啟。

1. 從 VS 程式碼編輯器中，更新您的 devfile，然後儲存您的變更。

1. 下次啟動開發環境時，系統會更新組態以符合 中定義的規格`Devfile`。

## AWS 從開發環境驗證和連線至
<a name="codecatalyst-devenvironment-credentials"></a>

若要從開發環境存取您的所有 AWS 資源，您必須驗證 Toolkit 的遠端執行個體並將其與 AWS 您的帳戶連線。啟動開發環境時， Toolkit 的遠端執行個體會自動使用從 Toolkit 本機執行個體繼承的登入資料進行身分驗證。

更新 Toolkit 遠端執行個體登入資料的程序與 Toolkit 本機執行個體中的身分驗證體驗相同。如需如何 AWS 從 Toolkit 更新登入資料、驗證和連線至 的詳細指示，請參閱本使用者指南*入門*主題中的[連線至 AWS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html#connect-to-aws) 一節。

如需與 相容之每個 AWS 身分驗證方法的詳細資訊 AWS Toolkit for Visual Studio Code，請參閱本使用者指南中的[身分驗證和存取](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html#connect-to-aws)主題。

## 在開發環境中使用 Toolkit for VS 程式碼
<a name="codecatalyst-devenvironment-toolkit"></a>

在 VS Code 中開啟或建立開發環境後，您可以從 Toolkit for VS Code 工作，類似於從 VS Code 的本機執行個體工作。執行 VS Code 的開發環境已設定為自動安裝 Toolkit， AWS 並與您的 AWS 建置器 ID 連線。

### 停止開發環境
<a name="codecatalyst-devenvironment-stop"></a>

若要停止目前的開發環境：

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst**，然後選擇**停止開發環境**。

1. 當 VS 程式碼提示時，請確認您想要停止開發環境。

1. 當 VS Code 關閉遠端連線並返回本機開發執行個體時，您的開發環境已成功停止。

### 開啟開發環境設定
<a name="codecatalyst-devenvironment-settings"></a>

若要開啟目前開發環境的設定，請完成下列步驟：

**注意**  
一旦建立之後，就無法變更您開發環境的儲存體空間。

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst** 並選擇**開啟設定**，以開啟目前**開發環境的開發環境設定**檢視。

1. 從 **Dev Environment Settings** (開發環境設定) 檢視中，下列各章節包含適用於您開發環境的選項：
   + **Alias:** (別名：) 檢視和變更指派給開發環境的 **Alias** (別名)。
   + **狀態**：檢視您目前的開發環境狀態、指派給它的專案，並停止您的環境。
   + **Devfile**：檢視`Devfile`開發環境的 名稱和位置。選擇在**編輯器中開啟**按鈕`Devfile`來開啟您的 。
   + **Compute Settings:** (運算設定：) 變更開發環境的 **Timeout Length** (逾時長度) 長短和預設值。