Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 針對開發環境的問題進行故障診斷
請參閱下列各節，以疑難排解與開發環境相關的問題。如需開發環境的詳細資訊，請參閱 [在 CodeCatalyst 中使用開發環境撰寫和修改程式碼使用開發環境撰寫和修改程式碼](devenvironment.md)。
**Topics**
+ [由於配額問題，我的開發環境建立失敗](#troubleshooting-devenvironments-create)
+ [我無法將變更從我的開發環境推送到儲存庫中的特定分支](#troubleshooting-devenvironments-branchrules)
+ [我的開發環境未繼續](#troubleshooting-devenvironments-resume)
+ [我的開發環境已中斷連線](#troubleshooting-devenvironments-connection)
+ [我的 VPC 連線開發環境失敗](#troubleshooting-devenvironments-vpc)
+ [我找不到專案所在的目錄](#troubleshooting-devenvironments-projects)
+ [我無法透過 SSH 連線至我的開發環境](#troubleshooting-devenvironments-connect-ssh)
+ [我無法透過 SSH 連線至我的開發環境，因為缺少我的本機 SSH 組態](#troubleshooting-devenvironments-projects-ssh-config)
+ [我無法透過 SSH 連線至我的開發環境，因為設定檔 AWS Config 的 發生問題 `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [當我使用單一登入帳戶登入 CodeCatalyst 時，無法建立開發環境](#troubleshoot-create-dev-env-idprovider)
+ [對 IDEs 的問題進行故障診斷](devenvironments-troubleshooting-ides.md)
+ [對 devfile 的問題進行故障診斷](devenvironments-devenvironments-devfile.md)
## 由於配額問題，我的開發環境建立失敗
**問題：**我想要在 CodeCatalyst 中建立開發環境，但我看到錯誤。在 主控台中，我在開發環境頁面上看到一則訊息，指出我已達到空間的儲存限制。
**可能的修正：**視您在專案或空間中的角色而定，您可以刪除一或多個您自己的開發環境，或者如果您有空間管理員角色，則可以刪除其他使用者建立的未使用開發環境。您也可以決定將帳單方案變更為包含更多儲存空間的方案。
+ 若要檢視儲存限制，請檢視 Amazon CodeCatalyst 空間的**帳單**索引標籤，以查看**用量**配額是否已達到允許的上限。如果配額已達到上限，請聯絡具有 Space 管理員角色的人員，以移除不需要的開發環境，或考慮變更帳單層。
+ 若要移除您不再需要的任何開發環境，請參閱 [刪除開發環境](devenvironment-delete.md)。
如果問題持續發生，而且您在 IDE 中收到錯誤，請檢查您是否具有可讓您建立開發環境的 CodeCatalyst 角色。**空間管理員**角色、**專案管理員**角色和**貢獻者**角色都具有建立開發環境的許可。如需詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。
## 我無法將變更從我的開發環境推送到儲存庫中的特定分支
**問題：**我想要將我的開發環境中的程式碼變更遞交並推送到來源儲存庫中的分支，但我看到錯誤。
**可能的修正：**視您在專案或空間中的角色而定，您可能沒有將程式碼推送至專案中來源儲存庫的許可。**空間管理員**角色、**專案管理員**角色和**貢獻者**角色都具有將程式碼推送至專案中儲存庫的許可。
如果您有 **Contributor **角色，但無法將程式碼推送到特定分支，則可能會為特定分支設定分支規則，以防止具有該角色的使用者將程式碼推送到該特定分支。嘗試將您的變更推送到不同的分支，或建立分支，然後將程式碼推送到該分支。如需詳細資訊，請參閱[使用分支規則管理分支的允許動作](source-branches-branch-rules.md)。
## 我的開發環境未繼續
**問題：**我的開發環境在我停止後沒有繼續。
**可能的修正：**若要修正問題，請檢視 Amazon CodeCatalyst 空間的**帳單**索引標籤，以查看**用量**配額是否已達到上限。如果配額已達到上限，請聯絡您的 Space 管理員來提高帳單層級。
## 我的開發環境已中斷連線
**問題：**我的開發環境在使用時中斷連線。
**可能的修正：**若要修正問題，請檢查您的網際網路連線。如果您未連線到網際網路，請連線並繼續在開發環境中工作。
## 我的 VPC 連線開發環境失敗
**問題：**我已將 VPC 連線與我的開發環境建立關聯，並發生錯誤。
**可能的修正：**Docker 使用稱為橋接網路的連結層裝置，可讓連線到相同橋接網路的容器進行通訊。預設橋接器通常會使用 `172.17.0.0/16` 子網路來進行容器網路連線。如果環境執行個體的 VPC 子網路使用 Docker 已經使用的相同地址範圍，可能會發生 IP 地址衝突。若要解決 Amazon VPC 和Docker使用相同 IPv4 CIDR 地址區塊所造成的 IP 地址衝突，請設定與 不同的 CIDR 區塊`172.17.0.0/16`。
**注意**
您無法變更現有 VPC 或子網路的 IP 地址範圍。
## 我找不到專案所在的目錄
**問題：**我找不到專案所在的目錄。
**可能的修正：**若要尋找您的專案，請將目錄變更為 `/projects`。這是您可以找到專案的目錄。
## 我無法透過 SSH 連線至我的開發環境
若要透過 SSH 疑難排解與開發環境的連線，您可以使用 `-vvv`選項執行 `ssh`命令，以顯示如何解決問題的詳細資訊：
```
ssh -vvv codecatalyst-dev-env===
```
## 我無法透過 SSH 連線至我的開發環境，因為缺少我的本機 SSH 組態
如果本機 SSH 組態 (`~/.ssh/config`) 遺失或`Host codecatalyst-dev-env*`區段的內容過期，您將無法透過 SSH 連線至開發環境。若要疑難排解此問題，請刪除 `Host codecatalyst-dev-env*`區段，然後再次從 **SSH 存取**模式執行第一個命令。如需詳細資訊，請參閱[使用 SSH 連線至開發環境](devenvironment-connect-ssh.md)。
## 我無法透過 SSH 連線至我的開發環境，因為設定檔 AWS Config 的 發生問題 `codecatalyst`
請確定設定檔的 your AWS Config (`~/.aws/config`) 符合 中所述的`codecatalyst`設定檔[設定 以 AWS CLI 搭配 CodeCatalyst 使用](set-up-cli.md)。如果沒有，請刪除 的設定檔，`codecatalyst`並再次從 **SSH 存取**模式執行第一個命令。如需詳細資訊，請參閱[使用 SSH 連線至開發環境](devenvironment-connect-ssh.md)。
## 當我使用單一登入帳戶登入 CodeCatalyst 時，無法建立開發環境
**問題：**當我以 SSO 使用者身分登入 CodeCatalyst 主控台時，當我選擇在空間中建立開發環境時，會收到不明的例外狀況錯誤。當我選擇建立開發環境並選擇 IDE 進行存取時 AWS Cloud9，會遇到類似以下的問題：
+ CodeCatalyst 主控台中的**開發環境**頁面會顯示清單中具有 `FAILED` 狀態的開發環境。
+ 會顯示類似下列的錯誤訊息：
**`An unknown exception happened`**
`We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`
**可能的修正：**
開發環境不適用於使用 Active Directory 做為身分提供者的空間中的使用者。空間的管理員可以使用替代身分提供者來存取開發環境，例如 IAM Identity Center。如需規劃支援聯合身分的空間的詳細資訊，請參閱 *CodeCatalyst 管理員指南*中的[規劃支援聯合身分的空間](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation)。
# 對 IDEs 的問題進行故障診斷
請參閱下列各節，以針對 CodeCatalyst 中 IDEs 相關的問題進行疑難排解。如需 IDEs 的詳細資訊，請參閱 [在 IDE 中建立開發環境](devenvironment-create.md#devenvironment-using-ide)。
**Topics**
+ [我在 中有不相符的執行時間映像版本 AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [我無法存取 `/projects/projects`中的檔案 AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [我無法使用自訂 devfile AWS Cloud9 在 中啟動我的開發環境](#troubleshooting-devenvironments-c9-image)
+ [我在 中遇到問題 AWS Cloud9](#troubleshooting-c9)
+ [在 JetBrains 中，我無法透過 CodeCatalyst 連線到我的開發環境](#troubleshooting-jetbrains-connect)
+ [我無法 AWS 工具組 為 IDE 安裝](#troubleshooting-ide-toolkit)
+ [在我的 IDE 中，我無法啟動我的開發環境](#troubleshooting-ide-launch)
## 我在 中有不相符的執行時間映像版本 AWS Cloud9
AWS Cloud9 使用不同版本的前端資產和後端執行期映像。使用不同的版本可能會導致 Git 延伸模組和 AWS 工具組 無法正常運作。若要修正問題，請導覽至開發環境儀表板，停止開發環境，然後再次啟動。若要使用 APIs修正問題，請使用 `UpdateDevEnvironment` API 更新執行時間。如需詳細資訊，請參閱《*Amazon CodeCatalyst API 參考*》中的 [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)。
## 我無法存取 `/projects/projects`中的檔案 AWS Cloud9
AWS Cloud9 編輯器無法存取 目錄中的檔案`/projects/projects`。若要修正問題，請使用 AWS Cloud9 終端機來存取您的檔案，或將檔案移至不同的目錄。
## 我無法使用自訂 devfile AWS Cloud9 在 中啟動我的開發環境
您的 devfile 映像可能與 不相容 AWS Cloud9。若要修正問題，請從您的儲存庫和對應的開發環境檢閱 devfile，並建立新的 devfile 以繼續。
## 我在 中遇到問題 AWS Cloud9
對於其他問題，請參閱[AWS Cloud9 《 使用者指南](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html)》中的故障診斷一節。
## 在 JetBrains 中，我無法透過 CodeCatalyst 連線到我的開發環境
若要修正此問題，請檢查您是否只安裝最新版本的 JetBrains。如果您有多個版本，請解除安裝舊版，並關閉 IDE 和瀏覽器，再次註冊您的通訊協定處理常式。然後開啟 JetBrains 並再次註冊通訊協定處理常式。
## 我無法 AWS 工具組 為 IDE 安裝
若要修正 VS Code 的此問題， AWS Toolkit for Visual Studio Code 請從 [GitHub](https://github.com/aws/aws-toolkit-vscode/releases) 手動安裝 。
若要修正 JetBrains 的此問題， AWS Toolkit for JetBrains 請從 [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases) 手動安裝 。
## 在我的 IDE 中，我無法啟動我的開發環境
若要修正 VS 程式碼的此問題，請檢查您是否已安裝最新版本的 VS 程式碼。 AWS Toolkit for Visual Studio Code 如果您沒有最新版本，請更新並啟動您的開發環境。如需詳細資訊，請參閱 [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html)。
若要修正 JetBrains 的此問題，請檢查您是否已安裝最新版本的 JetBrains 和 AWS Toolkit for JetBrains 。如果您沒有最新版本，請更新並啟動您的開發環境。如需詳細資訊，請參閱適用於 [JetBrains 的 Amazon CodeCatalyst](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html)。
# 對 devfile 的問題進行故障診斷
請參閱下列各節，以疑難排解 CodeCatalyst 中與 devfile 相關的問題。如需 devfile 的詳細資訊，請參閱 [設定開發環境的 devfile](devenvironment-devfile.md)。
**Topics**
+ [我的開發環境使用預設通用 devfile，即使已在自訂 devfile 中實作自訂映像](#troubleshooting-devenvironments-custom-image)
+ [我的專案並未使用預設通用 devfile 在我的開發環境中建置](#troubleshooting-devenvironments-default-image)
+ [我想要移動開發環境的儲存庫 devfile](#troubleshooting-devenvironments-devfile-moving)
+ [我在啟動我的 devfile 時遇到問題](#troubleshooting-devenvironments-devfile-recovery)
+ [我不確定如何檢查我的 devfile 狀態](#troubleshooting-devenvironments-devfile-status)
+ [我的 devfile 與最新映像中提供的工具不相容](#troubleshooting-devenvironments-devfile-version)
## 我的開發環境使用預設通用 devfile，即使已在自訂 devfile 中實作自訂映像
如果 CodeCatalyst 在啟動使用自訂 devfile 的開發環境時發生錯誤，則開發環境預設為預設的通用 devfile。若要修正問題，您可以在 下的日誌中檢查確切錯誤`/aws/mde/logs/devfile.log`。您也可以檢查日誌中的`postStart`執行是否成功：`/aws/mde/logs/devfileCommand.log`。
## 我的專案並未使用預設通用 devfile 在我的開發環境中建置
修正您未使用自訂 devfile 的問題檢查。如果您不是使用自訂 devfile，請在專案的來源儲存庫中檢視 `devfile.yaml` 檔案，以尋找並修正任何錯誤。
## 我想要移動開發環境的儲存庫 devfile
您可以將預設 devfile `/projects/devfile.yaml` 移入原始程式碼儲存庫。若要更新 devfile 的位置，請使用下列命令：`/aws/mde/mde start --location repository-name/devfile.yaml`。
## 我在啟動我的 devfile 時遇到問題
如果啟動您的 devfile 時發生問題，它會進入復原模式，以便您仍然可以連線到您的環境並修正您的 devfile。在復原模式中，執行 `/aws/mde/mde status`不會包含您 devfile 的位置。
```
{
"status": "STABLE"
}
```
您可以在 下的日誌中檢查錯誤`/aws/mde/logs`、修正 devfile，然後再試一次`/aws/mde/mde start`。
## 我不確定如何檢查我的 devfile 狀態
您可以執行 來檢查您的 devfile 狀態`/aws/mde/mde status`。執行此命令後，您可能會看到下列其中一項：
+ `{"status": "STABLE", "location": "devfile.yaml" }`
這表示您的 devfile 正確。
+ `{"status": "STABLE" }`
這表示您的 devfile 無法啟動，並已進入復原模式。
您可以在 下的日誌中檢查確切錯誤`/aws/mde/logs/devfile.log`。
您也可以檢查日誌中的`postStart`執行是否成功：`/aws/mde/logs/devfileCommand.log`。
如需詳細資訊，請參閱[指定開發環境的通用 devfile 映像](devenvironment-universal-image.md)。
## 我的 devfile 與最新映像中提供的工具不相容
在您的開發環境中，如果`latest`工具沒有特定專案所需的工具，則 `devfile`或 `devfile postStart`可能會失敗。若要修正問題，請執行下列動作：
1. 導覽至您的 devfile。
1. 在您的 devfile 中，更新為精細影像版本，而非 `latest`。它看起來可能會類似以下內容：
```
components:
- container:
image: public.ecr.aws/amazonlinux/universal-image:1.0
```
1. 使用更新的 devfile 建立新的開發環境。