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)。