

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 Amazon CodeCatalyst
<a name="troubleshooting"></a>

Informasi berikut dapat membantu Anda memecahkan masalah umum di. CodeCatalyst Anda juga dapat menggunakan laporan CodeCatalyst kesehatan Amazon untuk menentukan apakah ada masalah layanan yang mungkin memengaruhi pengalaman Anda.

**Topics**
+ [Memecahkan masalah akses umum](#troubleshooting-general)
+ [Memecahkan masalah dukungan](#troubleshoot-support)
+ [Beberapa atau semua Amazon CodeCatalyst tidak tersedia](#service-unavailable)
+ [Saya tidak dapat membuat proyek di CodeCatalyst](#troubleshoot-create-project)
+ [Saya tidak dapat mengakses ruang BID saya sebagai pengguna baru atau tidak dapat ditambahkan sebagai pengguna SSO baru karena nama pengguna terpotong](#troubleshoot-username-truncated)
+ [Menambahkan pengguna SSO ke ruang federasi saya sebagai pengguna baru telah membuat pengguna duplikat](#troubleshoot-username-duplicated-SSO)
+ [Saya ingin mengirimkan umpan balik di CodeCatalyst](#troubleshoot-create-feedback)
+ [Memecahkan masalah dengan repositori sumber](troubleshooting-source.md)
+ [Memecahkan masalah proyek dan cetak biru](projects-troubleshooting.md)
+ [Memecahkan masalah dengan Lingkungan Dev](devenvironments-troubleshooting.md)
+ [Memecahkan masalah dengan alur kerja](troubleshooting-workflows.md)
+ [Memecahkan masalah dengan masalah](troubleshooting-issues.md)
+ [Memecahkan masalah dengan pencarian di CodeCatalyst](troubleshooting-search.md)
+ [Memecahkan masalah dengan ekstensi](troubleshooting-extensions.md)
+ [Memecahkan masalah dengan akun yang terkait dengan ruang Anda](troubleshooting-connections.md)
+ [Memecahkan masalah antara Amazon CodeCatalyst dan atau AWS SDKs AWS CLI](troubleshooting-cli-sdk.md)

## Memecahkan masalah akses umum
<a name="troubleshooting-general"></a>

### Saya lupa kata sandi saya
<a name="id-forgot-password"></a>

**Masalah:** Saya lupa kata sandi yang saya gunakan untuk ID AWS Builder dan Amazon CodeCatalyst saya.

**Kemungkinan perbaikan:** Cara termudah untuk memperbaiki masalah ini adalah dengan mengatur ulang kata sandi Anda.

1. Buka [Amazon CodeCatalyst](https://codecatalyst.aws/) dan masukkan **alamat Email** Anda. Lalu, pilih **Lanjutkan**.

1. Pilih **Lupa kata sandi?**

1. Kami akan mengirimkan email dengan tautan bagi Anda untuk mengubah kata sandi Anda. Jika Anda tidak melihat email di kotak masuk Anda, periksa folder spam Anda.

### Beberapa atau semua Amazon CodeCatalyst tidak tersedia
<a name="service-unavailable"></a>

**Masalah:** Saya menavigasi ke atau mengikuti tautan ke CodeCatalyst konsol, tetapi saya melihat kesalahan.

**Kemungkinan perbaikan:** Alasan paling umum untuk masalah ini adalah Anda mengikuti tautan ke proyek atau ruang yang belum diundang, atau ada masalah ketersediaan umum dengan layanan. Periksa [laporan Kesehatan](health-dashboard.md) untuk melihat apakah ada masalah yang diketahui dengan layanan ini. Jika tidak, hubungi orang yang mengundang Anda ke proyek atau ruang dan minta undangan lain. Jika Anda belum diundang ke proyek atau ruang apa pun, Anda dapat mendaftar dan [membuat ruang dan proyek Anda sendiri](sign-up-create-resources.md).

### Saya tidak dapat membuat proyek di CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Masalah:** Saya ingin membuat proyek, tetapi tombol **Buat proyek** ditampilkan sebagai tidak tersedia, atau saya menerima pesan kesalahan.

**Kemungkinan perbaikan:** Alasan paling umum untuk masalah ini adalah Anda masuk ke konsol dengan ID AWS Pembuat yang tidak memiliki peran **administrator Space**. Anda harus memiliki peran ini untuk membuat proyek di suatu ruang.

Jika Anda memiliki peran ini dan tombol tidak muncul sebagai tersedia, mungkin ada masalah sementara dengan layanan. Segarkan browser Anda dan coba lagi.

## Memecahkan masalah dukungan
<a name="troubleshoot-support"></a>

### Saya mendapatkan kesalahan saat mengakses Dukungan Amazon CodeCatalyst
<a name="troubleshoot-support-rolepolicy"></a>

**Masalah:** Ketika saya memilih CodeCatalyst opsi Dukungan untuk Amazon, saya menerima pesan kesalahan berikut:

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Akun AWS that is the billing account for the space.`

**Kemungkinan perbaikan:** Tambahkan peran yang diperlukan ke Akun AWS akun penagihan untuk ruang tersebut. Akun yang ditetapkan sebagai akun penagihan untuk ruang tersebut menggunakan `AWSRoleForCodeCatalystSupport` peran dan kebijakan `AmazonCodeCatalystSupportAccess` terkelola. Untuk informasi selengkapnya, lihat [Membuat **AWSRoleForCodeCatalystSupport**peran untuk akun dan ruang Anda](ipa-iam-roles.md#ipa-iam-roles-support-create).

**catatan**  
 AWS Builder ID hanya bisa mendapatkan dukungan untuk alias yang diautentikasi dengannya dan hanya untuk sumber daya berdasarkan izin. CodeCatalyst Dukungan Akun dan Penagihan tersedia untuk semua pengguna di ruang tersebut. Namun, pembangun hanya bisa mendapatkan dukungan untuk sumber daya dan informasi yang mereka miliki izin untuk masuk CodeCatalyst.

### Saya tidak dapat membuat kasus dukungan teknis untuk ruang saya
<a name="troubleshoot-support-technical-cases"></a>

**Masalah:** Saya tidak dapat membuat kasus dukungan teknis untuk ruang saya.

**Perbaikan:** Paket Business Support atau Enterprise Support perlu ditambahkan ke akun penagihan ruang agar pengguna di ruang tersebut dapat membuat kasus dukungan teknis. Minta administrator ruang Anda untuk menambahkan Dukungan paket ke akun penagihan ruang Anda atau kunjungi https://repost.aws/ untuk bertanya kepada AWS komunitas.

### Akun saya untuk kasus dukungan tidak lagi terhubung ke ruang saya di CodeCatalyst
<a name="troubleshoot-support-disconnected-account"></a>

**Masalah:** Akun saya untuk kasus dukungan tidak lagi terhubung ke ruang saya di CodeCatalyst.

**Perbaikan:** Jika pengguna dengan peran **administrator Space** mengganti akun penagihan ruang, ini akan memutuskan Dukungan paket dan semua kasus terkait dari ruang. Dukungan Kasus yang terkait dengan akun penagihan ruang lama tidak akan lagi terlihat di Dukungan Amazon CodeCatalyst. Pengguna root untuk akun penagihan tersebut dapat melihat dan menyelesaikan kasus lama dari Konsol Manajemen AWS dan dapat mengatur izin IAM agar pengguna lain dapat melihat dan menyelesaikan kasus lama. Dukungan Anda tidak akan dapat terus mendapatkan dukungan teknis CodeCatalyst dari akun penagihan ruang lama melalui Konsol Manajemen AWS, tetapi Anda dapat menerima dukungan teknis untuk layanan lain sampai Dukungan paket Anda dibatalkan.

Untuk informasi selengkapnya, lihat [Memperbarui, menyelesaikan, dan membuka kembali kasus Anda](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html) di *Dukungan Panduan Pengguna*.

### Saya tidak dapat membuka kasus dukungan untuk yang lain Layanan AWS di Dukungan Amazon CodeCatalyst
<a name="troubleshoot-support-other-services"></a>

**Masalah:** Saya tidak dapat membuka kasus dukungan untuk orang lain Layanan AWS CodeCatalyst. Dukungan 

**Kemungkinan perbaikan:** Anda hanya dapat membuka kasus CodeCatalyst dukungan dari Dukungan for CodeCatalyst. Jika Anda memerlukan dukungan untuk layanan atau sumber daya yang digunakan dari CodeCatalyst ke layanan lain AWS, Amazon, atau layanan pihak ketiga lainnya, Anda perlu membuat kasus melalui Konsol Manajemen AWS atau saluran dukungan layanan pihak ketiga. Untuk informasi selengkapnya, lihat [Membuat kasus dukungan dan manajemen kasus](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html) di *Panduan Dukungan Pengguna*. 

## Beberapa atau semua Amazon CodeCatalyst tidak tersedia
<a name="service-unavailable"></a>

**Masalah:** Saya menavigasi ke atau mengikuti tautan ke CodeCatalyst konsol, tetapi saya melihat kesalahan.

**Kemungkinan perbaikan:** Alasan paling umum untuk masalah ini adalah Anda mengikuti tautan ke proyek atau ruang yang belum diundang, atau ada masalah ketersediaan umum dengan layanan. Periksa [laporan Kesehatan](health-dashboard.md) untuk melihat apakah ada masalah yang diketahui dengan layanan ini. Jika tidak, hubungi orang yang mengundang Anda ke proyek atau ruang dan minta undangan lain. Jika Anda belum diundang ke proyek atau ruang apa pun, Anda dapat mendaftar dan [membuat ruang dan proyek Anda sendiri](sign-up-create-resources.md).

## Saya tidak dapat membuat proyek di CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Masalah:** Saya ingin membuat proyek, tetapi tombol **Buat proyek** ditampilkan sebagai tidak tersedia, atau saya menerima pesan kesalahan.

**Kemungkinan perbaikan:** Alasan paling umum untuk masalah ini adalah Anda masuk ke konsol dengan ID AWS Pembuat yang tidak memiliki peran **administrator Space**. Anda harus memiliki peran ini untuk membuat proyek di suatu ruang.

Jika Anda memiliki peran ini dan tombol tidak muncul sebagai tersedia, mungkin ada masalah sementara dengan layanan. Segarkan browser Anda dan coba lagi.

## Saya tidak dapat mengakses ruang BID saya sebagai pengguna baru atau tidak dapat ditambahkan sebagai pengguna SSO baru karena nama pengguna terpotong
<a name="troubleshoot-username-truncated"></a>

**Masalah:** CodeCatalyst memotong nama pengguna setelah 100 karakter, yang dapat menyebabkan beberapa nama pengguna tampak identik. Sebagai pengguna baru yang mengakses CodeCatalyst spasi, saya mengalami masalah ini tergantung pada jenis ruang, sebagai berikut:
+ Saya memiliki ID AWS Pembangun yang ingin saya gunakan untuk masuk CodeCatalyst. Ketika saya mencoba masuk ke ruang, saya mendapatkan pesan bahwa nama pengguna saya tidak valid.
+ Saya adalah administrator identitas federasi untuk CodeCatalyst ruang yang mendukung federasi identitas. Saat menambahkan pengguna baru ke pengguna dan grup SSO di IAM Identity Center, saya mendapat pesan bahwa pengguna tersebut tidak valid.

**Kemungkinan perbaikan:** Pengguna pertama yang masuk CodeCatalyst atau ditambahkan ke ruang sebagai pengguna SSO dengan nama pengguna terpotong tertentu akan berhasil. Setiap pengguna yang mendaftar dengan AWS Builder ID atau ditambahkan di IAM Identity Center setelah itu tidak akan dapat masuk karena nama akan tampak seperti duplikat. Tergantung pada jenis ruang, lakukan salah satu hal berikut:
+ Untuk dapat masuk ke ruang AWS Builder ID, daftar dengan nama pengguna yang berbeda.
+ Untuk dapat menambahkan pengguna baru di IAM Identity Center, tambahkan pengguna dengan nama pengguna yang berbeda.

**catatan**  
Meskipun nama pengguna tampaknya terpotong, CodeCatalyst peta ke identitas dengan cara yang tidak terpengaruh oleh nama pengguna dengan nama terpotong. Namun, jika nama pengguna dibuat yang sama dengan nama pengguna terpotong, nama pengguna tersebut tidak akan tersedia jika pengguna lain yang terkait (dengan spasi yang sama atau aplikasi Pusat Identitas IAM) telah bergabung CodeCatalyst dengan nama pengguna yang terpotong itu.

## Menambahkan pengguna SSO ke ruang federasi saya sebagai pengguna baru telah membuat pengguna duplikat
<a name="troubleshoot-username-duplicated-SSO"></a>

**Masalah:** Pengguna CodeCatalyst SSO yang ditambahkan ke CodeCatalyst spasi dan kemudian dihapus mungkin mengalami masalah saat nama pengguna mencoba digunakan kembali. Ini mungkin mengakibatkan kesalahan yang mirip dengan berikut ini, di mana pengguna tidak diizinkan untuk diduplikasi meskipun dibuat ulang. 

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Akun AWS that is the billing account for the space.`

**Kemungkinan perbaikan:** Jika pengguna IDC yang ada dihapus dan kemudian pengguna baru dibuat ulang dengan nama pengguna yang sama, maka pengguna baru tidak dapat masuk karena nama pengguna yang bertentangan dengan pengguna lama. Setelah nama pengguna ditambahkan ke spasi sebagai pengguna SSO, nama tersebut tidak dapat digunakan lagi. Setiap pengguna yang mendaftar dengan AWS Builder ID atau ditambahkan di IAM Identity Center setelah itu tidak akan dapat masuk karena nama akan tampak seperti duplikat. 

Tergantung pada jenis ruang, lakukan salah satu hal berikut:
+ Untuk dapat masuk ke ruang AWS Builder ID, daftar dengan nama pengguna yang berbeda.
+ Untuk dapat menambahkan pengguna baru di IAM Identity Center, tambahkan pengguna dengan nama pengguna yang berbeda.

## Saya ingin mengirimkan umpan balik di CodeCatalyst
<a name="troubleshoot-create-feedback"></a>

**Masalah:** Saya menemukan bug CodeCatalyst dan saya ingin mengirimkan umpan balik.

**Kemungkinan perbaikan:** Anda dapat mengirimkan umpan balik langsung di CodeCatalyst.

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Di panel navigasi, pilih **Berikan umpan balik**.

1. Pilih jenis umpan balik dari menu tarik-turun dan masukkan umpan balik Anda.

# Memecahkan masalah dengan repositori sumber
<a name="troubleshooting-source"></a>

Informasi berikut dapat membantu Anda memecahkan masalah umum dengan repositori sumber di. CodeCatalyst

**Topics**
+ [Saya telah mencapai penyimpanan maksimum untuk ruang saya dan melihat peringatan atau kesalahan](#source-troubleshoot-storage)
+ [Saya menerima kesalahan saat mencoba mengkloning atau mendorong ke repositori CodeCatalyst sumber Amazon](#source-troubleshoot-clone)
+ [Saya menerima kesalahan saat mencoba melakukan atau mendorong ke repositori CodeCatalyst sumber Amazon](#source-troubleshoot-commit-code)
+ [Saya memerlukan repositori sumber untuk proyek saya](#source-troubleshoot-need-repository)
+ [Repositori sumber saya baru tetapi berisi komit](#source-troubleshoot-initial-commit)
+ [Saya ingin cabang yang berbeda sebagai cabang default saya](#source-troubleshoot-default-branch)
+ [Saya menerima email tentang aktivitas dalam permintaan tarik](#source-troubleshoot-repository-emails)
+ [Saya lupa token akses pribadi saya (PAT)](#source-troubleshoot-forgot-pat)
+ [Permintaan tarik tidak menampilkan perubahan yang saya harapkan](#source-troubleshoot-pull-request-diff)
+ [Permintaan tarik menunjukkan status Tidak dapat digabungkan](#source-troubleshoot-pull-request-not-mergeable)

## Saya telah mencapai penyimpanan maksimum untuk ruang saya dan melihat peringatan atau kesalahan
<a name="source-troubleshoot-storage"></a>

**Masalah:** Saya ingin mengkomit kode ke satu atau lebih repositori sumber di CodeCatalyst, tetapi saya melihat kesalahan. Di konsol, saya melihat pesan di halaman repositori sumber bahwa saya telah mencapai batas penyimpanan untuk ruang tersebut. 

**Kemungkinan perbaikan:** Bergantung pada peran Anda dalam proyek atau ruang, Anda dapat mengurangi ukuran satu atau lebih repositori sumber Anda, menghapus repositori sumber yang tidak digunakan, atau mengubah tingkat penagihan Anda menjadi yang memiliki lebih banyak penyimpanan.
+ Untuk mengurangi ukuran repositori sumber dalam proyek, Anda dapat menghapus cabang yang tidak digunakan. Untuk informasi selengkapnya, lihat [Menghapus cabang](source-branches-delete.md) dan [Peran kontributor](ipa-role-types.md#ipa-role-contributor).
+ Untuk mengurangi penyimpanan keseluruhan untuk suatu ruang, Anda dapat menghapus repositori sumber yang tidak digunakan. Untuk informasi selengkapnya, lihat [Menghapus repositori sumber](source-repositories-delete.md) dan [Peran administrator proyek](ipa-role-types.md#ipa-role-project-admin).
+ Untuk meningkatkan jumlah penyimpanan yang tersedia untuk ruang Anda, Anda dapat mengubah tingkat penagihan menjadi satu dengan penyimpanan lebih banyak. Untuk informasi selengkapnya, lihat [Mengubah tingkat CodeCatalyst penagihan](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) di Panduan CodeCatalyst Administrator Amazon.

## Saya menerima kesalahan saat mencoba mengkloning atau mendorong ke repositori CodeCatalyst sumber Amazon
<a name="source-troubleshoot-clone"></a>

**Masalah:** Ketika saya mencoba mengkloning repositori sumber ke komputer lokal atau ke lingkungan pengembangan terintegrasi (IDE), saya menerima kesalahan izin.

**Kemungkinan perbaikan:** Anda mungkin tidak memiliki token akses pribadi (PAT) untuk ID AWS Builder Anda, Anda mungkin belum mengonfigurasi sistem manajemen kredensi Anda dengan PAT Anda, atau PAT Anda mungkin telah kedaluwarsa. Coba satu atau lebih solusi berikut:
+ Buat token akses pribadi (PAT). Untuk informasi selengkapnya, lihat [Berikan akses repositori pengguna dengan token akses pribadi](ipa-tokens-keys.md).
+ Pastikan Anda telah menerima undangan untuk proyek yang berisi repositori sumber dan bahwa Anda masih anggota proyek itu. Anda tidak dapat mengkloning repositori sumber jika Anda bukan anggota aktif dari proyek itu. Masuk ke konsol dan coba navigasikan ke ruang dan proyek tempat Anda mencoba mengkloning repositori sumber. Jika Anda tidak dapat melihat proyek dalam daftar proyek untuk ruang tersebut, Anda bukan anggota proyek itu, atau Anda belum menerima undangan untuk proyek itu. Untuk informasi selengkapnya, lihat [Menerima undangan dan membuat AWS Builder ID](sign-up-sign-in.md).
+ Pastikan perintah clone Anda diformat dengan benar dan menyertakan AWS Builder ID Anda. Contoh:

  ```
  https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
  ```
+ Gunakan AWS CLI untuk memastikan bahwa Anda memiliki PAT yang terkait dengan AWS Builder ID Anda, dan bahwa itu tidak kedaluwarsa. Jika Anda tidak memilikinya atau PAT kedaluwarsa, buat satu. Untuk informasi selengkapnya, lihat [Berikan akses repositori pengguna dengan token akses pribadi](ipa-tokens-keys.md).
+ Coba buat Lingkungan Dev untuk bekerja dengan kode di repositori sumber alih-alih mengkloningnya ke repo atau IDE lokal. Untuk informasi selengkapnya, lihat [Membuat Lingkungan Pengembangan](devenvironment-create.md).

## Saya menerima kesalahan saat mencoba melakukan atau mendorong ke repositori CodeCatalyst sumber Amazon
<a name="source-troubleshoot-commit-code"></a>

**Masalah:** Ketika saya mencoba mendorong ke repositori sumber, saya menerima kesalahan izin.

**Kemungkinan perbaikan:** Anda mungkin tidak memiliki peran dalam proyek yang memungkinkan Anda untuk melakukan dan mendorong perubahan kode ke proyek. Lihat peran Anda dalam proyek tempat Anda mencoba mendorong perubahan ke repositori sumber. Untuk informasi selengkapnya, lihat [Mendapatkan daftar anggota dan peran proyek mereka](projects-members.md#projects-members-view) dan [Memberikan akses dengan peran pengguna](ipa-roles.md). 

Jika Anda memiliki peran yang memungkinkan melakukan dan mendorong perubahan, cabang tempat Anda mencoba melakukan perubahan mungkin memiliki aturan cabang yang dikonfigurasi untuk itu yang mencegah Anda mendorong perubahan kode ke cabang itu. Coba buat cabang dan dorong kode Anda ke cabang itu sebagai gantinya. Untuk informasi selengkapnya, lihat [Mengelola tindakan yang diizinkan untuk cabang dengan aturan cabang](source-branches-branch-rules.md).

## Saya memerlukan repositori sumber untuk proyek saya
<a name="source-troubleshoot-need-repository"></a>

**Masalah:** Proyek saya tidak memiliki repositori sumber, atau saya memerlukan repositori sumber lain untuk proyek saya.

**Kemungkinan perbaikan:** Beberapa proyek dibuat tanpa sumber daya apa pun. Jika Anda adalah anggota proyek, Anda dapat membuat repositori sumber untuk proyek itu di. CodeCatalyst **Jika seseorang dengan peran **administrator Space** menginstal **GitHub Repositori** dan menghubungkannya ke GitHub akun, Anda dapat menautkan ke GitHub repositori yang tersedia untuk menambahkannya ke proyek Anda jika Anda memiliki peran administrator Project.** Untuk informasi selengkapnya, lihat [Membuat repositori sumber dan [Menautkan](source-repositories-link.md)](source-repositories-create.md) repositori sumber.

## Repositori sumber saya baru tetapi berisi komit
<a name="source-troubleshoot-initial-commit"></a>

**Masalah:** Saya baru saja membuat repositori sumber. Itu harus kosong, tetapi memiliki komit, cabang, dan `README.md` file di dalamnya.

**Kemungkinan perbaikan:** Ini adalah perilaku yang diharapkan. Semua repositori sumber CodeCatalyst termasuk komit awal yang menetapkan cabang default ke `main` dan menyertakan kode sampel (jika repositori dibuat untuk proyek menggunakan cetak biru yang menyertakan kode sampel) atau file penurunan harga templat untuk file README repositori. Anda dapat membuat cabang tambahan di konsol dan di klien Git. Anda dapat membuat dan mengedit file di konsol, dan menghapus file di lingkungan Dev dan klien Git.

## Saya ingin cabang yang berbeda sebagai cabang default saya
<a name="source-troubleshoot-default-branch"></a>

**Masalah:** Repositori sumber saya datang dengan cabang default bernama`main`, tetapi saya ingin cabang yang berbeda sebagai cabang default saya.

**Kemungkinan perbaikan:** Anda tidak dapat mengubah atau menghapus cabang default di repositori sumber di. CodeCatalyst Anda dapat membuat cabang tambahan dan menggunakan cabang tersebut dalam tindakan sumber dalam alur kerja. Anda juga dapat memilih untuk menautkan GitHub repositori dan menggunakannya sebagai repositori untuk proyek Anda.

## Saya menerima email tentang aktivitas dalam permintaan tarik
<a name="source-troubleshoot-repository-emails"></a>

**Masalah:** Saya tidak mendaftar atau mengonfigurasi pemberitahuan email tentang aktivitas permintaan tarik, tetapi saya tetap menerimanya.

**Kemungkinan perbaikan:** Pemberitahuan email dikirim secara otomatis tentang aktivitas permintaan tarik. Untuk informasi selengkapnya, lihat [Meninjau kode dengan permintaan tarik di Amazon CodeCatalyst](source-pull-requests.md).

## Saya lupa token akses pribadi saya (PAT)
<a name="source-troubleshoot-forgot-pat"></a>

**Masalah:** Saya telah menggunakan PAT untuk mengkloning, mendorong, dan menarik kode untuk repositori sumber, tetapi saya telah kehilangan nilai untuk token saya, dan saya tidak dapat menemukannya di konsol. CodeCatalyst 

**Kemungkinan perbaikan:** Cara tercepat untuk mengatasi masalah ini adalah dengan membuat PAT lain dan mengonfigurasi manajer kredensi atau IDE Anda untuk menggunakan PAT baru ini. Kami hanya menampilkan nilai PAT saat Anda membuatnya. Jika Anda kehilangan nilai ini, itu tidak dapat diambil. Untuk informasi selengkapnya, lihat [Berikan akses repositori pengguna dengan token akses pribadi](ipa-tokens-keys.md).

## Permintaan tarik tidak menampilkan perubahan yang saya harapkan
<a name="source-troubleshoot-pull-request-diff"></a>

**Masalah:** Saya membuat permintaan tarik, tetapi saya tidak melihat perubahan yang saya harapkan untuk dilihat antara cabang sumber dan tujuan.

**Kemungkinan perbaikan:** Ini mungkin disebabkan oleh sejumlah masalah. Coba satu atau lebih solusi berikut:
+ Anda mungkin meninjau perubahan di antara revisi lama, atau Anda mungkin tidak melihat perubahan terbaru. Segarkan browser Anda dan pastikan bahwa Anda telah memilih perbandingan antara revisi yang ingin Anda lihat.
+ Tidak semua perubahan dalam permintaan tarik dapat ditampilkan di konsol. Misalnya, Anda tidak dapat melihat submodul Git di konsol, sehingga Anda tidak dapat melihat perbedaan dalam submodul dalam permintaan tarik. Beberapa perbedaan mungkin terlalu besar untuk ditampilkan. Untuk informasi selengkapnya, lihat [Kuota untuk repositori sumber di CodeCatalyst](source-quotas.md) dan [Melihat fileMelihat riwayat perubahan pada file](source-files-view.md).
+ Permintaan tarik menampilkan perbedaan antara basis gabungan dan revisi apa pun yang Anda pilih. Saat Anda membuat permintaan tarik, perbedaan yang ditampilkan untuk Anda adalah perbedaan antara ujung cabang sumber dan ujung cabang tujuan. Setelah permintaan tarik dibuat, perbedaan yang ditampilkan adalah antara revisi dan basis penggabungannya. Basis penggabungan adalah komit yang merupakan ujung cabang tujuan saat revisi dibuat. Basis penggabungan dapat berubah di antara revisi. Untuk informasi selengkapnya tentang perbedaan dan penggabungan basis di Git, lihat [git-merge-base](https://git-scm.com/docs/git-merge-base)di dokumentasi Git. 

## Permintaan tarik menunjukkan status Tidak dapat digabungkan
<a name="source-troubleshoot-pull-request-not-mergeable"></a>

**Masalah:** Saya ingin menggabungkan permintaan tarik, tetapi statusnya ditampilkan sebagai **Tidak dapat digabungkan**.

**Kemungkinan perbaikan:** Ini dapat disebabkan oleh satu atau lebih masalah:
+ Semua pengulas yang diperlukan untuk permintaan tarik Anda harus menyetujui permintaan tarik sebelum dapat digabungkan. Tinjau daftar pengulas yang diperlukan untuk setiap pengulas dengan ikon jam di sebelah nama. Ikon jam menunjukkan bahwa pengulas belum menyetujui permintaan tarik.
**catatan**  
Jika peninjau yang diperlukan telah dihapus dari proyek Anda sebelum menyetujui permintaan tarik, Anda tidak dapat menggabungkan permintaan tarik. Tutup permintaan tarik dan buat permintaan tarik baru.
+ Mungkin ada konflik gabungan antara cabang sumber dan cabang tujuan. CodeCatalyst tidak mendukung semua kemungkinan strategi dan opsi penggabungan Git. Anda dapat mengevaluasi cabang untuk konflik gabungan di Lingkungan Pengembang atau mengkloning repositori dan menggunakan alat IDE atau Git untuk menemukan dan menyelesaikan konflik gabungan. Lihat informasi yang lebih lengkap di [Menggabungkan permintaan penarikan](pull-requests-merge.md).

# Memecahkan masalah proyek dan cetak biru
<a name="projects-troubleshooting"></a>

Bagian ini dapat membantu Anda memecahkan masalah umum yang mungkin Anda temui saat bekerja dengan proyek dan cetak biru di Amazon. CodeCatalyst

# Java API dengan AWS Fargate blueprint kehilangan dependensi untuk apache-maven-3.8.6
<a name="projects-troubleshooting-error-maven"></a>

**Masalah:** Untuk proyek yang dibuat dari Java API dengan AWS Fargate cetak biru, alur kerja gagal dengan kesalahan untuk dependensi yang hilang. `apache-maven-3.8.6` Alur kerja gagal dengan output yang mirip dengan contoh berikut:

```
Step 8/25 : RUN wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp
---> Running in 1851ce6f4d1b
[91m--2023-03-10 01:24:55--  https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
[0m[91mResolving dlcdn.apache.org (dlcdn.apache.org)... 
[0m[91m151.101.2.132, 2a04:4e42::644
Connecting to dlcdn.apache.org (dlcdn.apache.org)|151.101.2.132|:443... 
[0m[91mconnected.
[0m[91mHTTP request sent, awaiting response... [0m[91m404 Not Found
2023-03-10 01:24:55 ERROR 404: Not Found.
[0mThe command '/bin/sh -c wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp' returned a non-zero code: 8
[Container] 2023/03/10 01:24:55 Command failed with exit status 8
```

**Solusi:** Perbarui cetak biru Dockerfile menggunakan langkah-langkah berikut.

1. Di bilah pencarian, masukkan `apache-maven-3.8.6` untuk menemukan dockerfile di dalam proyek yang dibuat dengan Java API dengan AWS Fargate cetak biru.

1.  Perbarui Dockerfile (`/static-assets/app/Dockerfile`) untuk digunakan `maven:3.9.0-amazoncorretto-11` sebagai gambar dasar dan hapus ketergantungan pada paket. `apache-maven-3.8.6` 

1. (Disarankan) Kami juga merekomendasikan memperbarui ukuran tumpukan Maven menjadi 6 GB.

Di bawah ini adalah contoh Dockerfile.

```
FROM maven:3.9.0-amazoncorretto-11 AS builder

COPY ./pom.xml ./pom.xml
COPY src ./src/

ENV MAVEN_OPTS='-Xmx6g'

RUN mvn -Dmaven.test.skip=true clean package

FROM amazoncorretto:11-alpine

COPY —from=builder target/CustomerService-0.0.1.jar CustomerService-0.0.1.jar
EXPOSE 80
CMD ["java","-jar","-Dspring.profiles.active=prod","/CustomerService-0.0.1.jar", "—server.port=80"]
```

# Alur kerja cetak biru aplikasi web tiga tingkat modern **OnPullRequest**gagal dengan kesalahan izin untuk Amazon CodeGuru
<a name="projects-troubleshooting-onpullrequest"></a>

**Masalah:** Ketika saya mencoba menjalankan alur kerja untuk proyek saya, alur kerja gagal dijalankan dengan pesan berikut: 

```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```

``

**Solusi:** Salah satu kemungkinan penyebab kegagalan tindakan ini mungkin karena izin yang hilang dalam kebijakan peran IAM, di mana versi peran layanan yang digunakan oleh CodeCatalyst dalam koneksi Akun AWS tidak memiliki izin yang diperlukan agar tindakan **codeguru\$1codereview** berjalan dengan sukses. Untuk memperbaiki masalah ini, peran layanan harus diperbarui dengan izin yang diperlukan, atau Anda harus mengubah peran layanan yang digunakan untuk alur kerja menjadi peran yang memiliki izin yang diperlukan untuk Amazon dan CodeGuru Amazon Reviewer. CodeGuru Dengan menggunakan langkah-langkah berikut, temukan peran Anda dan perbarui izin kebijakan peran agar alur kerja berhasil berjalan.

**catatan**  
Langkah-langkah ini berlaku untuk alur kerja berikut di CodeCatalyst:  
**OnPullRequest**Alur kerja disediakan untuk proyek yang dibuat dengan cetak biru aplikasi web tiga tingkat Modern di. CodeCatalyst
Alur kerja ditambahkan ke proyek CodeCatalyst dengan tindakan yang mengakses Amazon CodeGuru atau Amazon CodeGuru Reviewer.

Setiap proyek berisi alur kerja dengan tindakan yang menggunakan peran dan lingkungan yang disediakan oleh yang Akun AWS terhubung ke proyek Anda. CodeCatalyst Alur kerja dengan tindakan dan kebijakan yang ditunjuk disimpan di repositori sumber Anda di direktori /.codecatalyst/workflows. Memodifikasi alur kerja YAMAL tidak diperlukan kecuali Anda menambahkan ID peran baru ke alur kerja yang ada. Untuk informasi tentang elemen dan pemformatan template YAMAL, lihat. [Alur kerja definisi YAMAL](workflow-reference.md)

Ini adalah langkah-langkah tingkat tinggi yang harus diikuti untuk mengedit kebijakan peran Anda dan memverifikasi alur kerja YAMAL.

**Untuk mereferensikan nama peran Anda di alur kerja YAMAL dan memperbarui kebijakan**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Arahkan ke CodeCatalyst ruang Anda. Arahkan ke proyek Anda.

1. **Pilih **CI/CD**, lalu pilih Alur kerja.** 

1. Pilih alur kerja berjudul **OnPullRequest**. Pilih tab **Ketentuan**.

1. Dalam alur kerja YAMAL, di `Role:` bidang di bawah tindakan **codeguru\$1codereview**, catat nama peran. Ini adalah peran dengan kebijakan yang akan Anda ubah di IAM. Contoh berikut menunjukkan nama peran.  
![\[Melihat nama peran IAM dalam alur kerja YAMAL\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)

1. Lakukan salah satu tindakan berikut:
   + (Disarankan) Perbarui peran layanan yang terhubung ke project Anda dengan izin yang diperlukan untuk Amazon CodeGuru dan Amazon CodeGuru Reviewer. Peran akan memiliki nama `CodeCatalystWorkflowDevelopmentRole-spaceName` dengan pengenal unik ditambahkan. Untuk informasi selengkapnya tentang kebijakan peran dan peran, lihat[Memahami peran **CodeCatalystWorkflowDevelopmentRole-*spaceName***layanan](ipa-iam-roles.md#ipa-iam-roles-service-role). Lanjutkan ke langkah selanjutnya untuk memperbarui kebijakan di IAM.
**catatan**  
Anda harus memiliki akses AWS administrator ke Akun AWS dengan peran dan kebijakan. 
   + Ubah peran layanan yang digunakan untuk alur kerja menjadi peran yang memiliki izin yang diperlukan untuk Amazon dan CodeGuru Amazon CodeGuru Reviewer atau buat peran baru dengan izin yang diperlukan.

1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   Di konsol IAM, temukan peran dari langkah 5, seperti`CodeCatalystPreviewDevelopmentRole`.

1. Dalam peran dari langkah 5, ubah kebijakan izin untuk menyertakan `codeguru-reviewer:*` dan `codeguru:*` izin. Setelah menambahkan izin ini, kebijakan izin akan terlihat mirip dengan yang berikut:

1. Setelah Anda melakukan koreksi kebijakan, kembali ke CodeCatalyst dan mulai menjalankan alur kerja lagi.

## Masih mencari untuk memecahkan masalah Anda?
<a name="projects-last-help"></a>

Anda dapat pergi ke [Amazon CodeCatalyst](https://codecatalyst.aws/) atau mengisi formulir [Support Feedback](https://support.aws.amazon.com/#/contacts/aws-account-support/). Di bagian **Permintaan informasi**, di bawah **Bagaimana kami dapat membantu Anda**, sertakan bahwa Anda adalah CodeCatalyst pelanggan Amazon. Berikan detail sebanyak mungkin sehingga kami dapat mengatasi masalah Anda dengan paling efisien.

# 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.

# Memecahkan masalah dengan alur kerja
<a name="troubleshooting-workflows"></a>

Lihat bagian berikut untuk memecahkan masalah yang terkait dengan alur kerja di Amazon. CodeCatalyst Untuk informasi lebih lanjut tentang alur kerja, lihat [Bangun, uji, dan terapkan dengan alur kerjaBangun, uji, dan terapkan dengan alur kerja](workflow.md).

**Topics**
+ [Bagaimana cara memperbaiki pesan “Alur kerja tidak aktif”?](#troubleshooting-workflows-inactive)
+ [Bagaimana cara memperbaiki kesalahan “Definisi alur kerja memiliki *n* kesalahan”?](#troubleshooting-workflows-asterisks)
+ [Bagaimana cara memperbaiki kesalahan “Tidak dapat menemukan kredensil” dan “ExpiredToken”?](#troubleshooting-workflows-auth-errors-eks)
+ [Bagaimana cara memperbaiki kesalahan “Tidak dapat terhubung ke server”?](#troubleshooting-workflows-unable-connect-eks)
+ [Mengapa CodeDeploy bidang hilang dari editor visual?](#troubleshooting-workflows-codedeploy)
+ [Bagaimana cara memperbaiki kesalahan kemampuan IAM?](#troubleshooting-workflows-capabilities)
+ [Bagaimana cara memperbaiki kesalahan “npm install”?](#troubleshooting-workflows-npm)
+ [Mengapa beberapa alur kerja memiliki nama yang sama?](#troubleshooting-workflows-name)
+ [Dapatkah saya menyimpan file definisi alur kerja saya di folder lain?](#troubleshooting-workflows-folder)
+ [Bagaimana cara menambahkan tindakan secara berurutan ke alur kerja saya?](#troubleshooting-workflows-visual)
+ [Mengapa alur kerja saya berhasil memvalidasi tetapi gagal saat runtime?](#troubleshooting-workflows-validation)
+ [Penemuan otomatis tidak menemukan laporan apa pun untuk tindakan saya](#troubleshooting-reports-auto-discovery)
+ [Tindakan saya gagal pada laporan yang ditemukan secara otomatis setelah saya mengonfigurasi kriteria keberhasilan](#troubleshooting-success-auto-discovery)
+ [Penemuan otomatis menghasilkan laporan yang tidak saya inginkan](#troubleshooting-unwanted-auto-discovery)
+ [Penemuan otomatis menghasilkan banyak laporan kecil untuk satu kerangka pengujian](#troubleshooting-reports-combined)
+ [Alur kerja yang tercantum di bawah CI/CD tidak cocok dengan yang ada di repositori sumber](#troubleshooting-workflow-source)
+ [Saya tidak dapat membuat atau memperbarui alur kerja](#troubleshooting-workflows-branchrules)

## Bagaimana cara memperbaiki pesan “Alur kerja tidak aktif”?
<a name="troubleshooting-workflows-inactive"></a>

**Masalah**: Di CodeCatalyst konsol, di bawah **CI/CD**, **Alur kerja, alur** kerja Anda muncul dengan pesan berikut: 

`Workflow is inactive.`

Pesan ini menunjukkan bahwa file definisi alur kerja berisi pemicu yang tidak berlaku untuk cabang yang Anda gunakan saat ini. Misalnya, file definisi alur kerja Anda mungkin berisi `PUSH` pemicu yang mereferensikan `main` cabang Anda, tetapi Anda berada di cabang fitur. Karena perubahan yang Anda buat di cabang fitur tidak berlaku`main`, dan tidak akan memulai alur kerja berjalan`main`, CodeCatalyst nonaktifkan alur kerja di cabang dan tandai sebagai. `Inactive`

**Kemungkinan perbaikan**:

Jika Anda ingin memulai alur kerja di cabang fitur Anda, Anda dapat melakukan hal berikut:
+ Di cabang fitur Anda, dalam file definisi alur kerja, hapus `Branches` properti dari `Triggers` bagian sehingga terlihat seperti ini:

  ```
  Triggers:
    - Type: PUSH
  ```

  Konfigurasi ini menyebabkan pemicu diaktifkan saat push ke cabang mana pun, termasuk cabang fitur Anda. Jika pemicu diaktifkan, CodeCatalyst akan memulai alur kerja berjalan menggunakan file definisi alur kerja dan file sumber di cabang apa pun yang Anda dorong.
+ Di cabang fitur Anda, dalam file definisi alur kerja, hapus `Triggers` bagian dan jalankan alur kerja secara manual.
+ Di cabang fitur Anda, dalam file definisi alur kerja, ubah `PUSH` bagian tersebut sehingga mereferensikan cabang fitur Anda daripada cabang lain (seperti`main`, misalnya).

**penting**  
Berhati-hatilah untuk tidak melakukan perubahan ini jika Anda tidak bermaksud menggabungkannya untuk kembali ke `main` cabang Anda.

Untuk informasi selengkapnya tentang mengedit file definisi alur kerja, lihat[Membuat alur kerja](workflows-create-workflow.md).

Untuk informasi lebih lanjut tentang menggunakan pemicu, lihat [Memulai alur kerja berjalan secara otomatis menggunakan pemicu](workflows-add-trigger.md).

## Bagaimana cara memperbaiki kesalahan “Definisi alur kerja memiliki *n* kesalahan”?
<a name="troubleshooting-workflows-asterisks"></a>

**Masalah**: Anda melihat salah satu pesan kesalahan berikut:

**Kesalahan 1:**

Di halaman **CI/CD**, **alur kerja**, di bawah nama alur kerja Anda, Anda melihat:

`Workflow definition has n errors`

**Kesalahan 2:**

Saat mengedit alur kerja, Anda memilih tombol **Validasi** dan pesan berikut muncul di bagian atas konsol: CodeCatalyst 

`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`

**Kesalahan 3:**

Setelah menavigasi ke halaman detail alur kerja Anda, Anda melihat kesalahan berikut di bidang definisi **Alur Kerja**:

`n errors`

**Kemungkinan perbaikan**: 
+ Pilih **CI/CD**, pilih **Alur kerja**, dan pilih nama alur kerja yang memiliki kesalahan. Di bidang **Definisi alur kerja** di dekat bagian atas, pilih tautan ke kesalahan. Detail tentang kesalahan muncul di bagian bawah halaman. Ikuti tips pemecahan masalah dalam kesalahan untuk memperbaiki masalah.
+ Pastikan bahwa file definisi alur kerja adalah file YAMG.
+ Pastikan properti YAMB dalam file definisi alur kerja bersarang pada tingkat yang tepat. Untuk melihat bagaimana properti harus disarangkan dalam file definisi alur kerja, lihat[Alur kerja definisi YAMAL](workflow-reference.md), atau lihat dokumentasi tindakan Anda, yang ditautkan ke from. [Menambahkan tindakan ke alur kerja](workflows-add-action.md) 
+ Pastikan tanda bintang (`*`) dan karakter khusus lainnya lolos dengan benar. Untuk menghindarinya, tambahkan tanda kutip tunggal atau ganda. Contoh:

  ```
  Outputs:      
    Artifacts:
      - Name: myartifact
        Files:
          - "**/*"
  ```

  Untuk informasi selengkapnya tentang karakter khusus dalam file definisi alur kerja, lihat[Pedoman dan konvensi sintaks](workflow-reference.md#workflow.terms.syntax.conv).
+ Pastikan properti YAMB dalam file definisi alur kerja menggunakan kapitalisasi yang tepat. Untuk informasi lebih lanjut tentang aturan casing, lihat[Pedoman dan konvensi sintaks](workflow-reference.md#workflow.terms.syntax.conv). Untuk menentukan casing yang benar dari setiap properti, lihat[Alur kerja definisi YAMAL](workflow-reference.md), atau lihat dokumentasi tindakan Anda, yang terkait dengan dari[Menambahkan tindakan ke alur kerja](workflows-add-action.md).
+ Pastikan bahwa `SchemaVersion` properti hadir dan diatur ke versi yang benar dalam file definisi alur kerja. Untuk informasi selengkapnya, lihat [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Pastikan bahwa `Triggers` bagian dalam file definisi alur kerja mencakup semua properti yang diperlukan. Untuk menentukan properti yang diperlukan, pilih pemicu di [editor visual](workflow.md#workflow.editors) dan cari bidang yang tidak memiliki informasi, atau lihat dokumentasi referensi pemicu di[Triggers](workflow-reference.md#triggers-reference).
+ Pastikan bahwa `DependsOn` properti dalam file definisi alur kerja dikonfigurasi dengan benar dan tidak memperkenalkan dependensi melingkar. Untuk informasi selengkapnya, lihat [Tindakan pengurutan](workflows-depends-on.md).
+ Pastikan bahwa `Actions` bagian dalam file definisi alur kerja menyertakan setidaknya satu tindakan. Untuk informasi selengkapnya, lihat [Tindakan](workflow-reference.md#actions-reference). 
+ Pastikan bahwa setiap tindakan mencakup semua properti yang diperlukan. Untuk menentukan properti yang diperlukan, pilih tindakan di [editor visual](workflow.md#workflow.editors) dan cari bidang yang tidak memiliki informasi, atau lihat dokumentasi tindakan Anda, yang ditautkan ke dari[Menambahkan tindakan ke alur kerja](workflows-add-action.md).
+ Pastikan bahwa semua artefak input memiliki artefak keluaran yang sesuai. Untuk informasi selengkapnya, lihat [Mendefinisikan artefak keluaran](workflows-working-artifacts-output.md).
+ Pastikan bahwa variabel yang didefinisikan dalam satu tindakan diekspor sehingga mereka dapat digunakan dalam tindakan lain. Untuk informasi selengkapnya, lihat [Mengekspor variabel sehingga tindakan lain dapat menggunakannya](workflows-working-with-variables-export-input.md).

## Bagaimana cara memperbaiki kesalahan “Tidak dapat menemukan kredensil” dan “ExpiredToken”?
<a name="troubleshooting-workflows-auth-errors-eks"></a>

**Masalah**: Saat bekerja[Tutorial: Menyebarkan aplikasi ke Amazon EKS](deploy-tut-eks.md), Anda melihat salah satu atau kedua pesan kesalahan berikut di jendela terminal mesin pengembangan Anda:

`Unable to locate credentials. You can configure credentials by running "aws configure".`

`ExpiredToken: The security token included in the request is expired` 

**Kemungkinan perbaikan**:

Kesalahan ini menunjukkan bahwa kredensil yang Anda gunakan untuk mengakses AWS layanan telah kedaluwarsa. Dalam hal ini, jangan jalankan `aws configure` perintah. Sebagai gantinya, gunakan petunjuk berikut untuk menyegarkan kunci AWS akses dan token sesi Anda.

**Untuk menyegarkan kunci AWS akses dan token sesi**

1. Pastikan Anda memiliki URL portal AWS akses, nama pengguna, dan kata sandi untuk pengguna yang Anda gunakan untuk melengkapi tutorial Amazon EKS (`codecatalyst-eks-user`). Anda seharusnya telah mengkonfigurasi item ini ketika Anda menyelesaikan [Langkah 1: Siapkan mesin pengembangan Anda](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) tutorial.
**catatan**  
Jika Anda tidak memiliki informasi ini, buka halaman `codecatalyst-eks-user` detail di Pusat Identitas IAM, pilih **Atur ulang kata sandi**, **Hasilkan kata sandi satu kali [**...] , dan **Atur ulang kata sandi** lagi untuk menampilkan informasi di layar.

1. Lakukan salah satu tindakan berikut:
   + Rekatkan URL portal AWS akses ke bilah alamat browser Anda.

     Atau
   + Segarkan halaman portal AWS akses jika sudah dimuat.

1. Masuk dengan nama `codecatalyst-eks-user` pengguna dan kata sandi, jika Anda belum masuk.

1. Pilih **Akun AWS**, lalu pilih nama yang Akun AWS Anda tetapkan `codecatalyst-eks-user` pengguna dan set izin.

1. Di samping nama set izin (`codecatalyst-eks-permission-set`), pilih **Baris perintah atau akses terprogram**.

1. Salin perintah di tengah halaman. Mereka terlihat mirip dengan yang berikut:

   ```
   export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
   export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
   export AWS_SESSION_TOKEN="session-token"
   ```

   ... di *session-token* mana string acak panjang.

1. Tempelkan perintah ke prompt terminal Anda di mesin pengembangan Anda dan tekan Enter.

   Kunci baru dan token sesi dimuat.

   Anda sekarang telah menyegarkan kredensialnya. `kubectl`Perintah AWS CLI`eksctl`,, dan sekarang harus berfungsi. 

## Bagaimana cara memperbaiki kesalahan “Tidak dapat terhubung ke server”?
<a name="troubleshooting-workflows-unable-connect-eks"></a>

**Masalah**: Saat mengerjakan tutorial yang dijelaskan di[Tutorial: Menyebarkan aplikasi ke Amazon EKS](deploy-tut-eks.md), Anda melihat pesan kesalahan yang mirip dengan yang berikut ini di jendela terminal mesin pengembangan Anda:

`Unable to connect to the server: dial tcp: lookup long-string.gr7.us-west-2.eks.amazonaws.com on 1.2.3.4:5: no such host`

**Kemungkinan perbaikan**:

Kesalahan ini biasanya menunjukkan bahwa kredenal yang digunakan `kubectl` utilitas untuk terhubung ke kluster Amazon EKS Anda telah kedaluwarsa. Untuk mengatasi masalah ini, segarkan kredensi dengan memasukkan perintah berikut di prompt terminal:

```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```

Di mana:
+ *codecatalyst-eks-cluster*diganti dengan nama cluster Amazon EKS Anda.
+ *us-west-2*diganti dengan AWS Wilayah tempat cluster Anda digunakan.

## Mengapa CodeDeploy bidang hilang dari editor visual?
<a name="troubleshooting-workflows-codedeploy"></a>

**Masalah**: Anda menggunakan tindakan [Deploy to Amazon ECS](deploy-action-ecs.md), dan Anda tidak melihat CodeDeploy bidang seperti **CodeDeploy AppSpec**di editor visual alur kerja. Masalah ini dapat terjadi karena layanan Amazon ECS yang Anda tentukan di bidang **Layanan** tidak dikonfigurasi untuk melakukan penerapan biru/hijau.

**Kemungkinan perbaikan**: 
+ **Pilih layanan Amazon ECS yang berbeda pada tab **Konfigurasi aksi Deploy to Amazon ECS**.** Untuk informasi selengkapnya, lihat [Menyebarkan ke Amazon ECS dengan alur kerja](deploy-action-ecs.md).
+ Konfigurasikan layanan Amazon ECS yang dipilih untuk melakukan blue/green penerapan. Untuk informasi selengkapnya tentang mengonfigurasi blue/green penerapan, lihat penerapan [Biru/Hijau dengan CodeDeploy di Panduan Pengembang Layanan](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) *Amazon* Elastic Container.

## Bagaimana cara memperbaiki kesalahan kemampuan IAM?
<a name="troubleshooting-workflows-capabilities"></a>

**Masalah**: Anda menggunakan tindakan [CloudFormation tumpukan Deploy](deploy-action-cfn.md), dan Anda melihat `##[error] requires capabilities: [capability-name]` di log tindakan ** CloudFormation tumpukan Deploy** Anda.

**Kemungkinan perbaikan**: Selesaikan prosedur berikut untuk menambahkan kemampuan ke file definisi alur kerja. *Untuk informasi selengkapnya tentang kemampuan IAM, lihat [Mengakui sumber daya IAM dalam CloudFormation templat di Panduan Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) IAM.*

------
#### [ Visual ]

**Untuk menambahkan kemampuan IAM menggunakan editor visual**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Dalam diagram alur kerja, pilih tindakan ** CloudFormation tumpukan Deploy** Anda.

1. Pilih tab **Konfigurasi**.

1. Di bagian bawah, pilih **Advanced - opsional**.

1. Dalam daftar drop-down **Kemampuan**, pilih kotak centang di samping kemampuan yang disebutkan dalam pesan kesalahan. Jika kemampuan tidak tersedia dalam daftar, gunakan editor YAMB untuk menambahkannya.

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMB alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

1. Jika alur kerja baru tidak dimulai secara otomatis, jalankan alur kerja secara manual untuk melihat apakah perubahan memperbaiki kesalahan. Untuk informasi selengkapnya tentang menjalankan alur kerja secara manual, lihat[Memulai proses alur kerja secara manual](workflows-manually-start.md).

------
#### [ YAML ]

**Untuk menambahkan kemampuan IAM menggunakan editor YAMG**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih **YAMG.**

1. Dalam aksi ** CloudFormation tumpukan Deploy**, tambahkan `capabilities` properti, seperti ini:

   ```
   DeployCloudFormationStack:
     Configuration:
       capabilities: capability-name
   ```

   Ganti *capability-name* dengan nama kemampuan IAM yang ditunjukkan dalam pesan kesalahan. Gunakan koma dan tidak ada spasi untuk mencantumkan beberapa kemampuan. Untuk informasi lebih lanjut, lihat deskripsi `capabilities` properti di[Tindakan 'Menyebarkan CloudFormation tumpukan' YAMAL](deploy-action-ref-cfn.md).

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMB alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

1. Jika alur kerja baru tidak dimulai secara otomatis, jalankan alur kerja secara manual untuk melihat apakah perubahan memperbaiki kesalahan. Untuk informasi selengkapnya tentang menjalankan alur kerja secara manual, lihat[Memulai proses alur kerja secara manual](workflows-manually-start.md).

------

## Bagaimana cara memperbaiki kesalahan “npm install”?
<a name="troubleshooting-workflows-npm"></a>

**Masalah**: [Tindakan AWS CDK penerapan atau tindakan AWS CDK](cdk-dep-action.md) [bootstrap](cdk-boot-action.md) Anda gagal dengan `npm install` kesalahan. Kesalahan ini dapat terjadi karena Anda menyimpan dependensi AWS CDK aplikasi di registri private node package manager (npm) yang tidak dapat diakses oleh tindakan. 

**Kemungkinan perbaikan**: Gunakan petunjuk berikut untuk memperbarui `cdk.json` file AWS CDK aplikasi Anda dengan registri tambahan dan informasi otentikasi.

**Sebelum Anda mulai**

1. Buat rahasia untuk informasi otentikasi Anda. Anda akan mereferensikan rahasia ini dalam `cdk.json` file alih-alih memberikan padanan cleartext. Untuk membuat rahasia:

   1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

   1. Pilih proyek Anda.

   1. **Di panel navigasi, pilih **CI/CD**, lalu pilih Rahasia.**

   1. Buat dua rahasia dengan properti berikut:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Untuk informasi lebih lanjut tentang rahasia, lihat[Menyembunyikan data menggunakan rahasia](workflows-secrets.md).

1. Tambahkan rahasia sebagai variabel lingkungan ke AWS CDK tindakan Anda. Tindakan akan menggantikan variabel dengan nilai nyata saat dijalankan. Untuk menambahkan rahasia:

   1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

   1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

   1. Pilih **Edit**.

   1. Pilih **Visual**.

   1. Dalam diagram alur kerja, pilih AWS CDK tindakan Anda.

   1. Pilih tab **Input**.

   1. Tambahkan dua variabel dengan properti berikut:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Anda sekarang memiliki dua variabel yang berisi referensi ke rahasia.

   File definisi alur kerja Anda kode YAMB akan terlihat mirip dengan berikut ini:
**catatan**  
Contoh kode berikut berasal dari tindakan **AWS CDK bootstrap**; tindakan **AWS CDK penerapan** akan terlihat serupa.

   ```
   Name: CDK_Bootstrap_Action
   SchemaVersion: 1.0
   Actions:
     CDKBootstrapAction:
       Identifier: aws/cdk-bootstrap@v2
       Inputs:
         Variables:
           - Name: NPMUSER
             Value: ${Secrets.npmUsername}
           - Name: NPMTOKEN
             Value: ${Secrets.npmAuthToken}
         Sources:
           - WorkflowSource
       Environment:
         Name: Dev2
         Connections:
           - Name: account-connection
             Role: codecatalystAdmin
       Configuration:
         Parameters:
           Region: "us-east-2"
   ```

   Anda sekarang siap untuk menggunakan `NPMTOKEN` variabel `NPMUSER` dan dalam `cdk.json` file Anda. Pergi ke prosedur selanjutnya.

**Untuk memperbarui file cdk.json Anda**

1. Ubah ke direktori root AWS CDK proyek Anda, dan buka `cdk.json` file.

1. Temukan `"app":` properti, dan ubah untuk menyertakan kode yang ditunjukkan di*red italics*:
**catatan**  
Contoh kode berikut adalah dari sebuah TypeScript proyek. Jika Anda menggunakan JavaScript proyek, kode akan terlihat serupa meskipun tidak identik.

   ```
   {
     "app": "npm set registry=https://your-registry/folder/CDK-package/ --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:always-auth=true --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:_authToken=\"${NPMUSER}\":\"${NPMTOKEN}\" && npm install  && npx ts-node --prefer-ts-exts bin/hello-cdk.ts|js",
     "watch": {
       "include": [
         "**"
       ],
       "exclude": [
         "README.md",
         "cdk*.json",
         "**/*.d.ts",
         "**/*.js",
         "tsconfig.json",
         "package*.json",
   ...
   ```

1. Dalam kode yang disorot*red italics*, ganti:
   + *your-registry/folder/CDK-package/*dengan jalur ke dependensi AWS CDK proyek Anda di registri pribadi Anda.
   + *hello-cdk.ts\$1.js*dengan nama file entrypoint Anda. Ini mungkin file `.ts` (TypeScript) atau `.js` (JavaScript) tergantung pada bahasa yang Anda gunakan.
**catatan**  
Tindakan akan mengganti *NPMTOKEN* variabel *NPMUSER* dan dengan nama pengguna npm dan token akses yang Anda tentukan di **Rahasia**.

1. Simpan `cdk.json` file Anda.

1. Jalankan kembali tindakan secara manual untuk melihat apakah perubahan memperbaiki kesalahan. Untuk informasi selengkapnya tentang menjalankan tindakan secara manual, lihat[Memulai proses alur kerja secara manual](workflows-manually-start.md).

## Mengapa beberapa alur kerja memiliki nama yang sama?
<a name="troubleshooting-workflows-name"></a>



Alur kerja disimpan per cabang per repositori. Dua alur kerja yang berbeda dapat memiliki nama yang sama jika ada di cabang yang berbeda. Di halaman Alur Kerja, Anda dapat membedakan alur kerja dengan nama yang sama dengan melihat nama cabang. Untuk informasi selengkapnya, lihat [Mengatur kode sumber Anda bekerja dengan cabang di Amazon CodeCatalyst](source-branches.md).

![\[Cabang alur kerja\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/workflow-branch.png)


## Dapatkah saya menyimpan file definisi alur kerja saya di folder lain?
<a name="troubleshooting-workflows-folder"></a>

Tidak, Anda harus menyimpan semua file definisi alur kerja di `.codecatalyst/workflows` folder, atau di subfolder folder itu. Jika Anda menggunakan repo mono dengan beberapa proyek logis, letakkan semua file definisi alur kerja Anda di `.codecatalyst/workflows` folder atau salah satu subfoldernya, lalu gunakan bidang **File yang diubah** (editor visual) atau `FilesChanged` properti (editor YAMAL) di dalam pemicu untuk memicu alur kerja secara otomatis di jalur proyek yang ditentukan. Untuk informasi selengkapnya, lihat [Menambahkan pemicu ke alur kerja](workflows-add-trigger-add.md) dan [Contoh: Pemicu dengan dorongan, cabang, dan file](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).

## Bagaimana cara menambahkan tindakan secara berurutan ke alur kerja saya?
<a name="troubleshooting-workflows-visual"></a>

Secara default, ketika Anda menambahkan tindakan ke alur kerja Anda, itu tidak akan memiliki dependensi dan akan berjalan secara paralel dengan tindakan lain.

Jika Anda ingin mengatur tindakan secara berurutan, Anda dapat mengatur ketergantungan pada tindakan lain dengan mengatur `DependsOn` bidang. Anda juga dapat mengonfigurasi tindakan untuk mengkonsumsi artefak atau variabel yang merupakan output dari tindakan lain. Untuk informasi selengkapnya, lihat [Tindakan pengurutan](workflows-depends-on.md).

## Mengapa alur kerja saya berhasil memvalidasi tetapi gagal saat runtime?
<a name="troubleshooting-workflows-validation"></a>

Jika Anda memvalidasi alur kerja Anda menggunakan `Validate` tombol, tetapi alur kerja Anda tetap gagal, itu mungkin karena batasan dalam validator.

Kesalahan apa pun yang mengacu pada CodeCatalyst sumber daya seperti rahasia, lingkungan, atau armada dalam konfigurasi alur kerja tidak akan didaftarkan selama komit. Jika referensi yang tidak valid digunakan, kesalahan hanya akan diidentifikasi ketika alur kerja dijalankan. Demikian pula, jika ada kesalahan dalam konfigurasi tindakan Anda seperti kehilangan bidang wajib atau kesalahan ketik dalam atribut tindakan, mereka akan diidentifikasi hanya ketika alur kerja dijalankan. Untuk informasi selengkapnya, lihat [Membuat alur kerja](workflows-create-workflow.md).

## Penemuan otomatis tidak menemukan laporan apa pun untuk tindakan saya
<a name="troubleshooting-reports-auto-discovery"></a>

**Masalah:** Saya mengonfigurasi penemuan otomatis untuk tindakan yang menjalankan pengujian, tetapi tidak ada laporan yang ditemukan oleh CodeCatalyst.

**Kemungkinan perbaikan:** Ini mungkin disebabkan oleh sejumlah masalah. Coba satu atau lebih solusi berikut:
+ Pastikan bahwa alat yang digunakan untuk menjalankan tes menghasilkan output dalam salah satu format yang CodeCatalyst mengerti. Misalnya, jika Anda ingin mengizinkan `pytest` CodeCatalyst untuk menemukan laporan pengujian dan cakupan kode, sertakan argumen berikut:

  ```
  --junitxml=test_results.xml --cov-report xml:test_coverage.xml
  ```

  Untuk informasi selengkapnya, lihat [Jenis laporan kualitas](test-workflow-actions.md#test-reporting).
+ Pastikan ekstensi file untuk output konsisten dengan format yang dipilih. Misalnya, saat mengonfigurasi `pytest` untuk menghasilkan hasil dalam `JUnitXML` format, periksa apakah ekstensi file tersebut. `.xml` Untuk informasi selengkapnya, lihat [Jenis laporan kualitas](test-workflow-actions.md#test-reporting).
+ Pastikan bahwa `IncludePaths` dikonfigurasi untuk menyertakan seluruh sistem file (`**/*`) kecuali Anda sengaja mengecualikan folder tertentu. Demikian pula, pastikan bahwa `ExcludePaths` tidak mengecualikan direktori di mana Anda mengharapkan laporan Anda berada.
+ Jika Anda mengonfigurasi laporan secara manual untuk menggunakan file keluaran tertentu, laporan tersebut akan dikecualikan dari penemuan otomatis. Untuk informasi selengkapnya, lihat [Contoh laporan kualitas YAMAL](test-config-action.md#test.success-criteria-example).
+ Penemuan otomatis mungkin tidak menemukan laporan karena tindakan gagal sebelum keluaran apa pun dihasilkan. Misalnya, build mungkin gagal sebelum pengujian unit apa pun dijalankan.

## Tindakan saya gagal pada laporan yang ditemukan secara otomatis setelah saya mengonfigurasi kriteria keberhasilan
<a name="troubleshooting-success-auto-discovery"></a>

**Masalah:** Saat saya mengaktifkan penemuan otomatis dan mengonfigurasi kriteria keberhasilan, beberapa laporan tidak memenuhi kriteria keberhasilan dan akibatnya tindakan gagal.

**Kemungkinan perbaikan:** Untuk mengatasi ini, coba satu atau beberapa solusi berikut:
+ Ubah `IncludePaths` atau `ExcludePaths` untuk mengecualikan laporan yang tidak Anda minati.
+ Perbarui kriteria keberhasilan untuk memungkinkan semua laporan lulus. Misalnya, jika dua laporan ditemukan dengan satu memiliki cakupan garis 50% dan satu lagi 70%, sesuaikan cakupan garis minimum menjadi 50%. Untuk informasi selengkapnya, lihat [Kriteria keberhasilan](test-best-practices.md#test.best-success-criteria)
+ Ubah laporan yang gagal menjadi laporan yang dikonfigurasi secara manual. Ini memungkinkan Anda mengonfigurasi kriteria keberhasilan yang berbeda untuk laporan spesifik tersebut. Untuk informasi selengkapnya, lihat [Mengkonfigurasi kriteria keberhasilan untuk laporan](test-config-action.md#test.success-criteria).

## Penemuan otomatis menghasilkan laporan yang tidak saya inginkan
<a name="troubleshooting-unwanted-auto-discovery"></a>

**Masalah:** Ketika saya mengaktifkan penemuan otomatis, itu menghasilkan laporan yang tidak saya inginkan. Misalnya, CodeCatalyst menghasilkan laporan cakupan kode untuk file yang disertakan dalam dependensi aplikasi saya yang disimpan di. `node_modules`

**Kemungkinan perbaikan:** Anda dapat menyesuaikan `ExcludePaths` konfigurasi untuk mengecualikan file yang tidak diinginkan. Misalnya, untuk mengecualikan`node_modules`, tambahkan`node_modules/**/*`. Untuk informasi selengkapnya, lihat [Sertakan/kecualikan jalur](test-best-practices.md#test.best-include-exclude).

## Penemuan otomatis menghasilkan banyak laporan kecil untuk satu kerangka pengujian
<a name="troubleshooting-reports-combined"></a>

**Masalah:** Ketika saya menggunakan kerangka kerja pelaporan pengujian dan cakupan kode tertentu, saya perhatikan bahwa penemuan otomatis menghasilkan sejumlah besar laporan. Misalnya, saat menggunakan [Plugin Maven Surefire](https://maven.apache.org/surefire/maven-surefire-plugin/), penemuan otomatis menghasilkan laporan yang berbeda untuk setiap kelas pengujian. 

**Kemungkinan perbaikan:** Kerangka kerja Anda mungkin dapat menggabungkan output ke dalam satu file. Misalnya, jika Anda menggunakan Plugin Maven Surefire, Anda dapat menggunakan `npx junit-merge` untuk menggabungkan file secara manual. Ekspresi lengkapnya mungkin terlihat seperti ini:

```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```

## Alur kerja yang tercantum di bawah CI/CD tidak cocok dengan yang ada di repositori sumber
<a name="troubleshooting-workflow-source"></a>

**Masalah:** [Alur kerja yang ditampilkan pada **CI/CD**, halaman **Alur kerja** tidak cocok dengan yang ada di `~/.codecatalyst/workflows/` folder di repositori sumber Anda.](source.md) Anda mungkin melihat ketidakcocokan berikut:
+ Alur kerja muncul di halaman **Alur Kerja**, tetapi file definisi alur kerja yang sesuai tidak ada di repositori sumber Anda.
+ **File definisi alur kerja ada di repositori sumber Anda, tetapi alur kerja yang sesuai tidak muncul di halaman Alur Kerja.**
+ Alur kerja ada di repositori sumber dan halaman **Alur Kerja**, tetapi keduanya berbeda.

Masalah ini dapat terjadi jika halaman **Alur Kerja** belum sempat menyegarkan, atau jika kuota alur kerja terlampaui.

**Kemungkinan perbaikan:**
+ Tunggu. Anda biasanya harus menunggu dua atau tiga detik setelah komit ke sumber sebelum Anda melihat perubahan pada halaman **Alur Kerja**.
+ Jika Anda telah melampaui kuota alur kerja, lakukan salah satu hal berikut:
**catatan**  
**Untuk menentukan apakah kuota alur kerja terlampaui, tinjau[Kuota untuk alur kerja di CodeCatalyst](workflows-quotas.md), dan periksa silang kuota yang didokumentasikan terhadap alur kerja di repositori sumber Anda atau di halaman Alur Kerja.** Tidak ada pesan kesalahan yang menunjukkan bahwa kuota telah terlampaui, jadi Anda harus menyelidikinya sendiri.
  + Jika Anda telah melampaui **jumlah maksimum alur kerja per kuota ruang**, hapus beberapa alur kerja, lalu lakukan komit pengujian terhadap file definisi alur kerja. Contoh komit pengujian mungkin menambahkan spasi ke file.
  + Jika Anda telah melampaui kuota **ukuran file definisi alur kerja maksimum**, ubah file definisi alur kerja untuk mengurangi panjangnya.
  + Jika Anda telah melampaui **jumlah maksimum file alur kerja yang diproses dalam kuota peristiwa sumber tunggal**, lakukan beberapa komit pengujian. Ubah kurang dari jumlah maksimum alur kerja di setiap komit.

## Saya tidak dapat membuat atau memperbarui alur kerja
<a name="troubleshooting-workflows-branchrules"></a>

**Masalah:** Saya ingin membuat atau memperbarui alur kerja, tetapi saya melihat kesalahan ketika saya mencoba melakukan perubahan.

**Kemungkinan perbaikan:** Bergantung pada peran Anda dalam proyek atau ruang, Anda mungkin tidak memiliki izin untuk mendorong kode ke repositori sumber dalam proyek. File YAMB untuk alur kerja disimpan dalam repositori. Untuk informasi selengkapnya, lihat [File definisi alur kerja](workflows-concepts.md#workflows-concepts-workflows-def). Peran **administrator Space**, peran **administrator Proyek**, dan peran **Kontributor** semuanya memiliki izin untuk melakukan dan mendorong kode ke repositori dalam proyek.

Jika Anda memiliki peran **Kontributor** tetapi tidak dapat membuat atau melakukan perubahan pada alur kerja YAMB di cabang tertentu, mungkin ada aturan cabang yang dikonfigurasi untuk cabang tersebut yang mencegah pengguna dengan peran tersebut mendorong kode ke cabang tertentu. Coba buat alur kerja di cabang yang berbeda, atau komit perubahan Anda ke cabang yang berbeda. Lihat informasi yang lebih lengkap di [Mengelola tindakan yang diizinkan untuk cabang dengan aturan cabang](source-branches-branch-rules.md).

# Memecahkan masalah dengan masalah
<a name="troubleshooting-issues"></a>

Informasi berikut dapat membantu Anda memecahkan masalah umum dengan masalah di. CodeCatalyst

**Topics**
+ [Saya tidak dapat memilih penerima tugas untuk masalah saya](#troubleshooting-issues-assignees)

## Saya tidak dapat memilih penerima tugas untuk masalah saya
<a name="troubleshooting-issues-assignees"></a>

**Masalah:** Saat membuat masalah, daftar penerima tugas kosong.

**Kemungkinan perbaikan:** Daftar penerima tugas secara langsung ditautkan ke CodeCatalyst pengguna yang terdaftar sebagai anggota untuk proyek. Untuk memverifikasi bahwa akses profil pengguna berfungsi dengan baik, pilih ikon profil dan kemudian pilih **Profil pengguna**. Jika informasi profil pengguna tidak terisi, periksa laporan kesehatan untuk setiap insiden. Jika memang terisi, ajukan tiket layanan.

# Memecahkan masalah dengan pencarian di CodeCatalyst
<a name="troubleshooting-search"></a>

Konsultasikan bagian berikut untuk memecahkan masalah yang terkait dengan pencarian di. CodeCatalyst Untuk informasi lebih lanjut tentang alur kerja, lihat [Cari kode, masalah, proyek, dan pengguna di CodeCatalystCari kode, masalah, proyek, dan pengguna](search.md).

**Topics**
+ [Saya tidak dapat menemukan pengguna di proyek saya](#troubleshooting-search-users)
+ [Saya tidak melihat apa yang saya cari di proyek atau ruang saya](#troubleshooting-missing-results)
+ [Jumlah hasil pencarian terus berubah saat saya menavigasi halaman](#troubleshooting-search-results)
+ [Kueri penelusuran saya belum selesai](#troubleshooting-requests-limits)

## Saya tidak dapat menemukan pengguna di proyek saya
<a name="troubleshooting-search-users"></a>

**Masalah:** Ketika saya mencoba melihat detail pengguna, saya tidak melihat informasi mereka di proyek.

**Kemungkinan perbaikan:** Penelusuran saat ini tidak mendukung pencarian pengguna dalam proyek. Untuk mencari pengguna dengan akses ke ruang Anda, alihkan ke **ruang ini** QuickSearch, atau hapus filter proyek apa pun yang mungkin telah Anda tentukan menggunakan bahasa kueri lanjutan.

## Saya tidak melihat apa yang saya cari di proyek atau ruang saya
<a name="troubleshooting-missing-results"></a>

**Masalah:** Hasil tidak muncul ketika saya mencoba mencari informasi tertentu.

**Kemungkinan perbaikan:** Pembaruan konten kemungkinan akan memakan waktu beberapa detik untuk diperbarui di hasil penelusuran. Pembaruan besar dapat memakan waktu beberapa menit.

Untuk sumber daya yang belum diperbarui baru-baru ini, Anda mungkin perlu menyempurnakan pencarian Anda. Anda dapat memperbaiki dengan menambahkan lebih banyak kata kunci atau menggunakan bahasa kueri lanjutan. Untuk informasi selengkapnya tentang menyempurnakan kueri Anda, lihat. [Menyempurnakan permintaan pencarian Anda](search.md#search-query-language-examples)

## Jumlah hasil pencarian terus berubah saat saya menavigasi halaman
<a name="troubleshooting-search-results"></a>

**Masalah:** Jumlah hasil pencarian tampaknya berubah ketika saya pergi ke halaman berikutnya, jadi tidak jelas berapa banyak total hasil yang ada.

**Kemungkinan perbaikan:** Saat menavigasi halaman hasil penelusuran, Anda mungkin melihat perubahan jumlah hasil penelusuran yang cocok dengan kueri Anda. Jumlah hasil mungkin diperbarui untuk mencerminkan jumlah kecocokan yang lebih akurat yang ditemukan saat Anda menavigasi halaman.

Saat Anda menavigasi hasil, Anda mungkin melihat pesan berikut: **Tidak ada hasil untuk “tes”**. Anda akan menerima pesan jika Anda tidak memiliki akses ke hasil yang tersisa.

## Kueri penelusuran saya belum selesai
<a name="troubleshooting-requests-limits"></a>

**Masalah:** Hasil kueri penelusuran saya tidak muncul, dan tampaknya memakan waktu terlalu lama.

**Kemungkinan perbaikan:** Pencarian Anda mungkin tidak selesai ketika ada banyak pencarian yang dilakukan pada saat yang sama di ruang, baik secara terprogram atau karena aktivitas tim yang tinggi. Jika Anda menjalankan pencarian terprogram, jeda atau kurangi. Jika tidak, coba lagi dalam beberapa detik.

# Memecahkan masalah dengan ekstensi
<a name="troubleshooting-extensions"></a>

Konsultasikan bagian berikut untuk memecahkan masalah yang terkait dengan ekstensi di. CodeCatalyst Untuk informasi selengkapnya tentang ekstensi, lihat[Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalystTambahkan fungsionalitas ke proyek dengan ekstensi](extensions.md).

**Topics**
+ [Saya tidak dapat melihat perubahan pada repositori pihak ketiga yang ditautkan atau mencari hasil dari perubahan tersebut](#troubleshooting-detect-3p-changes)

## Saya tidak dapat melihat perubahan pada repositori pihak ketiga yang ditautkan atau mencari hasil dari perubahan tersebut
<a name="troubleshooting-detect-3p-changes"></a>

**Masalah:** Perubahan dalam reposiori pihak ketiga saya tidak muncul di. CodeCatalyst

**Kemungkinan perbaikan:** CodeCatalyst saat ini tidak mendukung pendeteksian perubahan di cabang default untuk repositori tertaut. Untuk mengubah cabang default untuk repositori tertaut, Anda harus terlebih dahulu memutuskan tautannya CodeCatalyst, mengubah cabang default, dan kemudian menautkannya lagi. Lihat informasi yang lebih lengkap di [Menautkan GitHub repositori, repositori Bitbucket, repositori GitLab proyek, dan proyek Jira di CodeCatalyst](extensions-link.md).

# Memecahkan masalah dengan akun yang terkait dengan ruang Anda
<a name="troubleshooting-connections"></a>

Di CodeCatalyst, Anda dapat menambahkan Akun AWS ke ruang Anda untuk memberikan izin ke sumber daya dan untuk tujuan penagihan. Informasi berikut dapat membantu Anda memecahkan masalah umum dengan akun terkait di. CodeCatalyst

**Topics**
+ [Permintaan Akun AWS koneksi saya menerima kesalahan token yang tidak valid](#troubleshooting-connection-token)
+ [Alur kerja CodeCatalyst proyek Amazon saya gagal dengan kesalahan untuk akun, lingkungan, atau peran IAM yang dikonfigurasi](#connections-troubleshoot-workflow)
+ [Saya memerlukan akun, peran, dan lingkungan terkait untuk membuat proyek](#connections-troubleshoot-environment)
+ [Saya tidak dapat mengakses halaman Amazon CodeCatalyst Spaces di Konsol Manajemen AWS](#connections-troubleshoot-console)
+ [Saya ingin akun yang berbeda sebagai akun penagihan saya](#connections-troubleshoot-billing)
+ [Alur kerja proyek saya gagal dengan kesalahan nama koneksi](#connections-troubleshoot-restriction)

## Permintaan Akun AWS koneksi saya menerima kesalahan token yang tidak valid
<a name="troubleshooting-connection-token"></a>

**Masalah:** Saat membuat permintaan koneksi dengan token koneksi, halaman tidak menerima token dan menunjukkan kesalahan yang menyatakan bahwa token tidak valid.

**Kemungkinan perbaikan:** Pastikan Anda memberikan ID akun yang ingin Anda tambahkan ke ruang Anda. Anda harus memiliki izin administratif untuk Anda Akun AWS atau dapat bekerja dengan administrator Anda untuk menambahkan akun.

Ketika Anda memilih untuk memverifikasi akun, jendela browser baru akan terbuka di Konsol Manajemen AWS. Akun yang sama diperlukan untuk masuk di sisi konsol. Coba lagi setelah memverifikasi hal berikut:
+ Anda masuk ke Konsol Manajemen AWS dengan yang sama Akun AWS yang ingin Anda tambahkan ke ruang Anda.
+ Anda masuk ke Konsol Manajemen AWS dengan Wilayah diatur ke Wilayah yang benar untuk ruang Anda.
+ Jika Anda telah tiba dari halaman penagihan dan ingin menambahkan Akun AWS sebagai akun penagihan yang ditentukan untuk ruang Anda, pastikan akun tersebut belum mencapai kuota sebagai akun penagihan untuk spasi atau spasi lain.

## Alur kerja CodeCatalyst proyek Amazon saya gagal dengan kesalahan untuk akun, lingkungan, atau peran IAM yang dikonfigurasi
<a name="connections-troubleshoot-workflow"></a>

**Masalah:** Saat alur kerja berjalan dan tidak menemukan akun yang dikonfigurasi atau peran IAM yang terkait dengan ruang Anda, Anda harus mengisi bidang peran, koneksi, dan lingkungan secara manual di alur kerja YAMB. Lihat tindakan alur kerja yang gagal, dan perhatikan apakah pesan galatnya adalah sebagai berikut: 
+ Peran ini tidak tersedia untuk digunakan dengan koneksi yang terkait dengan lingkungan.
+ Tindakan tidak berhasil. Status: GAGAL; Nilai yang diberikan untuk koneksi akun atau lingkungan tidak valid. Verifikasi koneksi terkait dengan ruang Anda dan lingkungan terkait dengan proyek Anda.
+ Tindakan tidak berhasil. Status: GAGAL; Nilai yang diberikan untuk peran IAM tidak valid. Verifikasi nama ada, peran IAM ditambahkan ke koneksi akun Anda, dan koneksi sudah dikaitkan dengan ruang Amazon CodeCatalyst Anda

**Kemungkinan perbaikan:** [Pastikan bahwa alur kerja bidang YAMAL memiliki nilai yang akurat untuk [Lingkungan](build-action-ref.md#build.environment), [Koneksi](build-action-ref.md#build.environment.connections), dan Peran.](build-action-ref.md#build.environment.connections.role) Tindakan CodeCatalyst alur kerja yang memerlukan lingkungan adalah membangun atau menyebarkan tindakan yang menjalankan AWS sumber daya atau yang menghasilkan tumpukan AWS sumber daya.

Pilih blok tindakan alur kerja yang gagal dan kemudian pilih **Visual**. Pilih tab **Konfigurasi**. Jika bidang **Environment**, **Connection name****, dan Role name** tidak diisi, maka Anda perlu memperbarui alur kerja secara manual. Gunakan langkah-langkah berikut untuk mengedit alur kerja YALL Anda:
+ Perluas `/.codecatalyst` direktori, lalu perluas `/workflows` direktori. Buka file Yaml alur kerja. Pastikan bahwa peran IAM dan informasi akun ditentukan dalam YAMAL yang telah Anda konfigurasikan untuk alur kerja Anda. Contoh: 

  ```
  Actions:
    cdk_bootstrap:
      Identifier: action-@v1
      Inputs:
        Sources:
          - WorkflowSource
      Environment:
        Name: Staging
        Connections:
          - Name: account-connection
            Role: build-role
  ```

  Properti **Lingkungan, Koneksi, dan Peran** diperlukan untuk menjalankan tindakan pembuatan dan penerapan CodeCatalyst alur kerja dengan AWS sumber daya. Sebagai contoh, lihat parameter YAMAL referensi tindakan CodeCatalyst build untuk [Lingkungan](build-action-ref.md#build.environment), [Koneksi](build-action-ref.md#build.environment.connections), dan [Peran](build-action-ref.md#build.environment.connections.role).
+ Pastikan ruang Anda memiliki akun yang ditambahkan ke dalamnya, dan pastikan akun tersebut memiliki peran atau peran IAM yang sesuai yang ditambahkan ke akun. Anda dapat menyesuaikan atau menambahkan akun jika Anda memiliki peran **administrator Space**. Untuk informasi selengkapnya, lihat [Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).

## Saya memerlukan akun, peran, dan lingkungan terkait untuk membuat proyek
<a name="connections-troubleshoot-environment"></a>

**Masalah:** Dalam opsi pembuatan proyek, proyek saya tidak memiliki akun tambahan yang tersedia di ruang saya, atau saya memerlukan akun lain yang ditambahkan ke ruang saya untuk digunakan proyek saya.

**Kemungkinan perbaikan:** Untuk ruang Anda, Anda dapat menambahkan otorisasi Akun AWS untuk menambahkannya ke proyek Anda jika Anda memiliki peran **administrator Space**. Anda juga harus memiliki Akun AWS tempat Anda memiliki izin administratif atau dapat bekerja dengan AWS administrator Anda.

Untuk memastikan akun dan peran akan tersedia di layar pembuatan proyek, Anda harus terlebih dahulu menambahkan akun dan peran. Untuk informasi selengkapnya, lihat [Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).

Anda memiliki opsi untuk memilih membuat peran layanan dengan kebijakan peran yang disebut kebijakan **CodeCatalystWorkflowDevelopmentRole-*spaceName***peran. Peran akan memiliki nama `CodeCatalystWorkflowDevelopmentRole-spaceName` dengan pengenal unik ditambahkan. Untuk informasi selengkapnya tentang kebijakan peran dan peran, lihat[Memahami peran **CodeCatalystWorkflowDevelopmentRole-*spaceName***layanan](ipa-iam-roles.md#ipa-iam-roles-service-role). Untuk langkah-langkah untuk membuat peran, lihat[Membuat **CodeCatalystWorkflowDevelopmentRole-*spaceName***peran untuk akun dan ruang Anda](ipa-iam-roles.md#ipa-iam-roles-service-create). Peran ditambahkan ke akun Anda dan tersedia di halaman pembuatan proyek di CodeCatalyst.

## Saya tidak dapat mengakses halaman Amazon CodeCatalyst Spaces di Konsol Manajemen AWS
<a name="connections-troubleshoot-console"></a>

**Masalah:** Ketika saya mencoba mengakses CodeCatalyst halaman Amazon di Konsol Manajemen AWS untuk menambahkan akun ke CodeCatalyst ruang saya atau menambahkan peran ke akun AWS, saya menerima kesalahan izin.

**Kemungkinan perbaikan:**

Untuk ruang Anda, Anda dapat menambahkan otorisasi Akun AWS untuk menambahkannya ke proyek Anda jika Anda memiliki peran **administrator Space**. Anda juga harus memiliki Akun AWS tempat Anda memiliki izin administratif atau dapat bekerja dengan AWS administrator Anda. Anda harus terlebih dahulu memastikan Anda masuk Konsol Manajemen AWS dengan akun yang sama yang ingin Anda kelola. Setelah Anda masuk ke Konsol Manajemen AWS, Anda dapat membuka konsol dan mencoba lagi.

Buka CodeCatalyst halaman Amazon Konsol Manajemen AWS di [https://us-west-2.console.aws.amazon.com/codecatalyst/rumah? wilayah=us-barat-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).

## Saya ingin akun yang berbeda sebagai akun penagihan saya
<a name="connections-troubleshoot-billing"></a>

**Masalah:** Ketika saya mengatur CodeCatalyst login saya, saya menyelesaikan beberapa langkah untuk mengatur ruang saya dan mengaitkan yang berwenang Akun AWS. Sekarang, saya ingin mengotorisasi akun lain untuk penagihan.

**Kemungkinan perbaikan:** Untuk ruang Anda, Anda dapat mengotorisasi akun penagihan jika Anda memiliki peran administrator **Space**. Anda juga harus memiliki Akun AWS tempat Anda memiliki izin administratif atau dapat bekerja dengan AWS administrator Anda.

Untuk informasi selengkapnya, lihat [Mengelola penagihan](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) di Panduan CodeCatalyst Administrator Amazon.

## Alur kerja proyek saya gagal dengan kesalahan nama koneksi
<a name="connections-troubleshoot-restriction"></a>

**Masalah:** Saat membuat proyek dan kemudian menjalankan alur kerja proyek, alur kerja gagal dan menunjukkan kesalahan yang menyatakan bahwa nama koneksi tidak valid, sebagai berikut:

Gagal di: Nama koneksi tidak valid. <action\$1name>

**Kemungkinan perbaikan:** Pastikan Anda memberikan ID akun yang ingin Anda tambahkan ke ruang Anda, dan pastikan akun tersebut tidak diaktifkan untuk koneksi akun yang dibatasi proyek. Jika akun diaktifkan untuk koneksi akun yang dibatasi proyek, Anda mungkin perlu memperbarui koneksi akun dengan mengaktifkan akses ke proyek baru. Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi akun yang dibatasi proyek](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).

# Memecahkan masalah antara Amazon CodeCatalyst dan atau AWS SDKs AWS CLI
<a name="troubleshooting-cli-sdk"></a>

Informasi berikut dapat membantu Anda memecahkan masalah umum saat bekerja dengan CodeCatalyst dan AWS CLI atau. AWS SDKs

**Topics**
+ [Saya menerima kesalahan ketika saya masuk **aws codecatalyst** di baris perintah atau terminal yang mengatakan itu adalah pilihan yang tidak valid](#cli-sdk-troubleshoot-no-commands)
+ [Saya menerima kesalahan kredensial ketika saya menjalankan perintah **aws codecatalyst**](#cli-sdk-troubleshoot-profile)

## Saya menerima kesalahan ketika saya masuk **aws codecatalyst** di baris perintah atau terminal yang mengatakan itu adalah pilihan yang tidak valid
<a name="cli-sdk-troubleshoot-no-commands"></a>

**Masalah:** Ketika saya mencoba menggunakan AWS CLI with CodeCatalyst, satu atau lebih **aws codecatalyst** perintah tidak diakui sebagai valid.

**Solusi:** Penyebab paling umum untuk masalah ini adalah Anda menggunakan versi AWS CLI yang tidak berisi pembaruan terbaru untuk layanan dan perintah terbaru. Perbarui instalasi Anda AWS CLI dan kemudian coba lagi. Untuk informasi selengkapnya, lihat [Menyiapkan untuk menggunakan AWS CLI dengan CodeCatalyst](set-up-cli.md).

## Saya menerima kesalahan kredensial ketika saya menjalankan perintah **aws codecatalyst**
<a name="cli-sdk-troubleshoot-profile"></a>

**Masalah:** Ketika saya mencoba menggunakan AWS CLI with CodeCatalyst, saya menerima pesan yang menyatakan `You can configure credentials by running "aws configure".` atau`Unable to locate authorization token`.

**Solusi:** Anda harus mengkonfigurasi AWS CLI profil untuk bekerja dengan CodeCatalyst perintah. Untuk informasi selengkapnya, lihat [Menyiapkan untuk menggunakan AWS CLI dengan CodeCatalyst](set-up-cli.md).