AWS Cloud9 不再提供給新客戶。 AWS Cloud9 的現有客戶可以繼續正常使用該服務。[進一步了解](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用其他 AWS 服務
使用 時 AWS Cloud9，您可以與 Amazon Lightsail AWS CodeStar、 和 緊密合作 AWS CodePipeline。本節的主題說明如何執行上述操作。
**重要**
Toolkit AWS 功能提供便利的視覺化界面 AWS Lambda，可讓您使用 AWS Serverless Application Model和 Amazon S3 等金鑰 AWS 服務。如需詳細資訊，請參閱[使用 AWS Toolkit](toolkit-welcome.md)。
**Topics**
+ [使用Amazon Lightsail執行個體](lightsail-instances.md)
+ [使用 AWS CodePipeline](codepipeline-repos.md)
+ [使用 CodeCatalyst](ide-toolkits-cloud9.md)
+ [使用 AWS CDK](cdk-explorer.md)
# 在 IDE AWS Cloud9 中使用Amazon Lightsail執行個體
您可以使用 AWS Cloud9 IDE 在預先設定熱門應用程式和架構的Amazon Lightsail執行個體上使用程式碼。它們包括 WordPress、LAMP (Linux、Apache、MySQL 和 PHP)、Node.js、NGINX、Drupal 和 Joomla。也包括 Linux 發行版，例如 Amazon Linux、Ubuntu、Debian、FreeBSD 和 openSUSE。
Lightsail 提供方便、快速設定的虛擬私有伺服器解決方案。 Lightsail提供運算、儲存和聯網容量，並能夠在雲端中部署和管理網站和 Web 應用程式。您可以使用 Lightsail 以低廉且可預測的每月價格快速啟動專案。如需詳細資訊，請參閱 [Amazon Lightsail 功能](https://amazonlightsail.com/features/)。
在本主題中，您會建立並設定與 相容且以 Linux 為基礎的Lightsail執行個體 AWS Cloud9。然後，您可以建立 AWS Cloud9 SSH 開發環境並將其連線至Lightsail執行個體。
**注意**
完成這些程序可能會對您的 產生費用 AWS 帳戶。包括 Lightsail 等服務的可能花費。如需詳細資訊，請參閱[Amazon Lightsail定價](https://aws.amazon.com/lightsail/pricing/)。
若要使用 AWS Cloud9 IDE 來處理執行 Amazon Linux 的 Amazon EC2 執行個體或不含範例程式碼的Ubuntu伺服器，請參閱 [入門 : 基本教學課程](tutorials-basic.md)。
+ [步驟 1：建立以 Linux 為基礎的Lightsail執行個體](#lightsail-instances-create)
+ [步驟 2：設定執行個體以搭配 使用 AWS Cloud9](#lightsail-instances-setup)
+ [步驟 3：建立並連接至 AWS Cloud9 SSH 開發環境](#lightsail-instances-environment)
+ [步驟 4：使用 AWS Cloud9 IDE 變更執行個體上的程式碼](#lightsail-instances-change-code)
## 步驟 1：建立 Linux 型Lightsail執行個體
在此步驟中，您可以使用 Lightsail主控台來建立在 Linux 發行版本中執行應用程式的 Amazon EC2 執行個體。此執行個體自動包含下列項目：
+ 公有及私有 IP 地址 (您可於稍後建立靜態公有 IP)。
+ 使用 SSH 透過連接埠 22、HTTP 透過連接埠 80 及 HTTPS 透過連接埠 443 存取執行個體 (您可以變更這些設定。)
+ 區塊儲存磁碟 (您可於稍後連接額外的磁碟)。
+ 內建系統報告。
在 Lightsail主控台上，您可以稍後備份、重新啟動、停止或刪除執行個體。
1. 開啟 ，然後登入 Lightsail主控台，網址為 [https：//.lightsailaws.amazon.com](https://lightsail.aws.amazon.com)。
我們建議您在 AWS 帳戶使用 IAM 管理員使用者的憑證來登入。若您無法以 IAM 管理員使用者身分登入，請洽詢您的 AWS 帳戶 管理員。
1. 出現提示時，選擇要在主控台使用的語言，然後選擇 **Save** (儲存)。
1. 出現提示時，選擇 **Let's get started** (讓我們開始吧)。
1. 在首頁已選取 **Instances** (執行個體) 標籤的情況下，選擇 **Create instance** (建立執行個體)。
![\[在Lightsail主控台中選擇建立執行個體按鈕\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console-lightsail-create-instance.png)
1. 對於**執行個體位置**，請確定該位置是您要在其中建立執行個體的 AWS 區域 AWS Cloud9 可用位置。如需詳細資訊，請參閱 *Amazon Web Services 一般參考* 中的 [AWS Cloud9](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloud9_region)。若要變更 AWS 區域、可用區域或兩者，請選擇**變更 AWS 區域和可用區域**，然後遵循畫面上的指示。
1. 在 **Pick your instance image** (挑選執行個體映像) 中的 **Select a platform** (選取平台) 已選擇 **Linux/Unix** 且 **Select a blueprint** (選取藍圖) 已選擇 **Apps \$1 OS** (應用程式與作業系統) 的情況下，選擇一份藍圖。
![\[在Lightsail主控台中選擇執行個體平台和藍圖\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console-lightsail-pick-instance-image.png)
**注意**
如果想要建立不含應用程式的執行個體，應選擇 **OS Only** (僅作業系統) 而非 **Apps \$1 OS** (應用程式與作業系統)，然後選擇任一發行版本。
若要了解可用的選項，請參閱 Lightsail 網站上的[選擇Amazon Lightsail執行個體映像](https://lightsail.aws.amazon.com/ls/docs/getting-started/article/compare-options-choose-lightsail-instance-image)。
1. 從 **Choose your instance plan** (選擇執行個體方案) 中選擇任一方案，或者保留所選的預設方案。
1. 在 **Name your instance** (為執行個體命名) 中輸入執行個體的名稱，或者保留建議的預設名稱。
1. 針對執行個體數目，輸入您想要建立的執行個體數目，或者保留預設為單一執行個體 (**x 1**)。
1. 選擇**建立**。
## 步驟 2：設定執行個體以搭配 使用 AWS Cloud9
在此步驟中，您會連線至執行中的執行個體，然後設定讓 稍後 AWS Cloud9 可以使用它。
**注意**
以下說明假設您由前一步驟選擇了 **Apps \$1 OS** (應用程式與作業系統)。如果您是選擇 **OS Only** (僅作業系統) 和 **Ubuntu** 以外的發行版本，可能就需要視情況調整以下說明的操作方式。
1. 由前一步驟仍開啟 Lightsail 主控台的情況下，在 **Instances (執行個體)** 標籤上從執行個體的卡片選擇執行個體的名稱。
![\[選擇在Lightsail主控台中顯示執行個體詳細資訊\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console-lightsail-show-instance-details.png)
1. 在 **Connect** (連接) 標籤上，於 **Connect using your own SSH client** (使用您自己的 SSH 用戶端連接) 中，記下 **Public IP** (公有 IP) 和 **User name** (使用者名稱) 的值，因為稍後需要用到。
![\[Lightsail 主控台中顯示的執行個體公有地址和使用者名稱\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console-lightsail-instance-ip-user.png)
1. 選擇 **Connect using SSH (使用 SSH 連接)**。
1. 確認執行個體已有最新的系統更新。為此，請從畫面上顯示的終端機工作階段，執行 **`sudo apt update`** 命令。
1. 檢查是否已安裝 Python，如已安裝，務必確定為 2.7 版。若要檢查版本，請執行 **`python --version`** 命令並記下其顯示的版本編號。如果未出現版本編號或版本不是 2.7，則執行 **`sudo apt install -y python-minimal`** 命令，於執行個體上安裝 Python 2.7。
1. 檢查是否已安裝 Node.js，如已安裝，再確認是否為 0.6.16 或更新版本。若要檢查版本，請執行 **`node --version`** 命令並記下其顯示的版本編號。如果未出現版本編號或版本不是 0.6.16 或更新版本，建議您使用 Node Version Manager (nvm)，在執行個體上安裝 Node.js。
為此，請依序逐一執行以下命令，其用意是更新執行個體、在執行個體上安裝 Node Version Manager (nvm)、由執行個體啟用 nvm，然後於執行個體上安裝最新版 Node.js。
```
sudo apt update
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
. ~/.bashrc
nvm install node
```
1. 執行 **`which node`** 命令並記下其顯示的值。以供稍後使用。
**注意**
如果命令的輸出**`which node`**類似 `/usr/sbin/node`， AWS Cloud9 則在該路徑中找不到 Node.js。請改用 `nvm`，依本程序的前一步驟所述來安裝 Node.js。然後，再次執行 `which node` 命令並記下其出現的新值。
1. 在執行個體上[下載並執行 AWS Cloud9 安裝程式](installer.md#installer-download-run)。
## 步驟 3：建立並連線至 AWS Cloud9 SSH 開發環境
在此步驟中，您會使用 AWS Cloud9 主控台和執行個體的終端機來建立 SSH 環境，然後將環境連線至執行中的執行個體。
1. 在終端機工作階段仍從上一個步驟開啟的情況下，登入 AWS Cloud9 主控台，如下所示：
+ 如果您是使用 的唯一個人， AWS 帳戶 或者您是單一 中的 IAM 使用者 AWS 帳戶，請前往 https：//[https://console.aws.amazon.com/cloud9/](https://console.aws.amazon.com/cloud9/)。
+ 如果您的組織使用 AWS IAM Identity Center，請洽詢您的 AWS 帳戶 管理員以取得登入指示。
**注意**
在此步驟中，您將 AWS 服務 同時使用兩個不同的 。現在，假設您以 IAM 管理員使用者身分登入 Lightsail主控台，但您希望不同的實體擁有新的 SSH 環境。對於這種情況，建議開啟不同的 Web 瀏覽器並以該實體的身分登入 AWS Cloud9 主控台。
1. 在 AWS Cloud9 主控台中，選擇 AWS 區域 符合您在架構中建立執行個體的 。
![\[AWS AWS Cloud9 主控台中的區域選擇器\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/consolas_region_new_UX.png)
1. 如果顯示歡迎頁面，請在**新 AWS Cloud9 環境中**選擇**建立環境**。否則，請選擇 **Create environment** (建立環境)。
![\[顯示歡迎頁面時選擇 Next step (下一個步驟) 按鈕\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/create_welcome_env_new_UX.png)
或者：
![\[如未顯示歡迎頁面，請選擇 Create environment (建立環境) 按鈕\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console_create_env_new_UX.png)
1. 在 **Name environment** (為環境命名) 頁面的 **Name** (名稱) 上，輸入環境的名稱。
1. 在描述欄位中將**描述**新增至您的環境。
1. 針對**環境類型**，選擇**現有運算**。這很重要，因為您需要選取此選項以顯示**使用者**和**主機**選項。
1. 對於 **User** (使用者)，輸入您稍早記下的 **User name** (使用者名稱) 值。
1. 對於 **Host** (主機)，輸入您稍早記下的 **Public IP** (公有 IP) 值。
1. 將 **Port** (連接埠) 保留預設值 **22**。
1. 展開**其他詳細資訊**。
1. 對於**環境路徑**，輸入登入後從 AWS Cloud9 開始的路徑，即 `~/`。這是使用者主目錄的根目錄。
1. 對於 **Node.js binary path** (Node.js 二進位檔路徑)，輸入您稍早記下的 **`which node`** 值。
1. 將 **SSH jump host** (SSH 跳接主機) 保留空白。
1. 將為此環境 AWS Cloud9 建立的公有 SSH 金鑰存放在您的系統剪貼簿中。為此，選擇 **Copy key to clipboard** (複製金鑰至剪貼簿)。
**注意**
若要查看複製的公有 SSH 金鑰值，請展開 **View public SSH key** (檢視公有 SSH 金鑰)。
1. 將您剛才複製的公有 SSH 金鑰值存放於執行個體。若要這樣做，請使用已安裝在執行個體的 vi (熱門文字編輯器)：
1. 從執行個體的終端機工作階段，執行 **`vi ~/.ssh/authorized_keys`** 命令。
1. 在出現的 vi 編輯器中，移至檔案尾端並切換到插入模式。方法如下：先按 `I` 再按 `A`。(**-- INSERT --** 出現在 vi 編輯器底部。)
1. 按兩次 `Enter` 於檔案末尾添加兩個換行符號。
1. 將系統剪貼簿的內容 (當中包含您剛才複製的公有 SSH 金鑰值) 貼入終端機工作階段剪貼簿。方法如下：於終端機工作階段視窗的右下角選擇剪貼簿按鈕，然後將系統剪貼簿的內容貼入方塊中。
![\[開啟Lightsail終端機工作階段剪貼簿\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/images/console-lightsail-terminal-clipboard.png)
1. 將終端機工作階段剪貼簿的內容貼入 vi 編輯器。方法如下：於 vi 編輯器的插入點位置，按 `Ctrl + Shift + V`。
1. 儲存檔案。方法如下：按 `Esc` 進入命令模式。(vi 編輯器底部的 **-- INSERT --** 將消失)。輸入 `:wq` (意思是 `write` 檔案，然後 `quit` vi 編輯器)，然後按 `Enter`。
1. 返回 AWS Cloud9 主控台，選擇**下一步**。
1. 在 **Review choices** (檢閱選擇) 頁面上，選擇 **Create environment** (建立環境)。等待 AWS Cloud9 建立您的環境，然後顯示環境的 AWS Cloud9 IDE。這可能需要幾分鐘的時間。
在 AWS Cloud9 建立您的環境後，它會顯示環境的 AWS Cloud9 IDE。
如果 未在至少五分鐘後 AWS Cloud9 顯示 IDE，表示您的 Web 瀏覽器、 AWS 存取許可、執行個體或相關聯的虛擬私有雲端 (VPC) 可能有問題。如需可行的修正方法，請參閱「[故障診斷](troubleshooting.md#troubleshooting-env-loading)」一文的*無法開啟環境*。
## 步驟 4：使用 AWS Cloud9 IDE 變更執行個體上的程式碼
現在 IDE 出現在新環境中，您可以在 IDE 中使用終端機工作階段，而不是Lightsail終端機工作階段。IDE 提供豐富的程式碼編輯體驗，可支援多種程式設計語言和執行時間除錯器。IDE 還包括彩色佈景主題、快速鍵按鍵繫結關係、程式設計語言特定語法著色和程式碼格式編排。
若要了解如何使用 IDE，請參閱 [IDE AWS Cloud9 導覽](tour-ide.md)。
若要了解如何變更執行個體上的程式碼，建議您參閱以下資源：
+ **All** [在 網站上取得 'powered by Bitnami' Lightsail image 的應用程式密碼](https://lightsail---aws.amazon.com.rproxy.govskope.cals/docs/how-to/article/log-in-to-your-bitnami-application-running-on-amazon-lightsail) Lightsail
+ **Drupal**：Bitnami 網站上的 [BitnamiDrupal For AWS 雲端](https://docs.bitnami.com/aws/apps/drupal/)，以及 Drupal 網站上的[教學課程與網站使用技巧](https://www.drupal.org/node/627198)
+ **GitLab CE**：Bitnami 網站上的 [BitnamiGitLab CE for AWS 雲端](https://docs.bitnami.com/aws/apps/gitlab/)，以及 GitLab 網站上的 [GitLab 文件](https://docs.gitlab.com/ce/)
+ **Joomla**：Bitnami 網站上的 [BitnamiJoomla\$1 For AWS 雲端](https://docs.bitnami.com/aws/apps/joomla/)，以及 Joomla\$1 網站上的[開始使用 Joomla\$1](https://www.joomla.org/about-joomla/getting-started.html)
+ **LAMP 堆疊**：Bitnami 網站上的 [BitnamiLAMP for AWS 雲端](https://docs.bitnami.com/aws/infrastructure/lamp/)
+ **Magento**：Bitnami 網站上的 [BitnamiMagento For AWS 雲端](https://docs.bitnami.com/aws/apps/magento/)，以及 Magento 網站上的 [Magento 使用者手冊](http://docs.magento.com/m1/ce/user_guide/getting-started.html)
+ **MEAN**：Bitnami 網站上的 [BitnamiMEAN For AWS 雲端](https://docs.bitnami.com/aws/infrastructure/mean/)
+ **NGINX**：Bitnami 網站上的 [BitnamiNGINX For AWS 雲端](https://docs.bitnami.com/aws/infrastructure/nginx/)，以及 NGINX 網站上的 [NGINX Wiki](https://www.nginx.com/resources/wiki/)
+ **Node.js**：Bitnami 網站上的 [BitnamiNode.Js For AWS 雲端](https://docs.bitnami.com/aws/infrastructure/nodejs/)，以及 Node.js 網站上的[入門指南](https://nodejs.org/en/docs/guides/getting-started-guide/)
+ **Plesk 在 上託管堆疊Ubuntu**：在 [Plesk上設定 和 Amazon Lightsail](https://aws.amazon.com/getting-started/hands-on/plesk-on-aws/)。
+ **Redmine**：Bitnami 網站上的 [Bitnami Redmine For AWS 雲端](https://docs.bitnami.com/aws/apps/redmine/)，以及 Redmine 網站上的[入門](http://www.redmine.org/projects/redmine/wiki/Getting_Started)
+ **WordPress**：[WordPress從 網站上的Amazon Lightsail執行個體開始使用](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-tutorial-launching-and-configuring-wordpress) ，以及從 Bitnami 網站上的 [Bitnami WordPress For AWS 雲端](https://docs.bitnami.com/aws/apps/wordpress/) Lightsail
# 在 IDE AWS Cloud9 AWS CodePipeline 中使用
您可以使用 AWS Cloud9 整合式開發環境 (IDE) 在相容的儲存庫中使用原始程式碼 AWS CodePipeline。
CodePipeline 是一種持續交付服務，可用來模型化、視覺化和自動化發行軟體所需的步驟，以及您後續所作的持續變更。您可以使用 CodePipeline 快速模型化和設定軟體發行程序的不同階段。如需詳細資訊，請參閱[「AWS CodePipeline 使用者指南」](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)。
**注意**
完成這些程序可能會導致 AWS 您的帳戶產生費用。這包括 Amazon EC2、CodePipeline、Amazon S3 等服務的可能費用，以及 CodePipeline 支援的 AWS 服務。如需詳細資訊，請參閱 [Amazon EC2 定價](https://aws.amazon.com/ec2/pricing/)、[AWS CodePipeline 定價](https://aws.amazon.com/codepipeline/pricing/)、[Amazon S3 定價](https://aws.amazon.com/s3/pricing/)和 [Cloud Services 定價](https://aws.amazon.com/pricing/services/)。
+ [步驟 1：建立或識別來源碼儲存庫](#codepipeline-repos-create-source-code)
+ [步驟 2：建立 AWS Cloud9 開發環境、將其連線至程式碼儲存庫，並上傳程式碼](#codepipeline-repos-connect-to-repo)
+ [步驟 3：準備使用 AWS CodePipeline](#codepipeline-repos-setup)
+ [步驟 4：在 中建立管道 AWS CodePipeline](#codepipeline-repos-create-pipeline)
## 步驟 1：建立或識別來源碼儲存庫
在此步驟中，您將建立或識別與 CodePipeline 相容的來源碼儲存庫。
在本主題稍後，您會將軟體的來源碼上傳至該儲存庫。CodePipeline 將會使用您同時建立的相關管道，在該儲存庫中建置、測試和部署上傳的來源碼。
您的來源碼儲存庫必須是下列其中一種 CodePipeline 所支援的儲存庫類型：
+ **AWS CodeCommit**。如果您在 CodeCommit 中已經有想要使用的儲存庫，請直接跳到[步驟 2：建立 AWS Cloud9 開發環境、將其連線至程式碼儲存庫，並上傳程式碼](#codepipeline-repos-connect-to-repo)。否則，若要使用 CodeCommit，請依此順序遵循 *AWS CodeCommit 範例*中的這些說明，然後返回本主題：
+ [步驟 1：以必要的存取許可設定 IAM 群組](sample-codecommit.md#sample-codecommit-permissions)
+ [步驟 2：在 AWS CodeCommit中建立儲存庫](sample-codecommit.md#sample-codecommit-create-repo)
+ **Amazon S3** 如果您在 Amazon S3 中已有要使用的儲存貯體，請跳到[步驟 2：建立 AWS Cloud9 開發環境、將其連接到程式碼儲存庫，以及上傳您的程式碼](#codepipeline-repos-connect-to-repo)。否則，若要使用 Amazon S3，請依此順序遵循《*Amazon Simple Storage Service 使用者指南*》中的這些說明，然後返回本主題：
+ [註冊 Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/gsg/SigningUpforS3.html)
+ [建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)
+ **GitHub**。如果您在 GitHub 中已經有儲存庫，您可以複製它，並使用 [Git 面板](source-control-gitpanel.md)界面在開發環境中建立本機副本。如果您尚未在 GitHub 上設定帳戶或儲存庫，請參閱[相關文件](https://docs.github.com/en/github)以取得說明。
## 步驟 2：建立 AWS Cloud9 開發環境，將其連接到程式碼儲存庫，然後上傳您的程式碼
在此步驟中，您會在 AWS Cloud9 主控台中建立 AWS Cloud9 開發環境。您接著會將環境連線至 CodePipeline 將使用的儲存庫。最後，您將使用環境的 AWS Cloud9 IDE 將原始碼上傳至儲存庫。
若要建立環境，請遵循[建立環境](create-environment.md)中的說明，然後返回本主題 (如果您已經有環境，則可以直接使用，不需要建立新的環境。)
若要將環境連線至儲存庫，然後將來源碼上傳至儲存庫 (若還沒上傳)，請按照下列其中一組說明操作。您選擇的設定取決於可存放來源碼的儲存庫類型。
****
| **儲存庫類型** | **指示** |
| --- | --- |
| CodeCommit： | 請遵循以下 *AWS CodeCommit 範例*中的說明： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/codepipeline-repos.html) |
| Amazon S3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/cloud9/latest/user-guide/codepipeline-repos.html) |
| GitHub | 您可以複製在 GitHub 中託管的儲存庫，並使用 [Git 面板](source-control-gitpanel.md)界面與之互動。 |
將環境連線至儲存庫後，每當您將原始程式碼變更從 IDE AWS Cloud9 推送至儲存庫時，CodePipeline 會自動透過相關管道傳送這些變更，以進行建置、測試和部署。您會在本主題稍後建立相關管道。
## 步驟 3：準備使用 AWS CodePipeline
在此步驟中，您將特定 AWS 受管政策連接至您在[團隊設定](setup.md)中建立或識別的 IAM 群組。這可讓群組的使用者在 CodePipeline 中建立和使用管道。
如果您先前已經使用 CodePipeline，請直接跳到[步驟 4：在 AWS CodePipeline中建立管道](#codepipeline-repos-create-pipeline)。
對於此步驟，請遵循《 *AWS CodePipeline 使用者指南*》中的[步驟 3：使用 IAM 受管政策來指派 AWS CodePipeline；IAM 使用者許可](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-codepipeline.html#assign-permissions)，然後返回本主題。
## 步驟 4：在 中建立管道 AWS CodePipeline
在此步驟中，您將在 CodePipeline 中建立管道，藉以使用您在本主題稍早建立或識別的儲存庫。
操作此步驟時，請遵循 *AWS CodePipeline 使用者指南*中的[在 AWS CodePipeline中建立管道](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)相關說明。
在您建立管道之後，CodePipeline 會透過管道傳送儲存庫中要建立、測試和部署的來源碼目前版本。然後，每當您將原始碼變更從 AWS Cloud9 IDE 推送到儲存庫時，CodePipeline 會自動透過管道傳送這些變更，以進行建置、測試和部署。
若要檢視管道，請遵循 *AWS CodePipeline 使用者指南*中的[在 AWS CodePipeline中檢視管道詳細資訊和歷史記錄](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view.html)相關說明。
# 使用 Amazon CodeCatalyst
Amazon CodeCatalyst 是提供給軟體開發團隊的雲端協作空間。CodeCatalyst 是使用持續整合/交付 (CI/CD) 工具來建立、測試和部署應用程式的統一工作、協作程式碼。您可以將 連接至 AWS 帳戶 CodeCatalyst 空間，以將 AWS 資源與您的專案連線。您也可以使用 CodeCatalyst 以快速且自信的方式交付軟體。如需 CodeCatalyst 的詳細資訊，請參閱《Amazon CodeCatalyst 指南》**中的[什麼是 Amazon CodeCatalyst？](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)。
開發環境是種雲端開發環境，您可以在 CodeCatalyst 中使用這些環境，處理專案儲存在來源儲存庫的程式碼。您可以在 CodeCatalyst 中建立開發環境。然後，您可以在專案特定的 CodeCatalyst 中使用支援的整合式開發環境 (IDE) 來處理程式碼。或者，建立空的開發環境，從第三方儲存庫複製程式碼，以使用支援的 IDE。
在 CodeCatalyst 主控台中用來存取開發環境的 AWS Cloud9 IDE 與執行 的 AWS Cloud9 IDE 不同 AWS。在 CodeCatalyst AWS Cloud9 IDE 中，您會自動登入 CodeCatalyst，並且可以使用 IDE 中的 **aws-explorer** 選項存取服務。如需 AWS Toolkit 的詳細資訊，請參閱《 *AWS Cloud9 指南*》中的 [AWS Toolkit for AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html)。
**Topics**
+ [
# 中的 Amazon CodeCatalyst 入門 AWS Cloud9
](ide-toolkits-cloud9-getstarted.title.md)
+ [
# 從 遷移 AWS Cloud9 至 Amazon CodeCatalyst
](c9-replication-cc.md)
+ [
# 使用複寫工具
](c9-replication-cc-tool.md)
+ [
# 複寫程序的FAQs
](faqs-replication-tool.md)
+ [
# Amazon CodeCatalyst 中的開發環境
](devenvironment-cloud9.title.md)
# 中的 Amazon CodeCatalyst 入門 AWS Cloud9
本節提供如何開始使用 CodeCatalyst 的概觀。本節中的主題涵蓋如何在 Amazon CodeCatalyst AWS Cloud9 中使用 ，以及如何在 CodeCatalyst 中複寫您的 AWS Cloud9 環境。稍後的主題也會詳細說明如何建立 CodeCatalyst 開發環境，以及如何使用 IDE AWS Cloud9 存取您的開發環境。
AWS 工具組是 IDE 特定的軟體開發套件 (SDKs)，可讓您快速存取 AWS 雲端 帳戶、服務和資源。從 AWS Toolkit 中的 CodeCatalyst 帳戶，您可以在方便的界面中檢視、編輯和管理 CodeCatalyst 開發環境、空間和專案。若要進一步了解 AWS Toolkits 提供的服務 AWS 雲端 和功能，請參閱[什麼是 AWS Toolkit for Visual Studio Code？](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)、 [AWS Toolkit for AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html)和[什麼是 AWS Toolkit for JetBrains？](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)。[什麼是 AWS Toolkit for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) 指南。
若要將 CodeCatalyst 與 AWS Cloud9 IDE 搭配使用，您必須擁有在 CodeCatalyst 主控台中建立的現有空間、專案和開發環境。
**注意**
請勿在 AWS Cloud9 IDE for CodeCatalyst 的檔案系統中相同名稱的資料夾中建立名為 **專案**的子資料夾。如果您這樣做，則無法存取此目錄中的任何檔案。此問題會影響檔案路徑 **/projects/projects**。**/test/projects **和 **/projects/test/projects** 等檔案路徑不受此問題影響。這是已知問題，只會影響 AWS Cloud9 IDE File Explorer。
**注意**
目前無法使用 CodeCatalyst AWS Cloud9 的 IDE 檔案系統，在相同名稱的資料夾中建立名為 **專案**的子資料夾。您將無法從 IDE File Explorer AWS Cloud9 存取此目錄中的任何檔案，但您可以使用命令列存取這些檔案。請使用其他資料夾名稱。此問題只會影響檔案路徑 **/projects/projects**，其他檔案路徑如 **/test/projects **和 **/projects/test/projects **應能正常執行。這是已知問題，只會影響 AWS Cloud9 IDE File Explorer。
# 從 遷移 AWS Cloud9 至 Amazon CodeCatalyst
AWS Cloud9 在 CodeCatalyst 中， 提供完全受管的 互動體驗 AWS Cloud9。您可以在 Amazon CodeCatalyst 中手動複寫目前的 AWS Cloud9 程式碼資源。程序在下列各節中詳細說明。若要移動程式碼資源並進行複寫，請在 CodeCatalyst 中建立空間。空格代表貴公司、部門或群組。您需要建立空間來新增專案、成員和您在 CodeCatalyst 中建立的相關雲端資源。當使用者接受專案的邀請時，CodeCatalyst 會自動將他們新增至空間。具有 **Space 管理員**角色的使用者可以管理空間。
在此空間中，您可以建立專案並新增來源儲存庫。專案是 CodeCatalyst 中的協作空間，可支援開發團隊和任務。建立專案之後，您可以新增、更新或移除資源。您也可以自訂專案儀表板，並監控團隊工作的進度。您可以在空間中擁有多個專案。您新增的來源儲存庫數量取決於您在環境中已使用的 AWS Cloud9 儲存庫數量。在您建立此專案並新增適用的來源儲存庫之後，您可能需要返回您的 AWS Cloud9 環境，並將環境資料複寫至 CodeCatalyst 中的這些新儲存庫。您執行的操作取決於您擁有的來源儲存庫類型 AWS Cloud9。
建立空間、專案和來源儲存庫後，您可以使用 AWS Cloud9 搭配開發環境，在 CodeCatalyst 中啟動您的環境。開發環境是雲端型開發環境。您可以使用 CodeCatalyst 中的開發環境來處理儲存在專案來源儲存庫中的程式碼。您也可以在 CodeCatalyst 中建立開發環境，以使用支援的整合式開發環境 (IDE) 在專案特定的開發環境中處理程式碼。
您也可以使用複寫工具，將目前的 AWS Cloud9 程式碼資源複寫至 CodeCatalyst。這是您在 AWS Cloud9 環境中下載和執行的工具。如果您已註冊 CodeCatalyst 並建立空間，工具會自動在此空間內建立專案，並將您的程式碼資源複寫到 CodeCatalyst 中的新儲存庫。類似於手動複寫程序。這取決於您在其中擁有的來源儲存庫類型 AWS Cloud9。例如，如果您有GitHub儲存庫，您仍然需要使用 CodeCatalyst 主控台中的 **GitHub延伸**模組來複寫這些儲存庫。
+ [步驟 1. 註冊 Amazon CodeCatalyst 並建立空間](#c9-replication-cc-space-creation)
+ [步驟 2. 在空間中建立專案](#c9-replication-cc-project-creation)
+ [步驟 3. 在專案中建立來源儲存庫](#c9-replication-cc-repo-creation)
+ [步驟 4. 在 CodeCatalyst 中將 AWS Cloud9 程式碼資源複寫至來源儲存庫 ](#c9-replication-cc-source-repo-creation)
+ [步驟 5. 使用 在 CodeCatalyst 中建立開發環境 AWS Cloud9](#dev-environment-creation)
## 步驟 1. 註冊 Amazon CodeCatalyst 並建立空間
您可以註冊 Amazon CodeCatalyst，而無需邀請現有的空間或專案。註冊時，您可以建立空間和專案。您可以輸入您用於的現有 AWS 帳戶 ID AWS Cloud9。這同樣 AWS 帳戶 可用於計費目的。如需如何尋找 AWS 帳戶 ID 的資訊，請參閱[您的 AWS 帳戶 ID 及其別名](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html)。請依照此程序註冊您的 Amazon CodeCatalyst 設定檔、建立空間，以及為您的空間新增帳戶。
**註冊為新使用者**
1. 開啟 [CodeCatalyst 主控台](https://codecatalyst.aws/)。
1. 在歡迎頁面上，選擇**註冊**。
隨即顯示**建立您的 AWS 建置器 ID** 頁面。您的 AWS 建置器 ID 是您建立用來登入的身分。此 ID 與 AWS 帳戶 ID 不同。若要進一步了解 AWS 建置器 ID，請參閱 *AWS 登入使用者指南*中的[AWS 建置器 ID 和其他 AWS 登入](https://docs.aws.amazon.com/signin/latest/userguide/differences-aws_builder_id.html)資料。
1. 針對**您的電子郵件地址**，輸入您要與 CodeCatalyst 建立關聯的電子郵件地址。然後選擇**下一步**。
1. 針對**您的名稱**，輸入您要在使用該 AWS 建置器 ID 的應用程式中顯示的名字和姓氏。
此名稱是您的 AWS 建置器 ID 設定檔名稱。如果需要，您可以稍後變更名稱。
選擇**下一步**。**電子郵件驗證**頁面隨即出現。驗證碼會傳送至您指定的電子郵件。
1. 對於**驗證碼**，輸入您收到的代碼，然後選擇**驗證**。
如果您在 5 分鐘後未收到程式碼，且在垃圾郵件或垃圾郵件資料夾中找不到程式碼，請選擇**重新傳送程式碼**。
1. 驗證您的程式碼後，請輸入密碼，然後選擇**確認密碼**。
選取核取方塊，確認您已閱讀並確認 AWS 客戶協議和 AWS 服務條款，然後選擇**建立我的設定檔**。
1. 在**建立別名**頁面上，輸入要用於 CodeCatalyst 的別名。其他 CodeCatalyst 使用者將使用此別名在註解和提取請求中 @mention you。CodeCatalyst 設定檔將同時包含 AWS 建置器 ID 和 CodeCatalyst 別名的全名。您無法變更 CodeCatalyst 別名。
您的全名和別名會顯示在 CodeCatalyst 的不同區域中。例如，您的設定檔名稱會顯示在您的活動摘要中，但專案成員將使用別名來 @mention you。
選擇**建立別名**。頁面會更新以顯示**建立您的空間**區段。
1. 針對**空格名稱**，輸入空格的名稱，然後選擇**下一步**。
您無法變更此名稱。
1. 針對 **AWS 帳戶 ID**，請連結您要連線至空間之帳戶的 12 位數 ID。
在**AWS 帳戶 驗證字符**中，複製產生的字符 ID。系統會自動為您複製字符。但是，您可能想要在核准 AWS 連線請求時存放它。
1. 選擇**驗證。 AWS**
1. **驗證 Amazon CodeCatalyst 空間**頁面會在 中開啟 AWS 管理主控台。
這是 **Amazon CodeCatalyst Spaces** 頁面。您可能需要登入才能存取頁面。
若要存取頁面，請登入 中的 Amazon CodeCatalyst Spaces[AWS 管理主控台](https://console.aws.amazon.com/codecatalyst/home/)。
中的驗證字符欄位 AWS 管理主控台 會自動填入 CodeCatalyst 中產生的字符。
1. 選擇**驗證空間**。
**帳戶驗證**成功訊息隨即顯示，顯示帳戶已新增至空格。
根據預設，您將使用 CodeCatalyst 免費方案。如果您想要變更，請選擇**若要啟用標準層或新增此空間的 IAM 角色，請檢視空間詳細資訊**。
如需 CodeCatalyst 定價方案的詳細資訊，請參閱 [Amazon CodeCatalyst - 定價](https://codecatalyst.aws/explore/pricing)。
**CodeCatalyst 空間詳細資訊**頁面會在 中開啟 AWS 管理主控台。這是 **Amazon CodeCatalyst Spaces** 頁面。您可能需要登入才能存取頁面。
1. 選擇**前往 [Amazon CodeCatalyst](https://codecatalyst.aws/)**。
1. 在 CodeCatalyst 的建立頁面上，選擇**建立空間**。
建立空間時會顯示狀態訊息。建立空間時，CodeCatalyst 會開啟空間的頁面。檢視預設為**專案**索引標籤。
**注意**
如果顯示許可錯誤或橫幅，請重新整理頁面並再次嘗試檢視頁面。
註冊 CodeCatalyst 並建立空間後，複寫程序的下一個步驟是在空間內建立專案。
## 步驟 2. 在空間中建立專案
下列步驟概述如何在您在上一個步驟中建立的空間內建立空專案。透過此專案，您可以稍後手動新增所需的資源。建立專案之前，您必須擁有 *Space 管理員*角色，而且必須加入您要建立專案的空間。當您建立空間時，CodeCatalyst 會自動為您指派*空間管理員*角色。*空間管理員*角色是 CodeCatalyst 中最強大的角色。如需此角色及其許可的詳細資訊，請參閱[空間管理員角色](https://docs.aws.amazon.com/codecatalyst/latest/userguide/welcome.html)。
**建立空專案**
1. 導覽至您要建立專案的空間。
1. 在空間儀表板上，選擇**建立專案**。
1. 選擇**從頭開始**。
1. 在**將名稱提供給專案**下，輸入您要指派給專案的名稱。名稱在您的空間中必須是唯一的。
1. 選擇**建立專案**。
建立專案之後，複寫程序的下一個步驟是建立一或多個來源儲存庫。
## 步驟 3。在專案中建立來源儲存庫
在您剛建立的專案中，您需要建立來源儲存庫。此儲存庫包含單一檔案，即 **README.md** 檔案，您可以隨時編輯或刪除。根據您在建立來源儲存庫時所做的選擇，它也可能包含 `.gitignore` 檔案。
**建立來源儲存庫**
1. 開啟 [CodeCatalyst 主控台](https://codecatalyst.aws/)。
1. 導覽至您的專案。
1. 在導覽窗格中，選擇**程式碼**，然後選擇**來源儲存庫**。
1. 選擇**新增儲存庫**，然後選擇**建立儲存庫**。
1. 在**儲存庫名稱**中，提供儲存庫的名稱。
儲存庫名稱在專案中必須是唯一的。如需儲存庫名稱需求的詳細資訊，請參閱 [ CodeCatalyst 中來源儲存庫的配額](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-quotas.html)。
1. （選用） 在**描述**中，新增儲存庫的描述，以協助專案中的其他使用者了解儲存庫的用途。
1. （選用） 針對您計劃推送的程式碼類型新增`.gitignore`檔案。
1. 選擇**建立**。
**注意**
CodeCatalyst 會在您建立檔案時，將`README.md`檔案新增至您的儲存庫。CodeCatalyst 也會在名為 **main** 的預設分支中為儲存庫建立初始遞交。您可以編輯或刪除 README.md 檔案，但無法變更或刪除預設分支。
1. 若要取得來源儲存庫複製 URL 和 PAT，請選擇**複製儲存庫**。
1. 若要複製每個 HTTPS 複製 URL 和 PAT，請選擇**複製**。然後，將複製 URL 和 PAT 存放在您可以擷取它的位置。
複製 URL 和 PAT 將用於步驟 4，並參考為 `CODECATALYST_SOURCE_REPO_CLONE_URL`和 `CODECATALYST_PAT`。
在專案中建立來源儲存庫之後，請將 AWS Cloud9 您的資料複寫至此來源儲存庫。
## 步驟 4. 在 CodeCatalyst 中將 AWS Cloud9 程式碼資源複寫至來源儲存庫
您在 AWS Cloud9 環境中擁有的來源儲存庫類型會決定您遵循的複寫方法，將程式碼資源取得至您建立的 CodeCatalyst 來源儲存庫。選項如下：
+ [在 中使用GitHub儲存庫 AWS Cloud9](#c9-replication-cc-source-repo-creation-github)
+ [在 中使用非 GitHub儲存庫，例如 GitLab 或 Bitbucket AWS Cloud9](#c9-replication-cc-source-repo-creation-nongithub)
+ [在 中使用空白儲存庫 AWS Cloud9](#c9-replication-cc-source-norepo-creation)。此選項表示您不會在其中使用任何來源儲存庫 AWS Cloud9。
### 在 CodeCatalyst 中使用GitHub儲存庫
透過 **GitHub 儲存庫**延伸，您可以在 Amazon CodeCatalyst 專案 AWS Cloud9 中使用來自 的連結GitHub儲存庫。下列步驟概述如何從 CodeCatalyst 目錄安裝GitHub擴充功能。這些步驟也說明如何將現有GitHub帳戶連線至 CodeCatalyst 空間，並將儲存GitHub庫連結至 CodeCatalyst 專案。
此方法的第一步是從 CodeCatalyst 目錄安裝**GitHub儲存庫**延伸。若要安裝擴充功能，請執行下列步驟。
**重要**
在安裝和設定 **Github 儲存庫**擴充功能的過程中，您必須將 擴充功能安裝到您的 GitHub帳戶中。若要這樣做，您必須是GitHub帳戶管理員和 CodeCatalyst 空間管理員。
**步驟 1. 從 CodeCatalyst 目錄安裝擴充功能**
1. 開啟 [CodeCatalyst 主控台](https://codecatalyst.aws/)。
1. 導覽至您的空間。
**提示**
如果您屬於多個空間，您可以選擇在頂端導覽列中檢視哪個空間。
1. 選擇搜尋列旁邊的頂端選單列中的**目錄**圖示，以導覽至 CodeCatalyst 目錄。您可以根據類別搜尋**GitHub儲存庫**或篩選延伸項目。
1. （選用） 若要查看延伸項目的詳細資訊，例如與其相關聯的許可，請選擇**GitHub儲存庫**延伸項目名稱。
1. 選擇 **Install (安裝)**。檢閱擴充功能所需的許可，如果您想要繼續，請再次選擇**安裝**。
安裝**GitHub儲存庫**延伸模組後，系統會將您導向**GitHub儲存庫**延伸模組詳細資訊頁面，您可以在其中檢視和管理連線GitHub的帳戶和連結GitHub的儲存庫。
安裝**GitHub儲存庫**延伸模組後，請將GitHub您的帳戶連接到 CodeCatalyst 空間。若要連接GitHub您的帳戶，請執行下列步驟。
**步驟 2. 將GitHub您的帳戶連線至 CodeCatalyst**
1. 在**連線Github帳戶**索引標籤中，選擇 **Connect GitHub帳戶**以前往 的外部網站GitHub。
1. 使用您的GitHub登入資料登入GitHub您的帳戶，然後選擇您要安裝 Amazon CodeCatalyst 的帳戶。
1. 選擇是否要允許 CodeCatalyst 存取所有目前和未來的儲存庫。或者，選擇您要在 CodeCatalyst 中使用的特定GitHub儲存庫。預設選項是GitHub空間中的所有GitHub儲存庫。
1. 檢閱提供給 CodeCatalyst 的許可，然後選擇**安裝**。
將GitHub您的帳戶連線至 CodeCatalyst 後，您可以在**GitHub儲存庫**延伸詳細資訊頁面的帳戶索引標籤中檢視已連線**GitHub的帳戶**。
在 CodeCatalyst 中使用GitHub儲存庫的最後一個步驟是將儲存庫連結至您要使用的 CodeCatalyst 專案。若要將GitHub儲存庫連結至 CodeCatalyst 專案，請執行整個程序的步驟 3 中概述的下列步驟：
**步驟 3。從儲存GitHub庫延伸詳細資訊頁面將GitHub儲存庫連結至 CodeCatalyst 專案**
1. 在**連結的GitHub儲存庫**索引標籤中，選擇**連結GitHub儲存庫。**
1. 針對**GitHub帳戶**，選取包含您要連結之儲存庫GitHub的帳戶。
1. 針對**GitHub儲存庫**，選取您要連結至 CodeCatalyst 專案的儲存庫。
1. 針對 **CodeCatalyst 專案**，選取您要連結GitHub儲存庫的 CodeCatalyst 專案。
1. 選擇 **Link (連結)**。
您的 CodeCatalyst 儲存庫現在應該有更新的檔案，並遞交您剛推送的內容。您現在可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。如需開發環境的詳細資訊，請參閱 [ CodeCatalyst 中的開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)。
您現在可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於[步驟 5：在 CodeCatalyst AWS Cloud9 中使用 建立開發環境](#dev-environment-creation)
### 在 CodeCatalyst 中使用非GitHub 儲存庫
您需要在 Amazon CodeCatalyst 中建立個人存取字符 (PAT)，才能使用 AWS Cloud9 非GitHub儲存庫複寫您的環境。下一節概述如何建立此字符。
#### 在 Amazon CodeCatalyst 中建立個人存取字符
您可以使用Git用戶端或整合式開發環境 (IDE)，在本機電腦上存取您在專案中建立的來源儲存庫。若要這樣做，您必須輸入應用程式特定的密碼。您可以建立個人存取字符 (PAT) 以用於此目的。您建立的個人存取字符 (PATs) 與 CodeCatalyst 中所有空間和專案的使用者身分相關聯。您可以檢視您建立的 PATs名稱和過期日期，也可以刪除不再需要PATs。您只能在建立 PAT 秘密時複製秘密。
**建立個人存取字符 (PAT)**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。
**提示**
您也可以找到您的使用者設定檔。若要這樣做，請在專案或空間的成員頁面上，從成員清單中選擇您的名稱。
1. 在**個人存取字符**下，選擇**建立**。
1. 在 **PAT 名稱**中，輸入個人存取字符 (PAT) 的描述性名稱。
1. 在**過期日期**中，保留預設日期或選擇行事曆圖示以選取自訂日期。過期日期預設為自目前日期起算 1 年。
1. 選擇**建立**。
**提示**
您也可以在為來源**儲存庫選擇複製**儲存庫時建立此字符。
1. 若要複製 PAT 秘密，請選擇**複製**。將 PAT 秘密存放在您可以擷取的地方。
**重要**
PAT 秘密只會顯示一次。關閉視窗後就無法擷取它。如果您未將 PAT 秘密儲存在安全的位置，您可以建立另一個秘密。
為您的來源儲存庫建立 PAT 之後，請在 AWS Cloud9 您的環境中新增遠端儲存庫 AWS Cloud9 ，並將您的資料推送至此儲存庫，將您的資料從環境複寫至 CodeCatalyst，如以下章節所述。
#### 在 AWS Cloud9 環境中新增遠端儲存庫
假設您正在執行的儲存庫不是GitHub儲存庫。您可以在 AWS Cloud9 環境中新增遠端儲存庫，並將資料推送至 CodeCatalyst 中的來源儲存庫。若要完成此程序，請執行下列命令。
從 IDE AWS Cloud9 內新增遠端儲存庫，指向您在 CodeCatalyst 中複寫程序的步驟 3 中建立的來源儲存庫。將 命令`CODECATALYST_SOURCE_REPO_CLONE_URL`中的 取代為您在步驟 [3 步驟 10 中儲存的複製 URL。在專案中建立來源儲存庫](#c9-replication-cc-repo-creation)。
```
git remote add codecatalyst CODECATALYST_SOURCE_REPO_CLONE_URL
```
使用下列命令，將新的分支推送至來源儲存庫。當系統提示您輸入密碼`CODECATALYST_PAT`時，請使用您在步驟 [3 的步驟 10 中存放的 。在專案中建立來源儲存庫](#c9-replication-cc-repo-creation)：
```
git checkout -b replication && git push codecatalyst replication
```
以下是預期的命令執行輸出範例：
```
Switched to a new branch 'replication'
Password for 'https://[aws-account-id]@[aws-region].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository':
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (4/4), 982 bytes | 122.00 KiB/s, done.
Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Validating objects: 100%
To https://[aws-account-id].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository
* [new branch] replication → replication
```
```
```
此分支可在您在 CodeCatalyst 中建立的來源儲存庫中使用。您可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。如需開發環境的詳細資訊，請參閱 [ CodeCatalyst 中的開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)。
您現在可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於[步驟 5：在 CodeCatalyst AWS Cloud9 中使用 建立開發環境](#dev-environment-creation)
#### 在 中使用空儲存庫 AWS Cloud9
首先在 Amazon CodeCatalyst 中建立個人存取字符 (PAT)，然後您才能使用空 AWS Cloud9 的儲存庫複寫您的環境。下一節概述如何建立此字符。
##### 在 Amazon CodeCatalyst 中建立個人存取字符
您可以使用Git用戶端或整合式開發環境 (IDE)，在本機電腦上存取您在專案中建立的來源儲存庫。若要這樣做，您必須輸入應用程式特定的密碼。您可以建立個人存取字符 (PAT) 以用於此目的。您建立的個人存取字符 (PATs) 與 CodeCatalyst 中所有空間和專案的使用者身分相關聯。您可以檢視您建立的 PATs名稱和過期日期，也可以刪除不再需要PATs。您只能在建立 PAT 秘密時複製秘密。
**建立個人存取字符 (PAT)**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。
**提示**
您也可以找到您的使用者設定檔。若要這樣做，請在專案或空間的成員頁面上，從成員清單中選擇您的名稱。
1. 在**個人存取字符**下，選擇**建立**。
1. 在 **PAT 名稱**中，輸入個人存取字符 (PAT) 的描述性名稱。
1. 在**過期日期**中，保留預設日期或選擇行事曆圖示以選取自訂日期。過期日期預設為自目前日期起算 1 年。
1. 選擇**建立**。
**提示**
您也可以在為來源**儲存庫選擇複製**儲存庫時建立此字符。
1. 若要複製 PAT 秘密，請選擇**複製**。將 PAT 秘密存放在您可以擷取的地方。
**重要**
PAT 秘密只會顯示一次。關閉視窗後就無法擷取它。如果您未將 PAT 秘密儲存在安全的位置，您可以建立另一個秘密。
為您的來源儲存庫建立 PAT 之後，請在 AWS Cloud9 您的環境中啟動空儲存庫， AWS Cloud9 並指向您在 CodeCatalyst 中建立的來源儲存庫，以將資料從環境複寫至 CodeCatalyst，如下節所述。
##### 在 中啟動空儲存庫 AWS Cloud9
如果您沒有在 中設定的任何來源儲存庫 AWS Cloud9，請在 中啟動空的儲存庫 AWS Cloud9。此外，指向您在 CodeCatalyst 中建立的來源儲存庫，然後新增並推送您要透過 複寫的檔案Git。執行下列步驟並執行下列命令，將 AWS Cloud9 檔案複寫至 CodeCatalyst。
1. 從您的 AWS Cloud9 環境中，執行下列命令來啟動空儲存庫：
```
git init -b main
```
然後，您會看到類似輸出，如下所示：
```
Initialized empty Git repository in /home/ec2-user/environment/.git/
```
1. 從 CodeCatalyst 複製來源儲存庫 URL。導覽至您在 CodeCatalyst 主控台中建立的 CodeCatalyst 專案，然後在導覽窗格中選擇**程式碼**，然後選擇**來源儲存庫**。
1. 從您想要的來源儲存庫清單中選擇儲存庫，然後選擇**複製儲存庫**以複製複製 URL。
1. 使用您複製的 URL 新增 CodeCatalyst 儲存庫，並在 CodeCatalyst 中推送已存在於空白儲存庫的內容：
```
git remote add origin [...]
git push origin --force
```
1. 新增您要複寫的檔案。如果您想要複寫環境目錄中的所有檔案，請執行 `git add -A`：
```
git add -A .
git commit -m "replicate"
```
1. 合併兩個不相關的歷史記錄。如果發生地址合併衝突：
```
git merge origin/main --allow-unrelated-histories
```
1. 執行下列命令，將變更推回 CodeCatalyst 中的來源儲存庫。當系統提示您輸入密碼時，請輸入您產生步驟 3 步驟 10 的個人存取字符 (`CODECATALYST_PAT`)。 [在專案中建立來源儲存庫](#c9-replication-cc-repo-creation)：
```
Admin:~/environment (main) $ git push origin main
Password for 'https://222581768915@git.us-west-2.codecatalyst.aws/v1/MySpace222581768915/Replication/Replication':
```
完成此程序後，您的 CodeCatalyst 儲存庫會擁有您剛推送的更新檔案和遞交。您現在可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。執行此操作的步驟概述於下節。
## 步驟 5：在 CodeCatalyst AWS Cloud9 中使用 建立開發環境
下列程序概述如何使用 AWS Cloud9 和您剛複寫的資料，在 CodeCatalyst 中建立開發環境。
**使用 建立開發環境 AWS Cloud9**
1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。
1. 導覽至您要建立開發環境的專案。
1. 在導覽窗格中，選擇**概觀**，然後導覽至**我的開發環境**區段。
1. 選擇**建立開發環境**。
1. AWS Cloud9 從下拉式選單中選擇。
1. 選擇**複製儲存庫**。
**注意**
目前，CodeCatalyst 不支援複製第三方儲存庫，但您可以建立開發環境，並從您選擇的 IDE 將第三方儲存庫複製到其中。
1. 執行以下任意一項：
1. 選擇要複製的儲存庫，選擇在**現有分支中工作**，然後從**現有分支下拉式功能表中選擇分支**。
1. 選擇要複製的儲存庫，選擇在**新分支中工作**，在**分支名稱**欄位中輸入分支名稱，然後從從建立分支下拉式功能表中選擇要建立新**分支**的分支。
1. 或者，為開發環境新增別名。
1. 或者，選擇**開發環境組態**編輯按鈕，以編輯開發環境的運算、儲存或逾時組態。
1. 選擇**建立**。建立開發環境時，開發環境狀態欄會顯示**開始**，而狀態欄會在建立開發環境後顯示**執行**中。
# 使用複寫工具
AWS Cloud9 在 CodeCatalyst 中， 提供與 互動的全受管體驗 AWS Cloud9。為了讓客戶能夠在 CodeCatalyst AWS Cloud9 中嘗試使用 ，我們建立了複寫工具。在 AWS Cloud9 環境中複製並執行指令碼後，請依照提示執行指令碼，並將程式碼資源從 複寫 AWS Cloud9 至 CodeCatalyst。如需複寫工具和程序的詳細資訊，請參閱下列複[寫程序的常見問答集](https://docs.aws.amazon.com/cloud9/latest/user-guide/faqs-replication-tool)。
**注意**
此複寫程序不會影響您現有的 AWS Cloud9 環境。複寫程序完成後，您可以刪除開發環境、來源儲存庫、專案和空間，而且不會影響您 AWS Cloud9 的環境。此工具只會將您的程式碼資源複製到 CodeCatalyst AWS Cloud9 中的 ，不會刪除或設定現有的 AWS Cloud9 環境。此複寫工具已發佈至初始選取的 AWS 帳戶群組。因此，它可能不會出現在某些 AWS 帳戶中。
**注意**
建議您先註冊 Amazon CodeCatalyst 並建立空間，再下載工具。如需註冊 CodeCatalyst 的資訊，請參閱[註冊 Amazon CodeCatalyst 和建立空間](c9-replication-cc.md#c9-replication-cc-space-creation)。
## AWS Cloud9 在 Amazon CodeCatalyst 上使用 的優點
下一節概述在 CodeCatalyst AWS Cloud9 上使用 時將體驗到的一些效能優勢和增強功能：
+ CodeCatalyst 提供整合式體驗，可讓您使用全受管開發環境，從單一位置管理整個軟體開發生命週期。
+ 啟動時增強的 Amazon EBS 磁碟區大小選項。
+ 支援暫時性環境，並能夠隨需擴展開發環境的運算能力。
+ 透過自訂映像規格提供的自訂 AMI 支援。
+ Devfile 支援可讓您將組態描述為程式碼。
## 使用複寫工具在 CodeCatalyst 中複寫 AWS Cloud9 程式碼資源
下列程序詳細說明如何複製和執行複寫工具以完成複寫程序。
1. 複製以下指令碼，並確保在 AWS Cloud9 環境中執行：
```
curl https://dx5z5embsyrja.cloudfront.net -o /tmp/replicate-tool.tar.gz && tar --no-same-owner --no-same-permissions -xvf /tmp/replicate-tool.tar.gz -C /tmp && node /tmp/cloud9-replication-tools
```
1. *【選用】* 複寫工具會將您的 AWS 帳戶 ID 用於遙測。這樣做的目的是幫助我們更好地識別您在使用該工具時可能遇到的任何問題。我們會發出 `tool starts`、`tool is cancelled by user`、 `tool fails``tool completes successfully`和 的遙測事件`tool creates a Dev Environment for the user`。如果您想要使用複寫工具停用遙測，請參閱下方的[停用複寫工具的遙測](#disable-telemetry)。
1. 在 AWS Cloud9 環境中複製並執行複寫工具後，您需要導覽至瀏覽器中的存取 URL，並在 10 分鐘內按一下*允許*，將 AWS 帳戶 連結至 AWS 建置器 ID。請確認您只開啟連結一次，如果您多次開啟連結會導致錯誤，而且需要再次開始。如需 AWS 建置器 ID 的詳細資訊，請參閱 [ 登入使用者指南中的使用 AWS 建置器 ID](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html) 登入。 *AWS *這將授予複寫工具存取您的程式碼資源，以便在 CodeCatalyst 中複寫這些資源。
1. 選擇您要使用的 Space。如果您只有一個空間，則會選取該空間。如需空間的詳細資訊，請參閱《Amazon [ CodeCatalyst 使用者指南》中的 CodeCatalyst ](https://docs.aws.amazon.com/codecatalyst/latest/userguide/spaces.html)中的空間。 * CodeCatalyst *
1. 選擇是否要在 CodeCatalyst 中複寫程式碼，或使用新的開發環境來嘗試程式碼。我們建議您直接在 CodeCatalyst 中複寫程式碼。如需開發環境的詳細資訊，請參閱《Amazon [ CodeCatalyst 使用者指南》中的 CodeCatalyst 中的開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)。 * CodeCatalyst *
1. 輸入專案的名稱，或按 Enter 鍵使用提供的預設名稱。
1. 出現提示時，選取您想要將檔案複製到 CodeCatalyst 中新來源儲存庫的方式。您可以選擇將根資料夾推送至單一 CodeCatalyst 儲存庫，或將您的子資料夾推送至不同的 CodeCatalyst 儲存庫。
1. 工具完成後，請透過終端機訊息中提供的 URL 導覽至 CodeCatalyst 主控台中的專案，以存取 CodeCatalyst 中的程式碼資源。
完成此程序後，您的 CodeCatalyst 儲存庫會擁有您剛推送的更新檔案和遞交。您現在可以從此分支建立開發環境，並使用 開啟它們 AWS Cloud9。
## 停用複寫工具的遙測
下列步驟概述如何設定環境變數來停用複寫工具的遙測。
1. 在您的 AWS Cloud9 環境中開啟終端機
1. 執行下列其中一個命令：
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=off
```
或
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=0
```
1. 執行上述其中一個命令後，將會設定環境變數，並停用複寫工具的遙測。停用遙測之後，您必須再次複製並重新執行複寫工具指令碼，才能開始程序。
## 複寫工具意見回饋
如果您遇到任何問題，或想要提供有關使用複寫工具體驗的意見回饋，請建立並提交支援案例。如需建立支援案例的相關資訊，請參閱[建立支援案例和案例管理](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)。
## AWS Cloud9 與 Amazon CodeCatalyst 之間的差異
下表概述 CodeCatalyst AWS Cloud9 上 AWS Cloud9 和 之間的一些差異。
| AWS Cloud9 | AWS Cloud9 Amazon CodeCatalyst 上的 |
| --- | --- |
| 私有 VPC 非常適用於 AWS Cloud9。 | AWS Cloud9 CodeCatalyst 上目前不支援使用私有 VPC。 |
| AWS Cloud9 支援預先設定的 AWS 受管登入資料。 | 登入資料需要在 CodeCatalyst AWS Cloud9 上手動設定 。 |
| 您可以間隔 30 分鐘到 7 天，並使用 停用關機 AWS Cloud9。 | CodeCatalyst AWS Cloud9 上的 的間隔為 15 分鐘至 20 小時，而且您無法停用關機。 |
| AWS Cloud9 支援 Ubuntu 和 AL2 作業系統平台。 | AWS Cloud9 CodeCatalyst 上的 支援 MDE Universal 映像和自訂映像，可包含 Ubuntu 和 AL2。如需詳細資訊，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[通用開發檔映像](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-universal-image.html)。 |
| 在 中支援上傳和下載 AWS Cloud9 | CodeCatalyst AWS Cloud9 上的 目前不支援上傳和下載。使用者將需要使用 Amazon S3 儲存貯體上傳和下載。 |
| 協同合作可在 中使用 AWS Cloud9 | 協同合作目前不適用於 CodeCatalyst AWS Cloud9 上的 。 |
# 複寫程序的FAQs
下一節旨在回答與複寫工具和複寫程序相關的一些FAQs。
**問題：**如果我在 CodeCatalyst 上複寫我的 AWS Cloud9 環境，我的 AWS Cloud9 環境是否會受到影響？
**答案：**否，您環境的複寫只會透過程式碼資源複製到 CodeCatalyst AWS Cloud9 中的 ，讓您能夠繼續工作。您在 上的程式碼資源和環境 AWS Cloud9 不會受到任何影響。
**問：**如果我想要轉返，我的 AWS Cloud9 環境會受到影響嗎？
**答案：**否，您可以刪除 CodeCatalyst 開發環境、來源儲存庫、專案和空間，而且不會影響您 AWS Cloud9 的環境。
**問題：**新據點是否符合 HIPAA、SOC 等標準？
**答案：**CodeCatalyst 上的開發環境目前不符合這些標準。符合這些標準是藍圖上的。
**問：**我的程式碼資源要去哪裡？
**答案：**您的程式碼資源將複製到 CodeCatalyst 中專案內的來源儲存庫。
**問：**我的用量會受到限制嗎？
**答案：**作為複寫程序的一部分，您將建立在免費方案內具有 16 GB 的開發環境。這表示您最多可以有 4 個開發環境。如需定價、儲存體和不同可用層的詳細資訊，請參閱 [Amazon CodeCatalyst - 定價](https://codecatalyst.aws/explore/pricing)。
**問：**我的運算要去哪裡？
**答案：**您現有的運算不會有任何變更。它將保持不變。
**問題：**我可以在 CodeCatalyst 中使用現有的 AWS 帳戶登入資料嗎？系統會自動轉移這些登入資料嗎？
**答案：**您可以在 CodeCatalyst 中手動設定 AWS 帳戶登入資料。它們不會自動傳輸。
**問：**此費用是多少？
**答案：**您可以免費開始使用 CodeCatalyst。如需定價和不同可用方案的詳細資訊，請參閱 [Amazon CodeCatalyst - 定價](https://codecatalyst.aws/explore/pricing)。
**問題：**CodeCatalyst 中的資料複寫程序和資料儲存是否安全？
**答案：**是，我們將使用 git 推送搭配 https 來複製程式碼資源，而 CodeCatalyst 會將資料安全地存放在服務中。所有資料都會在傳輸中和靜態時加密。如需 CodeCatalyst 中資料保護的詳細資訊，請參閱《[Amazon CodeCatalyst 使用者指南》中的 Amazon CodeCatalyst 中的資料保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。 * CodeCatalyst *
**問：**我應該選擇哪種複寫方法？
**答案：**複寫工具提供兩種方法；您可以將程式碼資源從 複製到 AWS Cloud9 CodeCatalyst，方法是將它們推送至單一 CodeCatalyst 來源儲存庫，或將每個子資料夾轉換為不同的 CodeCatalyst 來源儲存庫。我們建議您使用第一個方法，因為它不需要事先了解 CodeCatalyst 概念，例如來源儲存庫。此方法是探索 CodeCatalyst AWS Cloud9 中體驗的良好起點，同時使用您在 中習慣的類似設定 AWS Cloud9。
當您獨立使用根 AWS Cloud9 環境資料夾下方的子資料夾時，最適合選擇第二個選項。透過此方法，根資料夾下的任何檔案都不會複寫。如需 CodeCatalyst 中來源儲存庫的詳細資訊，請參閱《Amazon [ CodeCatalyst 使用者指南》中的 CodeCatalyst 中的來源儲存庫](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source.html)。 * CodeCatalyst *
**問：**複寫程序中產生的個人存取權杖是什麼，為什麼我需要它？ 如果我遺失它，是否可以再次產生它？
**答案：**個人存取字符與 CodeCatalyst 中的使用者身分相關聯。當您使用 git 將本機變更推送至 CodeCatalyst 來源儲存庫時，此為密碼。如需字符及如何產生字符的詳細資訊，請參閱《[Amazon CodeCatalyst 使用者指南》中的在 Amazon CodeCatalyst 中管理個人存取字符](https://docs.aws.amazon.com/codecatalyst/latest/userguide/ipa-tokens-keys.html)。 * CodeCatalyst *
**問：**如果複寫過程中發生錯誤，會發生什麼情況？
**答案：**如果使用複寫工具時發生錯誤，您應該先重試該工具。如果錯誤與來源儲存庫相關，您可以在複寫程式碼資源之後，手動將程式碼資源推送至 CodeCatalyst 來源儲存庫。這應該會在本機儲存庫已設定為使用 CodeCatalyst 上游時運作。如果問題仍然存在，請建立並提交支援案例。如需建立支援案例的相關資訊，請參閱[建立支援案例和案例管理](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)。
**問題：**為什麼我需要使用 my AWS BuilderID 驗證並授予複寫工具的許可？
**答案：**在複寫過程中，複寫工具需要讀取和寫入 CodeCatalyst 中的多個資源 （專案、開發環境、來源儲存庫），並代表使用者複製本機內容，因此需要您的許可才能執行此操作。
**問題：**如果我移至 CodeCatalyst，延遲是否會改變？
**答案：**根據您執行的動作，您可能會看到延遲降低。這是因為 CodeCatalyst 伺服器託管在 PDX 區域中。
**問題：**我已安裝的所有軟體都會傳輸嗎？
**答案：**否，只會傳輸您的程式碼資源。不會傳輸二進位檔、組態和已安裝的軟體。
# Amazon CodeCatalyst 中的開發環境
下列各節概述如何使用 IDE 使用 CodeCatalyst AWS Cloud9 建立和管理開發環境。
+ [建立開發環境](#ide-toolkits-create-cloud9)
+ [開啟開發環境設定](#ide-toolkits-settings-cloud9)
+ [恢復開發環境](#ide-toolkits-resume-cloud9)
+ [刪除開發環境](#ide-toolkits-delete-cloud9)
+ [編輯開發環境的儲存庫 devfile](#ide-toolkits-edit-devfile-cloud9)
+ [複製儲存庫](#ide-toolkits-clone-cloud9)
+ [疑難排解開發環境](#cloud9-devenvironment-troubleshoot)
## 建立開發環境
您可以透過多種方式建立開發環境：
+ 使用**摘要**、開發環境或**來源**儲存庫頁面中的 CodeCatalyst 來源儲存庫，在 CodeCatalyst 中建立**開發環境**。 CodeCatalyst
+ 從開發環境建立未連線至 CodeCatalyst 中來源儲存庫的空白開發環境。
+ 在您選擇的 IDE 中建立開發環境，並將 CodeCatalyst 來源儲存庫複製到該開發環境中。
您可以為每個分支和儲存庫建立一個開發環境。一個專案可以有多個儲存庫。您的開發環境僅與您的 CodeCatalyst 帳戶相關聯，且只能由該 CodeCatalyst 帳戶管理。您可以開啟開發環境，並與任何支援的 IDE 搭配使用。選擇特定的 IDE 之後，您只能使用所選的 IDE 開啟該開發環境。如果您想要使用不同的 IDE，您可以在導覽列中選取開發環境並選擇**編輯**，或建立新的開發環境，以變更 IDE。根據預設，開發環境會使用 2 核心處理器、4 GB RAM 和 16 GB 的持久性儲存體建立。
如需如何在 CodeCatalyst 中建立開發環境的詳細資訊，請參閱《*Amazon CodeCatalyst 指南*》中的[建立開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)。
如需在 CodeCatalyst 中建立開發環境的資訊和步驟，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[建立開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)。
**注意**
您現在可以使用第三方來源儲存庫建立開發環境。如需有關將第三方來源儲存庫連結至 CodeCatalyst 內專案的資訊，請參閱《*Amazon CodeCatalyst 使用者指南*》中的[連結來源儲存庫](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html)。
**重要**
開發環境可以透過可存取 CodeCatalyst 登入資料的 devfile 執行指令碼。開啟不受信任的資源之前，請先檢查儲存庫。
## 開啟開發環境設定
在 CodeCatalyst 主控台中建立開發環境之後，您可以檢視特定的開發環境設定：
1. 在 CodeCatalyst 主控台中，透過 AWS Cloud9 IDE 導覽至您的開發環境。
1. 從 AWS Cloud9 側邊欄選擇 **aws-explorer**。
1. 在**開發人員工具**導覽窗格中，展開 **CodeCatalyst**，然後選擇**開啟設定**以開啟**開發環境設定**檢視。
1. 從 **Dev Environment Settings** (開發環境設定) 檢視中，下列各章節包含適用於您開發環境的選項：
+ **別名：**檢視和變更指派給開發環境的**別名**。
+ **狀態：**檢視您目前的開發環境狀態、指派給它的專案，並停止您的開發環境。
+ **Devfile：**檢視Devfile開發環境的 名稱和位置。選擇在**編輯器中**開啟Devfile來開啟您的 。
+ **Compute Settings:** (運算設定：) 變更開發環境的 **Timeout Length** (逾時長度) 長短和預設值。
**注意**
您無法在建立開發環境之後變更指派給開發環境的儲存空間量。
**注意**
從終端機使用 Amazon CodeCatalyst AWS CLI 時，您必須確保在執行任何 CodeCatalyst 命令之前設定 *AWS\$1PROFILE=codecatalyst*。 CodeCatalyst
## 恢復開發環境
開發環境 `$HOME` 目錄中的所有內容皆會永久儲存。如有必要，您可以停止在開發環境中工作，並在稍後繼續在開發環境中工作。假設開發環境閒置的時間超過建立開發環境時**逾時**欄位中選取的時間量。在此情況下，工作階段會自動停止。
您只能從 CodeCatalyst 恢復開發環境。如需如何繼續開發環境的詳細資訊，請參閱《*Amazon CodeCatalyst 指南*》中的[繼續開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-resume.html)。
**注意**
繼續開發環境可能需要幾分鐘的時間。
## 刪除開發環境
當您完成處理存放在開發環境中的內容時，您可以刪除該內容。刪除開發環境之前，請務必遞交程式碼變更並將其推送至原始來源儲存庫。刪除開發環境後，開發環境的運算和儲存計費會結束。
您只能從 CodeCatalyst 的 **Dev Environments** (開發環境) 頁面刪除開發環境。如需如何刪除開發環境的詳細資訊，請參閱《*Amazon CodeCatalyst 指南*》中的[刪除開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-delete.html)。
## 編輯開發環境devfile的儲存庫
若要變更開發環境的組態，請編輯 devfile。您可以使用devfiles 將整個團隊的開發開發環境標準化。您可以從 CodeCatalyst 中來源儲存庫的devfile根目錄編輯 。或者，您可以在支援的 IDE devfile中編輯 。如果您在支援的 IDE devfile中編輯 ，請遞交變更並推送至來源儲存庫或建立提取請求。如此一來，團隊成員就可以檢閱和核准devfile編輯。
**注意**
您只能在 中包含公有容器映像devfile。
**注意**
如果缺少相依性，某些 AWS Cloud9 IDE 功能可能無法在自訂 中運作devfile。可能需要額外的努力，才能在 Linux x64 以外的某些平台上運作。
**在 中編輯開發環境devfile的儲存庫 AWS Cloud9**
1. 在 CodeCatalyst 主控台中，透過 AWS Cloud9 IDE 導覽至您的開發環境。
1. 從 AWS Cloud9 邊欄中，選擇 **aws-explorer** 。
1. 在**開發人員工具**導覽窗格中，選擇 **CodeCatalyst 工具組**選單。
1. 選擇 **Open Devfile** (開啟 Devfile)。
1. 編輯 devfile，然後儲存檔案。
1. 選擇**來源控制**，這是選單側邊列的Git延伸。
1. 暫存變更前，在 **Message** (訊息) 文字欄位中輸入訊息。
1. 若要準備提交，請選擇 **Stage All Changes (\$1)** (暫存所有變更 (\$1)) 圖示。
1. 若要檢視Git命令，請選擇儲存庫名稱旁的**功能表**圖示。
1. 選擇 **Commit** (提交) 和 **Push** (推送)。
1. 從 AWS 工具組 功能表中選擇**更新開發環境**。
選擇 **Commit** (提交) 和 **Push** (推送)。已更新 devfile已儲存，變更已遞交並推送。
**注意**
假設您想要使用自訂啟動的開發環境devfile無法運作。這可能是因為 devfile 與 不相容 AWS Cloud9。若要疑難排解，請檢閱 devfile。如果問題仍然存在，請將其刪除並嘗試建立新的問題。
您也可以透過 CodeCatalyst 編輯開發環境的 devfile。如需詳細資訊，請參閱《Amazon CodeCatalyst 指南》**中的[設定您的開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-devfile.html)。
## 複製儲存庫
若要有效地使用來源儲存庫中的多個檔案、分支和遞交，您可以將來源儲存庫複製到本機電腦。然後，使用Git用戶端或 IDE 進行變更。從 CodeCatalyst，您可以使用與任何其他Git主機提供者相同的 IDE AWS Cloud9 Git延伸，也可以使用命令列。若要了解如何複製第三方儲存庫，請參閱[初始化或複製Git儲存庫](https://docs.aws.amazon.com/cloud9/latest/user-guide/using-gitpanel.html)。
如需從來源儲存庫建立開發環境並使用 CodeCatalyst 複製環境的詳細資訊，請參閱《*Amazon CodeCatalyst 指南*》中的[來源儲存庫概念](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-concepts-clone.html)。
## 疑難排解開發環境
如果您在使用開發環境時遇到問題，請參閱《Amazon CodeCatalyst 指南》**中的[開發環境疑難排解](https://docs.aws.amazon.com/codecatalyst/latest/userguide/troubleshooting-devenvironments.html)。
**注意**
從終端機使用 Amazon CodeCatalyst AWS CLI 時，您必須確保在執行任何 CodeCatalyst 命令之前設定 *AWS\$1PROFILE=codecatalyst*。 CodeCatalyst
如果您在使用開發環境時遇到問題，請參閱《Amazon CodeCatalyst 指南》**中的[開發環境疑難排解](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironments-troubleshooting.html)。
# 在 IDE AWS Cloud9 AWS CDK 中使用
**AWS CDK Explorer** 可讓您操作 [AWS Cloud Development Kit (AWS CDK)應用程式](https://aws.amazon.com/cdk/)或*應用程式*。您可以在 [AWS Cloud Development Kit (AWS CDK) 開發人員指南](https://docs.aws.amazon.com/cdk/latest/guide/) AWS CDK 中找到 的詳細資訊。
AWS CDK 應用程式由稱為*[建構的](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html)*建置區塊組成。這些建置區塊包含 CloudFormation 堆疊的定義，以及其中 AWS 的資源。使用 **AWS CDK Explorer**，您可以查看定義 AWS CDK *樹狀檢視*的[堆疊](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)[和資源](https://docs.aws.amazon.com/cdk/latest/guide/resources.html)。您可以在 AWS Cloud9 編輯器內的開發人員工具窗格中存取此檢視。
本節提供如何在 AWS Cloud9 編輯器**AWS CDK **中存取和使用 的相關資訊。
# 使用 AWS CDK 應用程式
在 AWS Cloud9 整合開發環境 (IDE) 中使用 **AWS CDK Explorer** 來視覺化和使用 AWS CDK 應用程式。
## 先決條件
安裝 AWS CDK 命令列界面。如需說明，請參閱《 *AWS Cloud Development Kit (AWS CDK) 開發人員指南*》中的 [AWS CDK 入門](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html)。
**重要**
您安裝的 AWS CDK 版本必須是 1.17.0 或更新版本。您可以使用 **`cdk --version`** 命令檢查您正在運行的版本。
## 視覺化 AWS CDK 應用程式
使用 AWS Cloud9 IDE AWS CDK Explorer，您可以管理存放在應用程式 CDK 建構中的[堆疊](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)[和資源](https://docs.aws.amazon.com/cdk/latest/guide/resources.html)。 AWS CDK Explorer 會使用 `tree.json` 檔案中定義的資訊，在樹狀檢視中顯示您的資源。呼叫您執行 **`cdk synth`** 命令時建立的檔案。根據預設，`tree.json` 檔案位於應用程式的 `cdk.out` 目錄。
若要開始使用 Toolkit AWS CDK Explorer，請建立 CDK 應用程式。
1. 完成 [AWS CDK 開發人員指南](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html)的 [Hello World 教學課程](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial)的前幾個步驟。
**重要**
當您到達**部署堆疊**步驟時，請停止並返回本指南。
**注意**
您可以在作業系統命令列界面或 VS Code 編輯器內的 **Terminal** (終端機) 視窗中執行教學課程中提供的命令，例如 **`mkdir`** 和 **`cdk init`**。
1. 完成 CDK 教學課程的必要步驟後，開啟您在 IDE 編輯器中建立的 CDK AWS Cloud9 內容。
1. 在 AWS 導覽窗格中，展開 **CDK ** 標題。您的 CDK 應用程式及其相關資源現在會顯示在 CDK 檔案總管樹狀檢視中。您也可以在終端機中的 AWS Cloud9 內執行下列指令，以確認 CDK 功能是否正常運作：
```
mkdir mycdkapp
cd mycdkapp
cdk init app --language=typescript
cdk synth
cdk bootstrap
```
### 重要說明
+ 當您將 CDK 應用程式載入 AWS Cloud9 編輯器時，您可以一次載入多個資料夾。每個資料夾可以包含多個 CDK 應用程式，如上圖所示。 AWS CDK Explorer 會在專案根目錄及其直接子目錄中尋找應用程式。
+ 當您執行教學課程的開頭幾個步驟時，您可能注意到您執行的最後一個命令是 **`cdk synth`**。此命令會將您的 AWS CDK 應用程式轉譯為 CFN，以合成 CloudFormation 範本。作為副產品，它也會產生 `tree.json` 檔案。如果您對 CDK 應用程式進行變更，請再次執行 **`cdk synth`** 命令以查看樹狀檢視中反映的變更。一個範例變更是將更多資源新增至應用程式。
## 在 AWS CDK 應用程式上執行其他操作
您可以使用 AWS Cloud9 編輯器在 CDK 應用程式上執行其他操作，方式與使用命令列界面相同。例如，您可以在編輯器中更新程式碼檔案，並使用 AWS Cloud9 **終端機**視窗部署應用程式。
若要嘗試這些類型的動作，請使用 AWS Cloud9 編輯器繼續《 *AWS CDK 開發人員指南*》中的 [Hello World 教學課程](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial)。確保執行最後一步，**銷毀應用程式的資源**。否則，您的 AWS 帳戶可能會產生非預期的費用。