Buat Proyek di AWS CodeStar

Untuk membuat proyek di AWS CodeStar

1. Masuk keAWS Management Console, lalu buka AWS CodeStar konsol di https://console.aws.amazon.com/codestar/.

   Pastikan Anda masuk ke AWS Wilayah tempat Anda ingin membuat proyek dan sumber dayanya. Misalnya, untuk membuat proyek di AS Timur (Ohio), pastikan Anda telah memilih AWS Wilayah itu. Untuk informasi tentang AWS Wilayah yang AWS CodeStar tersedia, lihat Wilayah dan Titik Akhir di Referensi AWS Umum.

2. Pada AWS CodeStarhalaman, pilih Buat proyek.

3. Pada halaman Pilih templat proyek, pilih jenis proyek dari daftar templat AWS CodeStar proyek. Anda dapat menggunakan bilah filter untuk mempersempit pilihan Anda. Misalnya, untuk proyek aplikasi web yang ditulis dalam Node.js untuk digunakan ke instans Amazon EC2, pilih kotak centang aplikasi Web, Node.js, dan Amazon EC2. Kemudian pilih dari templat yang tersedia untuk kumpulan opsi itu.

   Untuk informasi selengkapnya, lihat AWS CodeStarTemplate Proyek.

4. Pilih Next (Berikutnya).

5. Di kolom input teks nama Proyek, masukkan nama untuk proyek, seperti Proyek Pertama Saya. Dalam Project ID, ID untuk proyek berasal dari nama proyek ini, tetapi terbatas pada 15 karakter.

   Misalnya, ID default untuk proyek bernama My First Project adalah my-first-projec. ID proyek ini adalah dasar untuk nama-nama semua sumber daya yang terkait dengan proyek. AWS CodeStarmenggunakan ID proyek ini sebagai bagian dari URL untuk repositori kode Anda dan untuk nama peran dan kebijakan akses keamanan terkait di IAM. Setelah proyek dibuat, ID proyek tidak dapat diubah. Untuk mengedit ID proyek sebelum Anda membuat proyek, di Project ID, masukkan ID yang ingin Anda gunakan.

   Untuk informasi tentang batasan nama proyek dan ID proyek, lihatBatas di AWS CodeStar.

   catatan

   ID Proyek harus unik untuk AWS akun Anda di AWS Wilayah.

6. Pilih penyedia repositori, AWS CodeCommitatau. GitHub

7. Jika Anda memilih AWS CodeCommit, untuk nama Repositori, terima nama AWS CodeCommit repositori default, atau masukkan yang lain. Kemudian lompat ke depan ke langkah 9.

8. Jika Anda memilih GitHub, Anda harus memilih atau membuat sumber daya koneksi. Jika Anda memiliki koneksi yang ada, pilih di bidang pencarian. Jika tidak, buat koneksi baru sekarang. Pilih Connect to GitHub.

   Halaman Buat koneksi ditampilkan.

   catatan

   Untuk membuat koneksi, Anda harus memiliki GitHub akun. Jika Anda membuat koneksi untuk suatu organisasi, Anda harus menjadi pemilik organisasi.

   

   1. Di bawah Buat koneksi GitHub Aplikasi, di bidang teks input nama koneksi, masukkan nama untuk koneksi Anda. Pilih Connect to GitHub.

      GitHubHalaman Connect to menampilkan dan menampilkan bidang GitHub Apps.

   2. Di bawah GitHub Aplikasi, pilih penginstalan aplikasi atau pilih Instal aplikasi baru untuk membuatnya.

      catatan

      Anda menginstal satu aplikasi untuk semua koneksi Anda ke penyedia tertentu. Jika Anda telah menginstal AWS Connector for GitHub app, pilih dan lewati langkah ini.

   3. Pada GitHub halaman Install AWS Connector for, pilih akun tempat Anda ingin menginstal aplikasi.

      catatan

      Jika sebelumnya Anda menginstal aplikasi, Anda dapat memilih Konfigurasi untuk melanjutkan ke halaman modifikasi untuk instalasi aplikasi Anda, atau Anda dapat menggunakan tombol kembali untuk kembali ke konsol.

   4. Jika halaman Konfirmasi kata sandi untuk melanjutkan ditampilkan, masukkan GitHub kata sandi Anda, lalu pilih Masuk.

   5. Pada GitHub halaman Install AWS Connector for, pertahankan defaultnya, dan pilih Install.

   6. Pada GitHub halaman Connect to, ID instalasi untuk instalasi baru Anda muncul di bidang input teks GitHub Apps.

      Setelah koneksi dibuat, di halaman CodeStar buat proyek, pesan Siap untuk menghubungkan ditampilkan.

      catatan

      Anda dapat melihat koneksi Anda di bawah Pengaturan di konsol Alat Pengembang. Untuk informasi selengkapnya, lihat Memulai koneksi.

      

   7. Untuk pemilik Repositori, pilih GitHub organisasi atau akun pribadi GitHub Anda.

   8. Untuk nama Repositori, terima nama GitHub repositori default, atau masukkan nama lain.

   9. Pilih Publik atau Pribadi.

      catatan

      Untuk digunakan AWS Cloud9 sebagai lingkungan pengembangan Anda, Anda harus memilih Publik.

   10. (Opsional) Untuk deskripsi Repositori, masukkan deskripsi untuk repositori. GitHub

   catatan

   Jika Anda memilih template proyek Alexa Skill, Anda harus menghubungkan akun pengembang Amazon. Untuk informasi selengkapnya tentang bekerja dengan proyek Alexa Skill, lihatTutorial: Buat Proyek Keterampilan Alexa di AWS CodeStar.

9. Jika project Anda diterapkan ke instans Amazon EC2 dan Anda ingin membuat perubahan, konfigurasikan instans Amazon EC2 Anda di Konfigurasi Amazon EC2. Misalnya, Anda dapat memilih dari jenis instans yang tersedia untuk proyek Anda.

   catatan

   Jenis instans Amazon EC2 yang berbeda memberikan tingkat daya komputasi yang berbeda dan mungkin memiliki biaya terkait yang berbeda. Untuk informasi selengkapnya, lihat Jenis Instans Amazon EC2 dan Harga Amazon EC2.

   Jika Anda memiliki lebih dari satu virtual private cloud (VPC) atau beberapa subnet yang dibuat di Amazon Virtual Private Cloud, Anda juga dapat memilih VPC dan subnet yang akan digunakan. Namun, jika memilih jenis instans Amazon EC2 yang tidak didukung pada instans khusus, Anda tidak dapat memilih VPC yang penyewaan instansnya disetel ke Khusus.

   Untuk informasi selengkapnya, lihat Apa itu Amazon VPC? dan Dasar-dasar Instance Khusus.

   Di Key pair, pilih key pair Amazon EC2 yang Anda buat. Langkah 4: Buat Pasangan Kunci Amazon EC2 untuk Proyek AWS CodeStar Pilih Saya mengakui bahwa saya memiliki akses ke file kunci pribadi.

10. Pilih Selanjutnya.

11. Tinjau sumber daya dan detail konfigurasi.

12. Pilih Berikutnya atau Buat proyek. (Pilihan yang ditampilkan tergantung pada template proyek Anda.)

    Mungkin perlu beberapa menit untuk membuat proyek, termasuk repositori.

13. Setelah proyek Anda memiliki repositori, Anda dapat menggunakan halaman Repositori untuk mengonfigurasi akses ke sana. Gunakan tautan di Langkah berikutnya untuk mengonfigurasi IDE, menyiapkan pelacakan masalah, atau menambahkan anggota tim ke proyek Anda.

1. Jalankan create-project perintah dan sertakan --generate-cli-skeleton parameter:

   aws codestar create-project --generate-cli-skeleton

   Data berformat JSON muncul di output. Salin data ke file (misalnya,input.json) di lokasi di komputer lokal Anda atau contoh di AWS CLI mana diinstal. Ubah data yang disalin sebagai berikut, dan simpan hasil Anda.

   {
       "name": "project-name", 
       "id": "project-id", 
       "description": "description", 
       "sourceCode": [
           {
               "source": {
                   "s3": {
                       "bucketName": "s3-bucket-name", 
                       "bucketKey": "s3-bucket-object-key"
                   }
               }, 
               "destination": {
                   "codeCommit": {
                       "name": "codecommit-repository-name"
                   }, 
                   "gitHub": {
                       "name": "github-repository-name", 
                       "description": "github-repository-description", 
                       "type": "github-repository-type", 
                       "owner": "github-repository-owner", 
                       "privateRepository": true, 
                       "issuesEnabled": true, 
                       "token": "github-personal-access-token"
                   }
               }
           }
       ], 
       "toolchain": {
           "source": {
               "s3": {
                   "bucketName": "s3-bucket-name", 
                   "bucketKey": "s3-bucket-object-key"
               }
           }, 
           "roleArn": "service-role-arn", 
           "stackParameters": {
               "KeyName": "key-name"
           }
       }, 
       "tags": {
           "KeyName": "key-name"
       }
   }

   Ganti yang berikut ini:

   • nama proyek: Diperlukan. Nama ramah untuk AWS CodeStar proyek ini.

   • project-id: Diperlukan. ID proyek untuk AWS CodeStar proyek ini.

     catatan

     Anda harus memiliki ID proyek unik saat membuat proyek. Anda menerima kesalahan jika Anda mengirimkan file input dengan ID proyek yang sudah ada.

   • deskripsi: Opsional. Deskripsi untuk AWS CodeStar proyek ini.

   • SourceCode: Opsional. Informasi konfigurasi untuk kode sumber yang disediakan untuk proyek. Saat ini, hanya satu sourceCode objek yang didukung. Setiap sourceCode objek berisi informasi tentang lokasi di mana kode sumber diambil oleh AWS CodeStar dan tujuan di mana kode sumber diisi.

     • sumber: Diperlukan. Ini menentukan lokasi di mana Anda mengunggah kode sumber Anda. Satu-satunya sumber yang didukung adalah Amazon S3. AWS CodeStarmengambil kode sumber dan memasukkannya ke dalam repositori setelah proyek Anda dibuat.

       • S3: Opsional. Lokasi Amazon S3 dari kode sumber Anda.

         • bucket-name: Bucket yang berisi kode sumber Anda.

         • bucket-key: Awalan bucket dan kunci objek yang menunjuk ke file.zip yang berisi kode sumber Anda (misalnya,). src.zip

     • tujuan: Opsional. Lokasi tujuan di mana kode sumber Anda akan diisi ketika proyek dibuat. Tujuan yang didukung untuk kode sumber Anda adalah CodeCommit dan GitHub.

       Anda hanya dapat memberikan satu dari dua opsi ini:

       • CodeCommit: Satu-satunya atribut yang diperlukan adalah nama repositori yang harus CodeCommit berisi kode sumber Anda. Repositori ini harus ada di template toolchain Anda.

         catatan

         Untuk CodeCommit, Anda harus memberikan nama repositori yang Anda tentukan di tumpukan toolchain Anda. AWS CodeStarmenginisialisasi repositori ini dengan kode sumber yang Anda berikan di Amazon S3.

       • GitHub: Objek ini mewakili informasi yang diperlukan untuk membuat repositori dan GitHub menyemai dengan kode sumber. Jika Anda memilih GitHub repositori, nilai-nilai berikut diperlukan.

         catatan

         Untuk GitHub, Anda tidak dapat menentukan GitHub repositori yang ada. AWS CodeStarmembuat satu untuk Anda dan mengisi repositori ini dengan kode sumber yang Anda unggah ke Amazon S3. AWS CodeStarmenggunakan informasi berikut untuk membuat repositori Anda di. GitHub

         • nama: Diperlukan. Nama GitHub repositori Anda.

         • deskripsi: Diperlukan. Deskripsi GitHub repositori Anda.

         • jenis: Diperlukan. Jenis GitHub repositori. Nilai yang valid adalah Pengguna atau Organisasi.

         • pemilik: Diperlukan. Nama GitHub pengguna untuk pemilik repositori Anda. Jika repositori harus dimiliki oleh GitHub organisasi, berikan nama organisasi.

         • PrivateRepository: Diperlukan. Apakah Anda ingin repositori ini bersifat pribadi atau publik. Nilai yang valid adalah benar atau salah.

         • IssuesEnabled: Diperlukan. Apakah Anda ingin mengaktifkan masalah GitHub dengan repositori ini. Nilai yang valid adalah benar atau salah.

         • token: Opsional. Ini adalah token akses pribadi yang AWS CodeStar digunakan untuk mengakses GitHub akun Anda. Token ini harus berisi cakupan berikut: repo, user, dan admin:repo_hook. Untuk mengambil token akses pribadi dari GitHub, lihat Membuat Token Akses Pribadi untuk Baris Perintah di GitHub situs web.

           catatan

           Jika Anda menggunakan CLI untuk membuat proyek dengan repositori GitHub sumber, AWS CodeStar gunakan token Anda untuk mengakses repositori melalui aplikasi OAuth. Jika Anda menggunakan konsol untuk membuat proyek dengan repositori GitHub sumber, AWS CodeStar gunakan sumber daya koneksi, yang mengakses repositori dengan aplikasi. GitHub

       • toolchain: Informasi tentang toolchain CI/CD yang akan disiapkan saat proyek dibuat. Ini termasuk lokasi tempat Anda mengunggah template toolchain. Template membuat AWS CloudFormation tumpukan yang berisi sumber daya toolchain Anda. Ini juga mencakup penggantian parameter apa pun AWS CloudFormation untuk referensi dan peran yang akan digunakan untuk membuat tumpukan. AWS CodeStarmengambil template dan menggunakan AWS CloudFormation untuk menjalankan template.

         • sumber: Diperlukan. Lokasi template toolchain Anda. Amazon S3 adalah satu-satunya lokasi sumber yang didukung.

           • S3: Opsional. Lokasi Amazon S3 tempat Anda mengunggah template toolchain Anda.

             • bucket-name: Nama ember Amazon S3.

             • bucket-key: Awalan bucket dan kunci objek yang mengarah ke file.yml.json yang berisi template toolchain Anda (misalnya,). files/toolchain.yml

         • StackParameters: Opsional. Berisi pasangan kunci-nilai yang akan diteruskan ke. AWS CloudFormation Ini adalah parameter, jika ada, template toolchain Anda diatur untuk referensi.

         • peran: Opsional. Peran yang digunakan untuk membuat sumber daya rantai alat di akun Anda. Peran tersebut diperlukan sebagai berikut:

           • Jika peran tidak disediakan, AWS CodeStar gunakan peran layanan default yang dibuat untuk akun Anda jika rantai alat adalah templat AWS CodeStar mulai cepat. Jika peran layanan tidak ada di akun Anda, Anda dapat membuatnya. Untuk informasi, lihat Langkah 2: Buat Peran AWS CodeStar Layanan.

           • Anda harus memberikan peran harus jika Anda mengunggah dan menggunakan template toolchain kustom Anda sendiri. Anda dapat membuat peran berdasarkan peran AWS CodeStar layanan dan pernyataan kebijakan. Untuk contoh pernyataan kebijakan ini, lihat AWSCodeStarServiceRole Kebijakan.

       • tag: Opsional. Tag yang dilampirkan pada AWS CodeStar proyek Anda.

         catatan

         Tag ini tidak melekat pada sumber daya yang terkandung dalam proyek.

2. Beralih ke direktori yang berisi file yang baru saja Anda simpan, dan jalankan create-project perintah lagi. Sertakan --cli-input-json parameternya.

   aws codestar create-project --cli-input-json file://input.json

3. Jika berhasil, data yang mirip dengan berikut ini muncul di output:

   {
       "id": "project-ID",
       "arn": "arn"
   }

   • Output berisi informasi tentang proyek baru:

     • idNilai mewakili ID proyek.

     • arnNilai mewakili ARN proyek.

4. Gunakan describe-project perintah untuk memeriksa status pembuatan proyek Anda. Sertakan --id parameternya.

   aws codestar describe-project --id <project_ID> 

   Data yang mirip dengan berikut ini muncul di output:

   {
       "name": "MyProject",
       "id": "myproject",
       "arn": "arn:aws:codestar:us-east-1:account_ID:project/myproject",
       "description": "",
       "createdTimeStamp": 1539700079.472,
       "stackId": "arn:aws:cloudformation:us-east-1:account_ID:stack/awscodestar-myproject/stack-ID",
       "status": {
           "state": "CreateInProgress"
       }
   }

   • Output berisi informasi tentang proyek baru:

     • stateNilai mewakili status pembuatan proyek, seperti CreateInProgress atauCreateComplete.