

Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memecahkan masalah dengan Lingkungan Dev
<a name="devenvironments-troubleshooting"></a>

Konsultasikan bagian berikut untuk memecahkan masalah yang terkait dengan Lingkungan Pengembang. Untuk informasi selengkapnya tentang Lingkungan Pengembang, lihat[Menulis dan memodifikasi kode dengan Dev Environments di CodeCatalystMenulis dan memodifikasi kode dengan Dev Environments](devenvironment.md).

**Topics**
+ [Pembuatan Lingkungan Pengembang saya tidak berhasil karena masalah dengan kuota](#troubleshooting-devenvironments-create)
+ [Saya tidak dapat mendorong perubahan dari Lingkungan Pengembang saya ke cabang tertentu di repositori](#troubleshooting-devenvironments-branchrules)
+ [Lingkungan Pengembang saya tidak dilanjutkan](#troubleshooting-devenvironments-resume)
+ [Lingkungan Dev saya terputus](#troubleshooting-devenvironments-connection)
+ [Lingkungan Dev saya yang terhubung dengan VPC gagal](#troubleshooting-devenvironments-vpc)
+ [Saya tidak dapat menemukan direktori mana proyek saya berada](#troubleshooting-devenvironments-projects)
+ [Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH](#troubleshooting-devenvironments-connect-ssh)
+ [Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH karena konfigurasi SSH lokal saya hilang](#troubleshooting-devenvironments-projects-ssh-config)
+ [Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH karena saya mengalami masalah dengan profil saya AWS Config `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [Saya tidak dapat membuat Lingkungan Pengembang saat saya masuk CodeCatalyst menggunakan satu akun masuk](#troubleshoot-create-dev-env-idprovider)
+ [Memecahkan masalah dengan IDEs](devenvironments-troubleshooting-ides.md)
+ [Memecahkan masalah dengan devfiles](devenvironments-devenvironments-devfile.md)

## Pembuatan Lingkungan Pengembang saya tidak berhasil karena masalah dengan kuota
<a name="troubleshooting-devenvironments-create"></a>

**Masalah:** Saya ingin membuat Lingkungan Pengembang di CodeCatalyst, tetapi saya melihat kesalahan. Di konsol, saya melihat pesan di halaman Dev Environments bahwa saya telah mencapai batas penyimpanan untuk ruang tersebut.

**Kemungkinan perbaikan:** Bergantung pada peran Anda dalam proyek atau ruang, Anda dapat menghapus satu atau beberapa Lingkungan Pengembang Anda sendiri, atau jika Anda memiliki peran administrator Space, Anda dapat menghapus Lingkungan Dev yang tidak digunakan yang dibuat oleh pengguna lain. Anda juga dapat memutuskan untuk mengubah tingkat penagihan ke tingkat yang mencakup lebih banyak penyimpanan.
+ Untuk melihat batas penyimpanan, lihat tab **Penagihan** di CodeCatalyst ruang Amazon untuk melihat apakah kuota **Penggunaan** telah mencapai batas maksimum yang diizinkan. Jika kuota telah mencapai maksimum, hubungi seseorang dengan peran administrator Space untuk menghapus Lingkungan Dev yang tidak diperlukan atau pertimbangkan untuk mengubah tingkat penagihan.
+ Untuk menghapus Lingkungan Dev yang Anda buat yang tidak lagi Anda butuhkan, lihat[Menghapus Lingkungan Dev](devenvironment-delete.md).

Jika masalah berlanjut dan Anda mendapatkan kesalahan di IDE Anda, periksa apakah Anda memiliki CodeCatalyst peran yang memungkinkan Anda membuat Lingkungan Pengembang. Peran **administrator Space**, peran **administrator Proyek**, dan peran **Kontributor** semuanya memiliki izin untuk membuat Lingkungan Pengembang. Untuk informasi selengkapnya, lihat [Memberikan akses dengan peran pengguna](ipa-roles.md).

## Saya tidak dapat mendorong perubahan dari Lingkungan Pengembang saya ke cabang tertentu di repositori
<a name="troubleshooting-devenvironments-branchrules"></a>

**Masalah:** Saya ingin melakukan dan mendorong perubahan kode di Lingkungan Dev saya ke cabang di repositori sumber, tetapi saya melihat kesalahan. 

**Kemungkinan perbaikan:** Bergantung pada peran Anda dalam proyek atau ruang, Anda mungkin tidak memiliki izin untuk mendorong kode ke repositori sumber dalam proyek. Peran **administrator Space**, peran **administrator Proyek**, dan peran **Kontributor** semuanya memiliki izin untuk mendorong kode ke repositori dalam proyek.

Jika Anda memiliki peran **Kontributor** tetapi tidak dapat mendorong kode ke cabang tertentu, mungkin ada aturan cabang yang dikonfigurasi untuk cabang tertentu yang mencegah pengguna dengan peran tersebut mendorong kode ke cabang tertentu. Coba dorong perubahan Anda ke cabang yang berbeda, atau buat cabang dan kemudian dorong kode Anda ke cabang itu. Untuk informasi selengkapnya, lihat [Mengelola tindakan yang diizinkan untuk cabang dengan aturan cabang](source-branches-branch-rules.md).

## Lingkungan Pengembang saya tidak dilanjutkan
<a name="troubleshooting-devenvironments-resume"></a>

**Masalah:** Lingkungan Pengembang saya tidak dilanjutkan setelah saya menghentikannya.

**Kemungkinan perbaikan:** Untuk memperbaiki masalah, lihat tab **Penagihan** di CodeCatalyst ruang Amazon untuk melihat apakah kuota **Penggunaan** telah mencapai batas maksimum. Jika kuota telah mencapai batas maksimum, hubungi administrator Space Anda untuk menaikkan tingkat penagihan.

## Lingkungan Dev saya terputus
<a name="troubleshooting-devenvironments-connection"></a>

**Masalah:** Lingkungan Pengembang saya terputus saat saya menggunakannya.

**Kemungkinan perbaikan:** Untuk memperbaiki masalah, periksa koneksi internet Anda. Jika Anda tidak terhubung ke internet, sambungkan dan lanjutkan bekerja di Lingkungan Pengembang Anda.

## Lingkungan Dev saya yang terhubung dengan VPC gagal
<a name="troubleshooting-devenvironments-vpc"></a>

**Masalah:** Saya mengaitkan koneksi VPC ke Lingkungan Pengembang saya dan mengalami kesalahan.

**Kemungkinan perbaikan:** Docker menggunakan perangkat lapisan tautan yang disebut jaringan jembatan yang memungkinkan kontainer yang terhubung ke jaringan jembatan yang sama untuk berkomunikasi. Jembatan default biasanya menggunakan subnet `172.17.0.0/16` untuk jaringan kontainer. Jika subnet VPC untuk instance lingkungan Anda menggunakan rentang alamat yang sama dengan yang sudah digunakanDocker, konflik alamat IP mungkin terjadi. Untuk mengatasi konflik alamat IP yang disebabkan oleh Amazon VPC dan Docker menggunakan blok alamat IPv4 CIDR yang sama, konfigurasikan blok CIDR yang berbeda. `172.17.0.0/16`

**catatan**  
Anda tidak dapat mengubah rentang alamat IP dari VPC atau subnet yang ada.

## Saya tidak dapat menemukan direktori mana proyek saya berada
<a name="troubleshooting-devenvironments-projects"></a>

**Masalah:** Saya tidak dapat menemukan direktori mana proyek saya berada.

**Kemungkinan perbaikan:** Untuk menemukan proyek Anda, ubah direktori ke`/projects`. Ini adalah direktori tempat Anda dapat menemukan proyek Anda.

## Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH
<a name="troubleshooting-devenvironments-connect-ssh"></a>

Untuk memecahkan masalah koneksi Anda ke Lingkungan Dev Anda melalui SSH, Anda dapat menjalankan `ssh` perintah dengan `-vvv` opsi untuk menampilkan informasi lebih lanjut tentang cara mengatasi masalah Anda:

```
ssh -vvv codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
```

## Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH karena konfigurasi SSH lokal saya hilang
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

Jika konfigurasi SSH lokal Anda (`~/.ssh/config`) hilang atau konten `Host codecatalyst-dev-env*` bagian sudah kedaluwarsa, Anda tidak akan dapat terhubung ke Lingkungan Pengembang Anda melalui SSH. Untuk memecahkan masalah ini, hapus `Host codecatalyst-dev-env*` bagian dan jalankan perintah pertama dari modal **Akses SSH lagi**. Untuk informasi selengkapnya, lihat [Menghubungkan ke Lingkungan Dev menggunakan SSH](devenvironment-connect-ssh.md).

## Saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui SSH karena saya mengalami masalah dengan profil saya AWS Config `codecatalyst`
<a name="troubleshooting-devenvironments-config-profile"></a>

Pastikan AWS Config (`~/.aws/config`) untuk `codecatalyst` profil Anda cocok dengan yang dijelaskan di[Menyiapkan untuk menggunakan AWS CLI dengan CodeCatalyst](set-up-cli.md). Jika tidak, hapus profil untuk `codecatalyst` dan jalankan perintah pertama dari modal **Akses SSH** lagi. Untuk informasi selengkapnya, lihat [Menghubungkan ke Lingkungan Dev menggunakan SSH](devenvironment-connect-ssh.md).

## Saya tidak dapat membuat Lingkungan Pengembang saat saya masuk CodeCatalyst menggunakan satu akun masuk
<a name="troubleshoot-create-dev-env-idprovider"></a>

**Masalah:** Ketika saya masuk ke CodeCatalyst konsol sebagai pengguna SSO, saya menerima kesalahan pengecualian yang tidak diketahui ketika saya memilih untuk membuat Lingkungan Pengembang di ruang tersebut. Ketika saya memilih untuk membuat Lingkungan Pengembang dan memilih IDE untuk akses, seperti AWS Cloud9, saya mengalami masalah yang mirip dengan yang berikut ini: 
+ Halaman **Lingkungan Pengembang** di CodeCatalyst konsol menampilkan Lingkungan Pengembang dalam daftar dengan `FAILED` status.
+ Pesan kesalahan yang mirip dengan tampilan berikut:

  **`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.`

**Kemungkinan perbaikan:** 

Lingkungan Dev tidak tersedia untuk pengguna di ruang di mana Active Directory digunakan sebagai penyedia identitas. Administrator untuk ruang dapat menggunakan penyedia identitas alternatif untuk mengakses Lingkungan Pengembang, seperti Pusat Identitas IAM. Untuk informasi selengkapnya tentang perencanaan ruang yang mendukung federasi identitas, lihat [Merencanakan ruang Anda yang mendukung federasi identitas](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) di *Panduan CodeCatalyst Administrator*.

# Memecahkan masalah dengan IDEs
<a name="devenvironments-troubleshooting-ides"></a>

Konsultasikan bagian berikut untuk memecahkan masalah yang terkait IDEs dengan in. CodeCatalyst Untuk informasi lebih lanjut tentang IDEs, lihat[Membuat Lingkungan Dev dalam IDE](devenvironment-create.md#devenvironment-using-ide).

**Topics**
+ [Saya memiliki versi gambar runtime yang tidak cocok di AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Saya tidak dapat mengakses file saya `/projects/projects` di AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Saya tidak dapat meluncurkan Lingkungan Dev saya dalam AWS Cloud9 menggunakan devfile khusus](#troubleshooting-devenvironments-c9-image)
+ [Saya mengalami masalah di AWS Cloud9](#troubleshooting-c9)
+ [Di JetBrains, saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Saya tidak dapat menginstal AWS Toolkit untuk IDE saya](#troubleshooting-ide-toolkit)
+ [Di IDE saya, saya tidak dapat meluncurkan Lingkungan Dev saya](#troubleshooting-ide-launch)

## Saya memiliki versi gambar runtime yang tidak cocok di AWS Cloud9
<a name="troubleshooting-devenvironments-c9-runtime"></a>

AWS Cloud9 menggunakan versi berbeda dari aset frontend dan gambar runtime backend. Menggunakan versi yang berbeda dapat menyebabkan ekstensi Git dan berfungsi AWS Toolkit dengan tidak benar. Untuk memperbaiki masalah, navigasikan ke dasbor Dev Environment, hentikan Lingkungan Dev Anda, lalu mulai lagi. Untuk memperbaiki masalah menggunakan APIs, gunakan `UpdateDevEnvironment` API untuk memperbarui runtime. Untuk informasi selengkapnya, lihat [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)di *referensi Amazon CodeCatalyst API*.

## Saya tidak dapat mengakses file saya `/projects/projects` di AWS Cloud9
<a name="troubleshooting-devenvironments-c9-filesystem"></a>

 AWS Cloud9 Editor tidak dapat mengakses file di direktori`/projects/projects`. Untuk memperbaiki masalah, gunakan AWS Cloud9 terminal untuk mengakses file Anda atau memindahkannya ke direktori lain.

## Saya tidak dapat meluncurkan Lingkungan Dev saya dalam AWS Cloud9 menggunakan devfile khusus
<a name="troubleshooting-devenvironments-c9-image"></a>

Gambar devfile Anda mungkin tidak kompatibel dengan AWS Cloud9. Untuk memperbaiki masalah, tinjau devfile dari repositori Anda dan Lingkungan Dev yang sesuai dan buat yang baru untuk melanjutkan.

## Saya mengalami masalah di AWS Cloud9
<a name="troubleshooting-c9"></a>

Untuk masalah lain, periksa bagian pemecahan masalah di [AWS Cloud9 Panduan Pengguna](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).

## Di JetBrains, saya tidak dapat terhubung ke Lingkungan Pengembang saya melalui CodeCatalyst
<a name="troubleshooting-jetbrains-connect"></a>

Untuk memperbaiki masalah, periksa apakah Anda hanya JetBrains menginstal versi terbaru. Jika Anda memiliki beberapa versi, hapus instalan versi yang lebih lama dan daftarkan penangan protokol Anda lagi dengan menutup IDE dan browser. Kemudian buka JetBrains dan daftarkan pengendali protokol lagi.

## Saya tidak dapat menginstal AWS Toolkit untuk IDE saya
<a name="troubleshooting-ide-toolkit"></a>

Untuk memperbaiki masalah ini untuk VS Code, instal secara manual AWS Toolkit for Visual Studio Code dari [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).

Untuk memperbaiki masalah ini JetBrains, instal secara manual AWS Toolkit for JetBrains dari [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).

## Di IDE saya, saya tidak dapat meluncurkan Lingkungan Dev saya
<a name="troubleshooting-ide-launch"></a>

Untuk memperbaiki masalah ini untuk VS Code, periksa apakah Anda memiliki versi terbaru VS Code dan AWS Toolkit for Visual Studio Code diinstal. Jika Anda tidak memiliki versi terbaru, perbarui dan luncurkan Lingkungan Dev Anda. Untuk informasi selengkapnya, lihat [Amazon CodeCatalyst untuk Kode VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).

Untuk memperbaiki masalah ini JetBrains, periksa apakah Anda memiliki versi terbaru JetBrains dan AWS Toolkit for JetBrains diinstal. Jika Anda tidak memiliki versi terbaru, perbarui dan luncurkan Lingkungan Dev Anda. Untuk informasi selengkapnya, lihat [Amazon CodeCatalyst untuk JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).

# Memecahkan masalah dengan devfiles
<a name="devenvironments-devenvironments-devfile"></a>

Konsultasikan bagian berikut untuk memecahkan masalah yang terkait dengan devfiles di. CodeCatalyst Untuk informasi lebih lanjut tentang devfiles, lihat[Mengonfigurasi devfile untuk Lingkungan Dev](devenvironment-devfile.md).

**Topics**
+ [Lingkungan Dev saya menggunakan devfile universal default meskipun saya telah menerapkan gambar khusus dalam devfile khusus](#troubleshooting-devenvironments-custom-image)
+ [Proyek saya tidak dibangun di Lingkungan Dev saya dengan devfile universal default](#troubleshooting-devenvironments-default-image)
+ [Saya ingin memindahkan devfile repositori untuk Lingkungan Dev](#troubleshooting-devenvironments-devfile-moving)
+ [Saya mengalami masalah saat memulai devfile saya](#troubleshooting-devenvironments-devfile-recovery)
+ [Saya tidak yakin bagaimana cara memeriksa status devfile saya](#troubleshooting-devenvironments-devfile-status)
+ [Devfile saya tidak kompatibel dengan perkakas yang disediakan pada gambar terbaru](#troubleshooting-devenvironments-devfile-version)

## Lingkungan Dev saya menggunakan devfile universal default meskipun saya telah menerapkan gambar khusus dalam devfile khusus
<a name="troubleshooting-devenvironments-custom-image"></a>

Jika CodeCatalyst mengalami kesalahan saat memulai Lingkungan Dev yang menggunakan devfile kustom, Dev Environment default ke devfile universal default. Untuk memperbaiki masalah, Anda dapat memeriksa kesalahan yang tepat di log di bawah`/aws/mde/logs/devfile.log`. Anda juga dapat memeriksa apakah `postStart` eksekusi berhasil di log Anda:`/aws/mde/logs/devfileCommand.log`.

## Proyek saya tidak dibangun di Lingkungan Dev saya dengan devfile universal default
<a name="troubleshooting-devenvironments-default-image"></a>

Untuk memperbaiki masalah, periksa apakah Anda tidak menggunakan devfile khusus. Jika Anda tidak menggunakan devfile khusus, lihat `devfile.yaml` file di repositori sumber proyek untuk mencari dan memperbaiki kesalahan apa pun.

## Saya ingin memindahkan devfile repositori untuk Lingkungan Dev
<a name="troubleshooting-devenvironments-devfile-moving"></a>

Anda dapat memindahkan devfile default `/projects/devfile.yaml` ke repositori kode sumber Anda. Untuk memperbarui lokasi devfile, gunakan perintah berikut:`/aws/mde/mde start --location repository-name/devfile.yaml`.

## Saya mengalami masalah saat memulai devfile saya
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

Jika ada masalah saat memulai devfile Anda, itu akan masuk ke mode pemulihan sehingga Anda masih dapat terhubung ke lingkungan Anda dan memperbaiki devfile Anda. Saat dalam mode pemulihan, berjalan `/aws/mde/mde status` tidak akan berisi lokasi devfile Anda.

```
{
    "status": "STABLE"
}
```

Anda dapat memeriksa kesalahan di log di bawah`/aws/mde/logs`, memperbaiki devfile, dan mencoba menjalankan `/aws/mde/mde start` lagi.

## Saya tidak yakin bagaimana cara memeriksa status devfile saya
<a name="troubleshooting-devenvironments-devfile-status"></a>

Anda dapat memeriksa status devfile Anda dengan menjalankan`/aws/mde/mde status`. Setelah menjalankan perintah ini, Anda mungkin melihat salah satu dari berikut ini:
+ `{"status": "STABLE", "location": "devfile.yaml" }`

  Ini menunjukkan bahwa devfile Anda benar.
+ `{"status": "STABLE" }`

  Ini menunjukkan bahwa devfile Anda tidak dapat memulai dan telah memasuki mode pemulihan.

Anda dapat memeriksa kesalahan yang tepat di log di bawah`/aws/mde/logs/devfile.log`.

Anda juga dapat memeriksa apakah `postStart` eksekusi berhasil di log Anda:`/aws/mde/logs/devfileCommand.log`.

Untuk informasi selengkapnya, lihat [Menentukan gambar devfile universal untuk Lingkungan Dev](devenvironment-universal-image.md).

## Devfile saya tidak kompatibel dengan perkakas yang disediakan pada gambar terbaru
<a name="troubleshooting-devenvironments-devfile-version"></a>

Di Lingkungan Pengembang Anda, `devfile` atau `devfile postStart` mungkin gagal jika `latest` perkakas tidak memiliki perkakas yang diperlukan untuk proyek tertentu. Untuk memperbaiki masalah, lakukan hal berikut:<a name="devenvironment-devfile-version"></a>

1. Arahkan ke devfile Anda.

1. Di devfile Anda, perbarui ke versi gambar granular alih-alih. `latest` Ini mungkin terlihat mirip dengan yang berikut:

   ```
   components:
     - container:
         image: public.ecr.aws/amazonlinux/universal-image:1.0
   ```

1. Buat Lingkungan Dev baru menggunakan devfile yang diperbarui.