Pemecahan masalah AWS CodeStar

Informasi berikut dapat membantu Anda memecahkan masalah umum di AWS CodeStar.

Kegagalan pembuatan proyek: Sebuah proyek tidak dibuat

Masalah: Saat Anda mencoba membuat proyek, Anda melihat pesan yang mengatakan pembuatannya gagal.

Kemungkinan perbaikan: Alasan paling umum untuk kegagalan adalah:

• Proyek dengan ID tersebut sudah ada di AWS akun Anda, mungkin di AWS Wilayah yang berbeda.

• Pengguna IAM yang Anda gunakan untuk masuk ke AWS Management Console tidak memiliki izin yang diperlukan untuk membuat proyek.

• Peran AWS CodeStar layanan tidak memiliki satu atau lebih izin yang diperlukan.

• Anda telah mencapai batas maksimum untuk satu atau beberapa sumber daya untuk suatu proyek (seperti batas kebijakan yang dikelola pelanggan di IAM, bucket Amazon S3, atau pipeline in). CodePipeline

Sebelum Anda membuat proyek, verifikasi bahwa Anda memiliki AWSCodeStarFullAccess kebijakan yang diterapkan ke pengguna IAM Anda. Untuk informasi selengkapnya, lihat AWSCodeStarFullAccess Kebijakan.

Saat Anda membuat proyek, pastikan ID tersebut unik dan memenuhi AWS CodeStar persyaratan. Pastikan Anda memilih kotak centang izin AWS CodeStar yang diinginkan untuk mengelola AWS sumber daya atas nama Anda.

Untuk memecahkan masalah lain, buka AWS CloudFormation konsol, pilih tumpukan untuk proyek yang Anda coba buat, dan pilih tab Acara. Mungkin ada lebih dari satu tumpukan untuk sebuah proyek. Nama tumpukan dimulai dengan awscodestar- dan diikuti oleh ID proyek. Tumpukan mungkin berada di bawah tampilan filter Dihapus. Tinjau pesan kegagalan apa pun dalam peristiwa tumpukan dan perbaiki masalah yang tercantum sebagai penyebab kegagalan tersebut.

Pembuatan proyek: Saya melihat kesalahan ketika saya mencoba mengedit konfigurasi Amazon EC2 saat membuat proyek

Masalah: Saat Anda mengedit opsi konfigurasi Amazon EC2 selama pembuatan proyek, Anda akan melihat pesan kesalahan atau opsi abu-abu, dan tidak dapat melanjutkan pembuatan proyek.

Kemungkinan perbaikan: Alasan paling umum untuk pesan kesalahan adalah:

• VPC dalam template AWS CodeStar proyek (baik VPC default atau yang digunakan saat konfigurasi Amazon EC2 diedit) memiliki penyewaan instans khusus, dan jenis instans tidak didukung untuk instans khusus. Pilih jenis instans yang berbeda atau VPC Amazon yang berbeda.

• AWS Akun Anda tidak memiliki VPC Amazon. Anda mungkin telah menghapus VPC default dan tidak membuat yang lain. Buka konsol VPC Amazon di https://console.aws.amazon.com/vpc/, pilih VPC Anda, dan pastikan Anda memiliki setidaknya satu VPC yang dikonfigurasi. Jika tidak, buat satu. Untuk informasi selengkapnya, lihat Ikhtisar Amazon Virtual Private Cloud di Panduan Memulai Amazon VPC.

• VPC Amazon tidak memiliki subnet apa pun. Pilih VPC yang berbeda atau buat subnet untuk VPC. Untuk informasi selengkapnya, lihat Dasar-Dasar VPC dan Subnet.

Penghapusan proyek: Sebuah AWS CodeStar proyek telah dihapus, tetapi sumber daya masih ada

Masalah: Sebuah AWS CodeStar proyek telah dihapus, tetapi sumber daya yang dibuat untuk proyek itu masih ada. Secara default, AWS CodeStar menghapus sumber daya proyek saat proyek dihapus. Beberapa sumber daya, seperti bucket Amazon S3, tetap dipertahankan meskipun pengguna memilih kotak centang Hapus sumber daya, karena bucket mungkin berisi data.

Kemungkinan perbaikan: Buka AWS CloudFormation konsol dan temukan satu atau lebih AWS CloudFormation tumpukan yang digunakan untuk membuat proyek. Nama tumpukan dimulai dengan awscodestar- dan diikuti oleh ID proyek. Tumpukan mungkin berada di bawah tampilan filter Dihapus. Tinjau peristiwa yang terkait dengan tumpukan untuk menemukan sumber daya yang dibuat untuk proyek. Buka konsol untuk masing-masing sumber daya tersebut di AWS Wilayah tempat Anda membuat AWS CodeStar proyek, lalu hapus sumber daya secara manual.

Sumber daya proyek yang mungkin tersisa meliputi:

• Satu atau lebih ember proyek di Amazon S3. Tidak seperti sumber daya proyek lainnya, bucket proyek di Amazon S3 tidak dihapus ketika kotak centang Hapus sumber daya AWS terkait bersama AWS CodeStar dengan proyek dipilih.

  Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

• Repositori sumber untuk proyek Anda di. CodeCommit

  Buka CodeCommit konsol di https://console.aws.amazon.com/codecommit/.

• Pipeline untuk proyek Anda di CodePipeline.

  Buka CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.

• Aplikasi dan grup penyebaran terkait di CodeDeploy.

  Buka CodeDeploy konsol di https://console.aws.amazon.com/codedeploy/.

• Aplikasi dan lingkungan terkait di AWS Elastic Beanstalk.

  Buka konsol Elastic Beanstalk di https://console.aws.amazon.com/elasticbeanstalk/.

• Sebuah fungsi di AWS Lambda.

  Buka AWS Lambda konsol di https://console.aws.amazon.com/lambda/.

• Satu atau beberapa API di API Gateway.

  Buka konsol API Gateway di https://console.aws.amazon.com/apigateway/.

• Satu atau lebih kebijakan atau peran IAM dalam IAM.

  Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.

• Sebuah instance di Amazon EC2.

  Buka konsol Amazon EC2 di https://console.aws.amazon.com/ec2/.

• Satu atau lebih lingkungan pengembangan di AWS Cloud9

  Untuk melihat, mengakses, dan mengelola lingkungan pengembangan, buka AWS Cloud9 konsol di https://console.aws.amazon.com/cloud9/.

Jika proyek Anda menggunakan sumber daya di luar AWS (misalnya, GitHub repositori atau masalah di Atlassian JIRA), sumber daya tersebut tidak akan dihapus, meskipun kotak Hapus AWS sumber daya terkait bersama dengan CodeStar proyek dipilih.

Kegagalan manajemen tim: Pengguna IAM tidak dapat ditambahkan ke tim dalam proyek AWS CodeStar

Masalah: Saat Anda mencoba menambahkan pengguna ke proyek, Anda melihat pesan kesalahan yang mengatakan bahwa penambahan gagal.

Kemungkinan perbaikan: Alasan paling umum untuk kesalahan ini adalah bahwa pengguna telah mencapai batas kebijakan terkelola yang dapat diterapkan ke pengguna di IAM. Anda mungkin juga menerima kesalahan ini jika Anda tidak memiliki peran pemilik dalam AWS CodeStar proyek tempat Anda mencoba menambahkan pengguna, atau jika pengguna IAM tidak ada atau telah dihapus.

Pastikan Anda masuk sebagai pengguna yang merupakan pemilik AWS CodeStar proyek tersebut. Untuk informasi selengkapnya, lihat Menambahkan Anggota Tim ke AWS CodeStar Proyek .

Untuk memecahkan masalah lain, buka konsol IAM, pilih pengguna yang Anda coba tambahkan, dan periksa berapa banyak kebijakan terkelola yang diterapkan pada pengguna IAM tersebut.

Untuk informasi selengkapnya, lihat Batasan pada Entitas dan Objek IAM. Untuk batas yang dapat diubah, lihat Batas AWS Layanan.

Kegagalan akses: Pengguna federasi tidak dapat mengakses proyek AWS CodeStar

Masalah: Pengguna federasi tidak dapat melihat proyek di AWS CodeStar konsol.

Kemungkinan perbaikan: Jika Anda masuk sebagai pengguna federasi, pastikan Anda memiliki kebijakan terkelola yang sesuai yang dilampirkan pada peran yang Anda anggap untuk masuk. Untuk informasi selengkapnya, lihat Lampirkan Kebijakan Terkelola AWS CodeStar Pemirsa/Kontributor/Pemilik Proyek Anda ke Peran Pengguna Federasi.

Tambahkan pengguna federasi ke AWS Cloud9 lingkungan Anda dengan melampirkan kebijakan secara manual. Lihat Melampirkan Kebijakan AWS Cloud9 Terkelola ke Peran Pengguna Federasi.

Kegagalan akses: Pengguna federasi tidak dapat mengakses atau membuat lingkungan AWS Cloud9

Masalah: Pengguna federasi tidak dapat melihat atau membuat AWS Cloud9 lingkungan di AWS Cloud9 konsol.

Kemungkinan perbaikan: Jika Anda masuk sebagai pengguna federasi, pastikan Anda memiliki kebijakan terkelola yang sesuai yang dilampirkan ke peran pengguna federasi.

Anda menambahkan pengguna federasi ke AWS Cloud9 lingkungan Anda dengan melampirkan kebijakan secara manual ke peran pengguna federasi. Lihat Melampirkan Kebijakan AWS Cloud9 Terkelola ke Peran Pengguna Federasi.

Kegagalan akses: Pengguna federasi dapat membuat AWS CodeStar proyek, tetapi tidak dapat melihat sumber daya proyek

Masalah: Pengguna federasi dapat membuat proyek, tetapi tidak dapat melihat sumber daya proyek, seperti pipeline proyek.

Kemungkinan perbaikan: Jika Anda telah melampirkan kebijakan AWSCodeStarFullAccessterkelola, Anda memiliki izin untuk membuat proyek. AWS CodeStar Namun, untuk mengakses semua sumber daya proyek, Anda harus melampirkan kebijakan yang dikelola pemilik.

Setelah AWS CodeStar membuat sumber daya proyek, izin proyek untuk semua sumber daya proyek tersedia dalam kebijakan yang dikelola pemilik, kontributor, dan penampil. Untuk mengakses semua sumber daya, Anda harus melampirkan kebijakan pemilik secara manual ke peran Anda. Lihat Langkah 3: Konfigurasikan Izin IAM Pengguna.

Masalah peran layanan: Peran layanan tidak dapat dibuat

Masalah: Saat Anda mencoba membuat proyek AWS CodeStar, Anda melihat pesan yang meminta Anda untuk membuat peran layanan. Ketika Anda memilih opsi untuk membuatnya, Anda melihat kesalahan.

Kemungkinan perbaikan: Alasan paling umum untuk kesalahan ini adalah Anda masuk AWS dengan akun yang tidak memiliki izin yang cukup untuk membuat peran layanan. Untuk membuat peran AWS CodeStar layanan (aws-codestar-service-role), Anda harus masuk sebagai pengguna administratif atau dengan akun root. Keluar dari konsol, dan masuk dengan pengguna IAM yang menerapkan kebijakan AdministratorAccess terkelola.

Masalah peran layanan: Peran layanan tidak valid atau hilang

Masalah: Saat Anda membuka AWS CodeStar konsol, Anda melihat pesan yang mengatakan peran AWS CodeStar layanan hilang atau tidak valid.

Kemungkinan perbaikan: Alasan paling umum untuk kesalahan ini adalah bahwa pengguna administratif mengedit atau menghapus peran layanan ()aws-codestar-service-role. Jika peran layanan dihapus, Anda diminta untuk membuatnya. Anda harus masuk sebagai pengguna administratif atau dengan akun root untuk membuat peran. Jika peran itu diedit, itu tidak lagi valid. Masuk ke konsol IAM sebagai pengguna administratif, temukan peran layanan dalam daftar peran, dan hapus. Beralih ke AWS CodeStar konsol dan ikuti instruksi untuk membuat peran layanan.

Masalah peran proyek: pemeriksaan status AWS Elastic Beanstalk kesehatan gagal untuk instance dalam suatu AWS CodeStar proyek

Masalah: Jika Anda membuat AWS CodeStar proyek yang mencakup Elastic Beanstalk sebelum 22 September 2017, pemeriksaan status kesehatan Elastic Beanstalk mungkin gagal. Jika Anda belum mengubah konfigurasi Elastic Beanstalk sejak Anda membuat proyek, pemeriksaan status kesehatan gagal dan melaporkan keadaan abu-abu. Meskipun pemeriksaan kesehatan gagal, aplikasi Anda harus tetap berjalan seperti yang diharapkan. Jika Anda mengubah konfigurasi Elastic Beanstalk sejak Anda membuat proyek, pemeriksaan status kesehatan gagal, dan aplikasi Anda mungkin tidak berjalan dengan benar.

Perbaiki: Satu atau lebih peran IAM tidak memiliki pernyataan kebijakan IAM yang diperlukan. Tambahkan kebijakan yang hilang ke peran yang terpengaruh di AWS akun Anda.

1. Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.

   (Jika Anda tidak dapat melakukan ini, lihat administrator AWS akun Anda untuk bantuan.)

2. Di panel navigasi, pilih Peran.

3. Dalam daftar peran, pilih CodeStarWorker- Project-ID -EB, di mana Project-ID adalah ID dari salah satu proyek yang terpengaruh. (Jika Anda tidak dapat dengan mudah menemukan peran dalam daftar, masukkan beberapa atau semua nama peran di kotak Pencarian.)

4. Di tab Izin, pilih Lampirkan Kebijakan.

5. Dalam daftar kebijakan, pilih AWSElasticBeanstalkEnhancedHealthdan AWSElasticBeanstalkService. (Jika Anda tidak dapat dengan mudah menemukan kebijakan dalam daftar, masukkan beberapa atau semua nama kebijakan di kotak pencarian.)

6. Pilih Lampirkan Kebijakan.

7. Ulangi langkah 3 hingga 6 untuk setiap peran yang terpengaruh yang memiliki nama mengikuti pola CodeStarWorker- Project-ID -EB.

Masalah peran proyek: Peran proyek tidak valid atau hilang

Masalah: Saat Anda mencoba menambahkan pengguna ke proyek, Anda akan melihat pesan galat yang mengatakan penambahan gagal karena kebijakan untuk peran proyek hilang atau tidak valid.

Kemungkinan perbaikan: Alasan paling umum untuk kesalahan ini adalah bahwa satu atau beberapa kebijakan proyek telah diedit atau dihapus dari IAM. Kebijakan proyek unik untuk AWS CodeStar proyek dan tidak dapat dibuat ulang. Proyek tidak dapat digunakan. Buat proyek di AWS CodeStar, lalu migrasi data ke proyek baru. Kloning kode proyek dari repositori proyek yang tidak dapat digunakan, dan dorong kode itu ke repositori proyek baru. Salin informasi wiki tim dari proyek lama ke proyek baru. Tambahkan pengguna ke proyek baru. Jika Anda yakin telah memigrasikan semua data dan pengaturan, hapus proyek yang tidak dapat digunakan.

Ekstensi proyek: Tidak dapat terhubung ke JIRA

Masalah: Saat Anda menggunakan ekstensi Atlassian JIRA untuk mencoba menghubungkan AWS CodeStar proyek ke instance JIRA, pesan berikut akan ditampilkan: “URL bukan URL JIRA yang valid. Verifikasi bahwa URL sudah benar.”

Kemungkinan perbaikan:

• Pastikan URL JIRA sudah benar, lalu coba sambungkan lagi.

• Instans JIRA yang dihosting sendiri mungkin tidak dapat diakses dari internet publik. Hubungi administrator jaringan Anda untuk memastikan instans JIRA Anda dapat diakses dari internet publik, dan kemudian coba sambungkan lagi.

GitHub: Tidak dapat mengakses riwayat komit, masalah, atau kode repositori

Masalah: Di dasbor untuk proyek yang menyimpan kodenya GitHub, ubin riwayat Komit dan GitHubMasalah menampilkan kesalahan koneksi, atau memilih Buka di GitHub atau Buat masalah di ubin ini menampilkan kesalahan.

Kemungkinan penyebabnya:

• AWS CodeStar Proyek mungkin tidak lagi memiliki akses ke GitHub repositori.

• Repositori mungkin telah dihapus atau diganti namanya. GitHub

AWS CloudFormation: Pembuatan Tumpukan Dikembalikan untuk Izin yang Hilang

Setelah Anda menambahkan sumber daya ke template.yml file, lihat pembaruan AWS CloudFormation tumpukan untuk pesan kesalahan apa pun. Pembaruan tumpukan gagal jika kriteria tertentu tidak terpenuhi (misalnya, ketika izin sumber daya yang diperlukan tidak ada).

catatan

Mulai 2 Mei 2019, kami telah memperbarui kebijakan peran AWS CloudFormation pekerja untuk semua proyek yang ada. Pembaruan ini mengurangi cakupan izin akses yang diberikan ke pipeline proyek Anda untuk meningkatkan keamanan dalam proyek Anda.

Untuk memecahkan masalah, lihat status kegagalan dalam tampilan AWS CodeStar dasbor untuk pipeline proyek Anda.

Selanjutnya, pilih CloudFormationtautan di tahap Deploy pipeline Anda untuk memecahkan masalah kegagalan di konsol. AWS CloudFormation Untuk melihat detail pembuatan tumpukan, perluas daftar Acara untuk proyek Anda dan lihat pesan kegagalan apa pun. Pesan menunjukkan izin mana yang hilang. Perbaiki kebijakan peran AWS CloudFormation pekerja dan kemudian jalankan pipeline Anda lagi.

AWS CloudFormation tidak berwenang untuk melakukan iam: PassRole pada peran eksekusi Lambda

Jika Anda memiliki proyek yang dibuat sebelum 6 Desember 2018 PDT yang membuat fungsi Lambda, Anda mungkin melihat AWS CloudFormation kesalahan seperti ini:

User: arn:aws:sts::id:assumed-role/CodeStarWorker-project-id-CloudFormation/AWSCloudFormation is not authorized to perform: iam:PassRole on resource: arn:aws:iam::id:role/CodeStarWorker-project-id-Lambda (Service: AWSLambdaInternal; Status Code: 403; Error Code: AccessDeniedException; Request ID: id)
            

Kesalahan ini terjadi karena peran AWS CloudFormation pekerja Anda tidak memiliki izin untuk meneruskan peran untuk menyediakan fungsi Lambda baru Anda.

Untuk memperbaiki kesalahan ini, Anda perlu memperbarui kebijakan peran AWS CloudFormation pekerja Anda dengan cuplikan berikut.

{
        "Action":[ "iam:PassRole" ],
        "Resource": [
           "arn:aws:iam::account-id:role/CodeStarWorker-project-id-Lambda",
           ],
        
        "Effect": "Allow"    
}
            

Setelah memperbarui kebijakan, jalankan kembali pipeline Anda.

Atau, Anda dapat menggunakan peran kustom untuk fungsi Lambda Anda dengan menambahkan batas izin ke proyek Anda, seperti yang dijelaskan dalam Tambahkan Batas Izin IAM ke Proyek yang Ada

Tidak dapat membuat koneksi untuk GitHub repositori

Masalah:

Karena koneksi ke GitHub repositori menggunakan AWS Connector for GitHub, Anda memerlukan izin pemilik organisasi atau izin admin ke repositori untuk membuat koneksi.

Kemungkinan perbaikan: Untuk informasi tentang tingkat izin untuk GitHub repositori, lihat https://docs.github.com/en/ free-pro-team @latest /github/ -/setting-up-and-managing-organization. organizations-and-teams permission-levels-for-an