

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.

# Memulai tutorial
<a name="getting-started-topnode"></a>

Amazon CodeCatalyst menyediakan sejumlah templat berbeda untuk membantu Anda memulai proyek Anda. Anda juga dapat memilih untuk memulai dengan proyek kosong dan menambahkan sumber daya ke dalamnya. Ikuti langkah-langkah dalam tutorial ini untuk mempelajari beberapa cara Anda dapat bekerja CodeCatalyst. 

Jika ini adalah pertama kalinya Anda menggunakan CodeCatalyst, kami sarankan memulai dengan[Tutorial: Membuat proyek dengan cetak biru aplikasi web tiga tingkat Modern](getting-started-template-project.md).

**catatan**  
Untuk mengikuti tutorial ini, Anda harus terlebih dahulu menyelesaikan pengaturan. Untuk informasi selengkapnya, lihat [Siapkan dan masuk ke CodeCatalystSiapkan dan masuk ke CodeCatalyst](setting-up-topnode.md).

**Topics**
+ [Tutorial: Membuat proyek dengan cetak biru aplikasi web tiga tingkat Modern](getting-started-template-project.md)
+ [Tutorial: Dimulai dengan proyek kosong dan menambahkan sumber daya secara manual](getting-started-blank-template.md)
+ [Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda](getting-started-project-assistance.md)

Untuk tutorial tambahan yang berfokus pada area fungsional tertentu CodeCatalyst, lihat: 
+ [Memulai dengan notifikasi Slack](getting-started-notifications.md)
+ [Memulai dengan repositori CodeCatalyst sumber dan cetak biru aplikasi Single-page](source-getting-started.md)
+ [Memulai dengan alur kerja](workflows-getting-started.md)
+ [Memulai dengan cetak biru khusus](getting-started-bp.md)
+ [Memulai dengan panduan pengembang CodeCatalyst aksi Amazon](https://docs.aws.amazon.com/codecatalyst/latest/adk/action-development-intro.html)

Untuk tutorial mendalam, lihat:
+ [Tutorial: Unggah artefak ke Amazon S3](build-deploy.md)
+ [Tutorial: Menyebarkan aplikasi tanpa server](deploy-tut-lambda.md)
+ [Tutorial: Menyebarkan aplikasi ke Amazon ECS](deploy-tut-ecs.md)
+ [Tutorial: Menyebarkan aplikasi ke Amazon EKS](deploy-tut-eks.md)
+ [Tutorial: Kode lint menggunakan Action GitHub](integrations-github-action-tutorial.md)
+ [Tutorial: Membuat dan memperbarui aplikasi React](blueprint-getting-started-tutorial.md)

# Tutorial: Membuat proyek dengan cetak biru aplikasi web tiga tingkat Modern
<a name="getting-started-template-project"></a>

Anda dapat memulai lebih cepat dengan mengembangkan perangkat lunak dengan membuat proyek dengan cetak biru. Proyek yang dibuat dengan cetak biru mencakup sumber daya yang Anda butuhkan, termasuk repositori sumber untuk mengelola kode Anda, dan alur kerja untuk membangun dan menyebarkan aplikasi. Dalam tutorial ini, kami akan memandu Anda menggunakan cetak biru **aplikasi web tiga tingkat Modern** untuk membuat proyek di Amazon. CodeCatalyst Tutorial ini juga mencakup melihat sampel yang diterapkan, mengundang pengguna lain untuk mengerjakannya, dan membuat perubahan pada kode dengan permintaan tarik yang secara otomatis dibangun dan digunakan ke sumber daya yang terhubung Akun AWS saat permintaan tarik digabungkan. Saat CodeCatalyst membuat proyek Anda dengan laporan, umpan aktivitas, dan alat lainnya, cetak biru Anda membuat AWS sumber daya yang Akun AWS terkait dengan proyek Anda. File cetak biru Anda memungkinkan Anda untuk membangun dan menguji contoh aplikasi modern dan menyebarkannya ke infrastruktur di. AWS Cloud

Ilustrasi berikut menunjukkan bagaimana alat CodeCatalyst digunakan untuk membuat masalah untuk melacak, menggabungkan, dan membuat perubahan secara otomatis, lalu memulai alur kerja dalam CodeCatalyst proyek yang menjalankan tindakan untuk mengizinkan AWS CDK dan menyediakan infrastruktur CloudFormation Anda. 

Tindakan menghasilkan sumber daya yang terkait Akun AWS dan menerapkan aplikasi Anda ke AWS Lambda fungsi tanpa server dengan titik akhir API Gateway. AWS Cloud Development Kit (AWS CDK) Tindakan ini mengonversi satu atau beberapa AWS CDK tumpukan ke CloudFormation templat dan menyebarkan tumpukan ke Anda. Akun AWS Sumber daya di tumpukan Anda mencakup CloudFront sumber daya Amazon untuk mendistribusikan konten web dinamis, instans Amazon DynamoDB untuk data aplikasi Anda, serta peran serta kebijakan yang mendukung aplikasi yang diterapkan.

![\[Perubahan kode, dari pembuatan masalah melalui perubahan dalam repositori sumber, yang kemudian secara otomatis dibangun dan digunakan ke sumber daya di AWS\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/modern-app-overview.png)


Saat Anda membuat proyek dengan cetak biru **aplikasi web tiga tingkat Modern**, proyek Anda dibuat dengan sumber daya berikut:

**Dalam CodeCatalyst proyek**:
+ Sebuah [repositori sumber](source.md) dengan kode sampel dan alur kerja YAMAL
+ [Alur kerja](workflow.md) yang membangun dan menerapkan kode sampel setiap kali perubahan dilakukan ke cabang default
+ Papan masalah dan backlog yang dapat Anda gunakan untuk merencanakan dan melacak pekerjaan
+ Rangkaian laporan pengujian dengan laporan otomatis yang disertakan dalam kode sampel

**Dalam yang terkait Akun AWS**:
+ Tiga AWS CloudFormation tumpukan yang menciptakan sumber daya yang dibutuhkan untuk aplikasi.

Untuk detail yang diperluas tentang sumber daya yang akan dibuat di AWS dan CodeCatalyst sebagai bagian dari tutorial ini, lihat[Referensi](#getting-started-template-project-reference).

**catatan**  
Sumber daya dan sampel yang disertakan dalam proyek bergantung pada cetak biru yang Anda pilih. Amazon CodeCatalyst menawarkan beberapa cetak biru proyek yang mendefinisikan sumber daya yang terkait dengan bahasa atau kerangka kerja yang ditentukan. Untuk mempelajari lebih lanjut tentang cetak biru, lihat. [Membuat proyek yang komprehensif dengan CodeCatalyst cetak biruMembuat proyek yang komprehensif dengan cetak biru](project-blueprints.md)

**Topics**
+ [Prasyarat](#getting-started-template-project-prerequisites)
+ [Langkah 1: Buat proyek aplikasi web tiga tingkat modern](#getting-started-template-project-proj-create)
+ [Langkah 2: Undang seseorang ke proyek Anda](#getting-started-template-project-ipa-user)
+ [Langkah 3: Buat masalah untuk berkolaborasi dan melacak pekerjaan](#getting-started-template-project-issue)
+ [Langkah 4: Lihat repositori sumber Anda](#getting-started-template-project-source)
+ [Langkah 5: Buat Lingkungan Pengembang dengan cabang pengujian dan buat perubahan kode cepat](#getting-started-template-project-create-devenvironment)
+ [Langkah 6: Lihat alur kerja yang membangun aplikasi modern](#getting-started-template-project-view-workflow)
+ [Langkah 7: Minta orang lain untuk meninjau perubahan Anda](#getting-started-template-project-pull-request)
+ [Langkah 8: Tutup masalah](#getting-started-template-project-close-issue)
+ [Pembersihan sumber daya](#getting-started-template-project-clean-up)
+ [Referensi](#getting-started-template-project-reference)

## Prasyarat
<a name="getting-started-template-project-prerequisites"></a>

Untuk membuat proyek aplikasi modern dalam tutorial ini, Anda harus menyelesaikan tugas-tugas [Siapkan dan masuk ke CodeCatalystSiapkan dan masuk ke CodeCatalyst](setting-up-topnode.md) sebagai berikut:
+ Memiliki ID AWS Pembangun untuk masuk CodeCatalyst.
+ Milik ruang dan memiliki **administrator Space** atau peran **pengguna Power** yang ditetapkan untuk Anda di ruang itu. Lihat informasi selengkapnya di [Membuat ruang](spaces-create.md), [Memberikan izin ruang kepada pengguna](spaces-members.md), dan [Peran administrator ruang](ipa-role-types.md#ipa-role-space-admin).
+ Miliki Akun AWS hubungan dengan ruang Anda dan miliki peran IAM yang Anda buat saat mendaftar. Misalnya, saat mendaftar, 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).

## Langkah 1: Buat proyek aplikasi web tiga tingkat modern
<a name="getting-started-template-project-proj-create"></a>

Setelah Anda membuatnya, proyek Anda adalah tempat Anda akan mengembangkan dan menguji kode, mengoordinasikan tugas pengembangan, dan melihat metrik proyek. Proyek Anda juga berisi alat dan sumber daya pengembangan Anda.

Dalam tutorial ini, Anda akan menggunakan cetak biru **aplikasi web tiga tingkat Modern untuk membuat aplikasi** interaktif. Alur kerja yang dibuat dan dijalankan secara otomatis sebagai bagian dari proyek Anda akan membangun dan menyebarkan aplikasi. Alur kerja hanya berjalan dengan sukses setelah semua peran dan informasi akun dikonfigurasi untuk ruang Anda. Setelah alur kerja berjalan dengan sukses, Anda dapat mengunjungi URL endpoint untuk melihat aplikasi.

**Untuk membuat proyek dengan cetak biru**

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

1. Di CodeCatalyst konsol, arahkan ke ruang tempat Anda ingin membuat proyek.

1. Pilih **Buat proyek**.

1. Pilih **Mulai dengan cetak biru**. 

1. Di bilah pencarian, masukkan**modern**.

1. **Pilih cetak biru **aplikasi web tiga tingkat modern**, lalu pilih Berikutnya.**

1. Dalam **Nama proyek Anda**, masukkan nama proyek. Contoh:

   **MyExampleProject**.
**catatan**  
Nama harus unik di ruang Anda.

1. Di **Akun**, pilih yang Akun AWS Anda tambahkan saat mendaftar. Cetak biru akan menginstal sumber daya ke akun ini.

1. Di **Peran Penerapan**, pilih peran yang Anda tambahkan saat mendaftar. Misalnya, pilih `CodeCatalystWorkflowDevelopmentRole-spaceName`. 

   Jika tidak ada peran yang terdaftar, tambahkan satu. Untuk menambahkan peran, pilih **Tambahkan peran IAM dan tambahkan peran** ke peran Anda Akun AWS. Untuk informasi selengkapnya, lihat [Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md).

1. Di **platform Compute**, pilih **Lambda**.

1. Di **Opsi Hosting Frontend**, pilih **Amplify** Hosting. Untuk selengkapnya AWS Amplify, lihat [Apa itu AWS Amplify Hosting?](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html) dalam *AWS Amplify User Guide*.

1. Di **Wilayah Deployment**, masukkan kode Region di Wilayah AWS mana Anda ingin cetak biru untuk menyebarkan aplikasi Mysfits dan sumber daya pendukung. Untuk daftar kode Region, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) di. *Referensi Umum AWS*

1. Dalam **nama Aplikasi**, biarkan default dari`mysfitsstring`.

1. (Opsional) Di bawah **Hasilkan pratinjau proyek**, pilih **Lihat kode** untuk melihat pratinjau file sumber yang akan diinstal cetak biru. Pilih **Lihat alur kerja** untuk melihat pratinjau file definisi CI/CD alur kerja yang akan diinstal cetak biru. Pratinjau diperbarui secara dinamis berdasarkan pilihan Anda.

1. Pilih **Buat proyek**. 

Alur kerja proyek dimulai segera setelah Anda membuat proyek. Butuh sedikit waktu untuk menyelesaikan pembangunan dan penerapan kode. Sementara itu, silakan dan undang orang lain ke proyek Anda.

## Langkah 2: Undang seseorang ke proyek Anda
<a name="getting-started-template-project-ipa-user"></a>

Sekarang setelah Anda menyiapkan proyek Anda, undang orang lain untuk bekerja dengan Anda.

**Untuk mengundang seseorang ke proyek Anda**

1. Arahkan ke proyek yang ingin Anda undang pengguna.

1. Di panel navigasi, pilih **Pengaturan proyek**.

1. Pada tab **Anggota**, pilih **Undang**.

1. Ketik alamat email orang yang ingin Anda undang sebagai pengguna untuk proyek Anda. Anda dapat mengetik beberapa alamat email yang dipisahkan oleh spasi atau koma. Anda juga dapat memilih dari anggota ruang Anda yang bukan anggota proyek. 

1. Pilih peran untuk pengguna.

   Setelah selesai menambahkan pengguna, pilih **Undang**.

## Langkah 3: Buat masalah untuk berkolaborasi dan melacak pekerjaan
<a name="getting-started-template-project-issue"></a>

CodeCatalyst membantu Anda melacak fitur, tugas, bug, dan pekerjaan lain yang terlibat dalam proyek Anda dengan masalah. Anda dapat membuat masalah untuk melacak pekerjaan dan ide yang dibutuhkan. Secara default, ketika Anda membuat masalah itu ditambahkan ke backlog Anda. Anda dapat memindahkan masalah ke papan tempat Anda melacak pekerjaan yang sedang berlangsung. Anda juga dapat menetapkan masalah ke anggota proyek tertentu.

**Untuk membuat masalah untuk sebuah proyek**

1. Di panel navigasi, pilih **Masalah**.

1. Pilih **Buat masalah**. 

1. Di **judul Masalah**, berikan nama untuk masalah tersebut. Secara opsional, berikan deskripsi masalah. Dalam contoh ini, gunakan **make a change in the `src/mysfit_data.json` file.**

1. Pilih prioritas, estimasi, status, dan label. Di bawah **penerima tugas**, pilih **\$1Tambahkan saya** untuk menetapkan masalah untuk diri Anda sendiri.

1. Pilih **Buat masalah**. Masalahnya sekarang terlihat di papan tulis. Pilih kartu untuk memindahkan masalah ke kolom **Sedang berlangsung**. 

Untuk informasi selengkapnya, lihat [Lacak dan atur pekerjaan dengan masalah di CodeCatalystLacak dan atur pekerjaan dengan masalah](issues.md).

## Langkah 4: Lihat repositori sumber Anda
<a name="getting-started-template-project-source"></a>

Cetak biru Anda menginstal repositori sumber yang berisi file untuk menentukan dan mendukung aplikasi atau layanan Anda. Beberapa direktori dan file penting dalam repositori sumber adalah:
+ **direktori.cloud9** - Berisi file pendukung untuk Lingkungan Dev. AWS Cloud9 
+ **.codecatalyst** directory - Berisi file definisi alur kerja untuk setiap `YAML` alur kerja yang disertakan dalam cetak biru.
+ **direktori.idea** - Berisi file pendukung untuk Lingkungan JetBrains Dev.
+ **direktori.vscode** - Berisi file pendukung untuk Lingkungan Pengembang Kode Visual Studio.
+ Direktori **CdkStacks** - Berisi file AWS CDK tumpukan yang menentukan infrastruktur di file. AWS Cloud
+ direktori **src** - Berisi kode sumber aplikasi.
+ direktori **tests** - Berisi file untuk integ dan pengujian unit yang dijalankan sebagai bagian dari CI/CD alur kerja otomatis yang berjalan saat Anda membangun dan menguji aplikasi Anda.
+ direktori **web** - Berisi kode sumber frontend. File lain termasuk file proyek seperti `package.json` file yang berisi metadata penting tentang proyek Anda, `index.html` halaman untuk situs web, `.eslintrc.cjs` file untuk kode linting, dan file untuk menentukan `tsconfig.json` file root dan opsi kompiler.
+ `Dockerfile`file - Menjelaskan wadah aplikasi.
+ `README.md`file - Berisi informasi konfigurasi untuk proyek.

**Untuk menavigasi ke repositori sumber untuk sebuah proyek**

1. Arahkan ke proyek Anda, dan lakukan salah satu hal berikut:
   + Pada halaman ringkasan untuk proyek Anda, pilih repositori yang Anda inginkan dari daftar, lalu pilih **Lihat** repositori.
   + Di panel navigasi, pilih **Kode**, lalu pilih **Repositori sumber**. Di **repositori Sumber**, pilih nama repositori dari daftar. Anda dapat memfilter daftar repositori dengan mengetikkan bagian dari nama repositori di bilah filter.

1. Pada halaman beranda untuk repositori, lihat isi repositori dan informasi tentang sumber daya terkait seperti jumlah permintaan tarik dan alur kerja. Secara default, konten untuk cabang default ditampilkan. Anda dapat mengubah tampilan dengan memilih cabang yang berbeda dari daftar drop-down.

## Langkah 5: Buat Lingkungan Pengembang dengan cabang pengujian dan buat perubahan kode cepat
<a name="getting-started-template-project-create-devenvironment"></a>

Anda dapat dengan cepat mengerjakan kode di repositori sumber Anda dengan membuat Lingkungan Dev. Untuk tutorial ini, kami berasumsi Anda akan:
+ Buat Lingkungan AWS Cloud9 Pengembang.
+ Pilih opsi untuk bekerja di cabang baru dari cabang **utama** saat membuat Lingkungan Dev.
+ Gunakan nama `test` untuk cabang baru ini.

Pada langkah selanjutnya, Anda akan menggunakan Dev Environment untuk membuat perubahan kode dan membuat permintaan tarik.

**Untuk membuat Lingkungan Dev dengan cabang baru**

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

1. Arahkan ke proyek tempat Anda ingin membuat Lingkungan Dev.

1. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih **Kode**, pilih **repositori Sumber**, dan pilih repositori yang ingin Anda buat Lingkungan Dev.

1. Pada halaman rumah repositori, pilih **Create Dev** Environment.

1. Pilih IDE yang didukung dari menu tarik-turun. Untuk informasi selengkapnya, lihat [Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Dev](devenvironment-create.md#devenvironment-supported-ide).

1. Pilih repositori untuk dikloning, pilih **Bekerja di cabang baru**, masukkan nama cabang ke bidang **Nama cabang**, dan pilih cabang untuk membuat cabang baru dari Buat cabang dari menu **drop-down**.

1. Secara opsional, tambahkan alias untuk Lingkungan Dev.

1. Secara opsional, pilih tombol edit **konfigurasi Lingkungan Dev untuk mengedit konfigurasi** komputasi, penyimpanan, atau batas waktu Dev Environment.

1. Pilih **Buat**. Saat Dev Environment Anda sedang dibuat, kolom status Dev Environment akan menampilkan **Mulai**, dan kolom status akan ditampilkan **Running** setelah Dev Environment telah dibuat. Tab baru akan terbuka dengan Lingkungan Dev Anda di IDE pilihan Anda. Anda dapat mengedit kode dan melakukan dan mendorong perubahan Anda.

Di bagian ini, Anda akan bekerja dengan aplikasi sampel yang Anda hasilkan CodeCatalyst dengan membuat perubahan pada kode dengan permintaan tarik yang secara otomatis dibangun dan digunakan ke sumber daya yang terhubung Akun AWS saat permintaan tarik digabungkan. 

**Untuk membuat perubahan pada `src/mysfit_data.json` file Anda**

1. Arahkan ke Lingkungan Pengembang proyek Anda. Di AWS Cloud9, perluas menu navigasi samping untuk menelusuri file. Perluas`mysfits`,`src`, dan buka`src/mysfit_data.json`.

1. Dalam file, ubah nilai untuk `"Age":` bidang dari 6 menjadi 12. Baris Anda akan terlihat seperti berikut: 

   ```
       {
           "Age": 12,
           "Description": "Twilight's personality sparkles like the night sky and is looking for a forever home with a Greek hero or God. While on the smaller side at 14 hands, he is quite adept at accepting riders and can fly to 15,000 feet. Twilight needs a large area to run around in and will need to be registered with the FAA if you plan to fly him above 500 feet. His favorite activities include playing with chimeras, going on epic adventures into battle, and playing with a large inflatable ball around the paddock. If you bring him home, he'll quickly become your favorite little Pegasus.",
           "GoodEvil": "Good",
           "LawChaos": "Lawful",
           "Name": "Twilight Glitter",
           "ProfileImageUri": "https://www.mythicalmysfits.com/images/pegasus_hover.png",
           "Species": "Pegasus",
           "ThumbImageUri": "https://www.mythicalmysfits.com/images/pegasus_thumb.png"
       },
   ```

1. Simpan file tersebut.

1. Ubah ke repositori mysfits dengan perintah. **cd /projects/mysfits**

1. Tambahkan, komit, dan dorong perubahan Anda dengan perintah **git add****, git commit**, dan **git push**.

   ```
   git add .
   git commit -m "make an example change"
   git push
   ```

## Langkah 6: Lihat alur kerja yang membangun aplikasi modern
<a name="getting-started-template-project-view-workflow"></a>

Setelah membuat proyek aplikasi modern, CodeCatalyst hasilkan beberapa sumber daya atas nama Anda, termasuk alur kerja. *Alur kerja* adalah prosedur otomatis yang ditentukan dalam file.yaml yang menjelaskan cara membuat, menguji, dan menyebarkan kode Anda.

Dalam tutorial ini, CodeCatalyst buat alur kerja dan mulai secara otomatis ketika Anda membuat proyek Anda. (Alur kerja mungkin masih berjalan tergantung pada berapa lama Anda membuat proyek Anda.) Gunakan prosedur berikut untuk memeriksa kemajuan alur kerja, meninjau log yang dihasilkan dan laporan pengujian, dan terakhir, arahkan ke URL aplikasi yang digunakan.

**Untuk memeriksa kemajuan alur kerja**

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

   Daftar alur kerja muncul. Ini adalah alur kerja yang dihasilkan dan dimulai oleh CodeCatalyst cetak biru saat Anda membuat proyek.

1. Amati daftar alur kerja. Anda harus melihat empat:
   + Dua alur kerja di bagian atas sesuai dengan `test` cabang yang Anda buat sebelumnya. [Langkah 5: Buat Lingkungan Pengembang dengan cabang pengujian dan buat perubahan kode cepat](#getting-started-template-project-create-devenvironment) Alur kerja ini adalah klon alur kerja di cabang. `main` **ApplicationDeploymentPipeline**Ini tidak aktif karena dikonfigurasi untuk digunakan dengan `main` cabang. **OnPullRequest**Alur kerja tidak berjalan karena tidak ada permintaan tarik yang dibuat.
   + Dua alur kerja di bagian bawah sesuai dengan `main` cabang yang dibuat saat Anda menjalankan cetak biru sebelumnya. **ApplicationDeploymentPipeline**Alur kerja aktif dan berjalan dalam proses (atau selesai).
**catatan**  
Jika proses **ApplicationDeploymentPipeline**gagal dengan **Build @cdk\$1bootstrap** atau **DeployBackend**kesalahan, itu mungkin karena Anda menjalankan aplikasi web tiga tingkat Modern sebelumnya, dan itu meninggalkan sumber daya lama di belakang konflik itu dengan cetak biru saat ini. Anda harus menghapus sumber daya lama ini dan kemudian menjalankan kembali alur kerja. Untuk informasi selengkapnya, lihat [Pembersihan sumber daya](#getting-started-template-project-clean-up).

1. Pilih **ApplicationDeploymentPipeline**alur kerja yang terkait dengan `main` cabang, di bagian bawah. Alur kerja ini dijalankan menggunakan kode sumber di `main` cabang.

   Diagram alur kerja muncul. Diagram menunjukkan beberapa blok, masing-masing mewakili tugas atau *tindakan*. Sebagian besar tindakan diatur secara vertikal, dengan tindakan di bagian atas berjalan sebelum yang di bawah ini. Tindakan yang diatur berdampingan berjalan secara paralel. Tindakan yang dikelompokkan bersama harus berjalan dengan sukses sebelum tindakan di bawahnya dapat dimulai.

   Blok utama adalah:
   + **WorkflowSource**— Blok ini mewakili repositori sumber Anda. Ini menunjukkan, di antara informasi lainnya, nama repositori sumber (**mysfits**) dan komit yang secara otomatis memulai alur kerja berjalan. CodeCatalyst menghasilkan komit ini saat Anda membuat proyek Anda.
   + **Build** — Blok ini mewakili pengelompokan dua tindakan yang keduanya harus berhasil diselesaikan agar tindakan selanjutnya dimulai.
   + **DeployBackend**— Blok ini merupakan tindakan yang menyebarkan komponen backend aplikasi ke cloud. AWS 
   + **Pengujian** — Blok ini mewakili pengelompokan dua tindakan pengujian yang harus diselesaikan dengan sukses agar tindakan selanjutnya dimulai.
   + **DeployFrontend**— Blok ini merupakan tindakan yang menyebarkan komponen frontend aplikasi ke cloud. AWS 

1. Pilih tab **Definisi** (dekat bagian atas). [File definisi alur kerja](workflow-reference.md) muncul di sebelah kanan. File ini memiliki bagian penting berikut:
   + `Triggers`Bagian, di bagian atas. Bagian ini menunjukkan bahwa alur kerja harus dimulai setiap kali kode didorong ke cabang repositori sumber. `main` Mendorong ke cabang lain (seperti`test`) tidak akan memulai alur kerja ini. Alur kerja berjalan menggunakan file di `main` cabang.
   + `Actions`Bagian, di bawah`Triggers`. Bagian ini mendefinisikan tindakan yang Anda lihat dalam diagram alur kerja.

1. Pilih tab **Status terbaru** (dekat bagian atas), dan pilih tindakan apa pun dalam diagram alur kerja.

1. Di sebelah kanan, pilih tab **Konfigurasi** untuk melihat pengaturan konfigurasi yang digunakan oleh tindakan selama proses terbaru. Setiap pengaturan konfigurasi memiliki properti yang cocok dalam file definisi alur kerja.

1. Biarkan konsol terbuka dan pergi ke prosedur berikutnya.

**Untuk meninjau log build dan laporan pengujian**

1. Pilih tab **Status terbaru**.

1. Dalam diagram alur kerja, pilih **DeployFrontend**tindakan.

1. Tunggu sampai aksi selesai. Perhatikan ikon “dalam proses” (![\[Workflow in progress.\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/run-in-progress.png)) untuk berubah menjadi ikon “sukses” (![\[Workflow success.\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/run-success.png)).

1. Pilih tindakan **build\$1backend**.

1. Pilih tab **Log**, dan perluas beberapa bagian untuk melihat pesan log untuk langkah-langkah ini. Anda dapat melihat pesan yang terkait dengan pengaturan backend.

1. Pilih tab **Laporan**, lalu pilih `backend-coverage.xml` laporan. CodeCatalyst menampilkan laporan terkait. Laporan menunjukkan tes cakupan kode yang dijalankan, dan menunjukkan proporsi baris kode yang berhasil divalidasi dengan pengujian, seperti 80%.

   Untuk informasi selengkapnya tentang laporan pengujian, lihat[Pengujian dengan alur kerjaPengujian dengan alur kerja](test-workflow-actions.md).
**Tip**  
Anda juga dapat melihat laporan pengujian dengan memilih **Laporan** di panel navigasi.

1. Biarkan CodeCatalyst konsol terbuka, dan pergi ke prosedur berikutnya.

**Untuk mengonfirmasi bahwa aplikasi modern berhasil digunakan**

1. Kembali ke **ApplicationDeploymentPipeline**alur kerja, dan pilih *string* tautan **Jalankan-** dari proses terbaru.

1. Dalam diagram alur kerja, temukan **DeployFrontend**tindakan dan pilih tautan **Lihat aplikasi**. Situs web Mysfit muncul.
**catatan**  
Jika Anda tidak melihat tautan **Lihat aplikasi** di dalam **DeployFrontend**tindakan, pastikan Anda memilih tautan run ID.

1. **Cari pegasus Mysfit bernama Twilight Glitter.** Perhatikan nilai untuk usia. Ini adalah`6`. Anda akan membuat perubahan kode untuk memperbarui usia.

## Langkah 7: Minta orang lain untuk meninjau perubahan Anda
<a name="getting-started-template-project-pull-request"></a>

Sekarang setelah Anda memiliki perubahan di cabang bernama`test`, Anda dapat meminta orang lain untuk meninjaunya dengan membuat permintaan tarik. Lakukan langkah-langkah berikut untuk membuat permintaan tarik untuk menggabungkan perubahan dari `test` cabang ke `main` cabang.

**Untuk membuat permintaan tarik**

1. Arahkan ke proyek Anda.

1. Lakukan salah satu tindakan berikut:
   + Di panel navigasi, pilih **Kode**, pilih **Tarik permintaan**, lalu pilih **Buat permintaan tarik**. 
   + Pada halaman beranda repositori, pilih **Lainnya**, lalu pilih **Buat permintaan tarik**.
   + Pada halaman proyek, pilih **Buat permintaan tarik**.

1. Di **repositori Sumber**, pastikan bahwa repositori sumber yang ditentukan adalah yang berisi kode yang dikomit. Opsi ini hanya muncul jika Anda tidak membuat permintaan tarik dari halaman utama repositori.

1. Di **cabang Tujuan**, pilih cabang untuk menggabungkan kode setelah ditinjau. 

1. Di **cabang Sumber**, pilih cabang yang berisi kode komit. 

1. Dalam **judul permintaan tarik**, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya. 

1. (Opsional) Dalam **deskripsi permintaan tarik**, berikan informasi seperti tautan ke masalah atau deskripsi perubahan Anda.
**Tip**  
Anda dapat memilih **Tulis deskripsi agar saya** CodeCatalyst secara otomatis menghasilkan deskripsi tentang perubahan yang terkandung dalam permintaan tarik. Anda dapat membuat perubahan pada deskripsi yang dibuat secara otomatis setelah Anda menambahkannya ke permintaan tarik.  
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang dan tidak tersedia untuk permintaan tarik di repositori tertaut. Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 

1. (Opsional) Dalam **Masalah**, pilih **Masalah tautan**, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.

1. (Opsional) Di **Reviewer yang diperlukan**, pilih **Tambahkan pengulas yang diperlukan**. Pilih dari daftar anggota proyek untuk menambahkannya. Peninjau yang diperlukan harus menyetujui perubahan sebelum permintaan tarik dapat digabungkan ke cabang tujuan. 
**catatan**  
Anda tidak dapat menambahkan pengulas sebagai pengulas yang diperlukan dan pengulas opsional. Anda tidak dapat menambahkan diri Anda sebagai reviewer. 

1. (Opsional) Di **pengulas opsional, pilih Tambahkan pengulas** **opsional**. Pilih dari daftar anggota proyek untuk menambahkannya. Peninjau opsional tidak harus menyetujui perubahan sebagai persyaratan sebelum permintaan tarik dapat digabungkan ke cabang tujuan. 

1. Tinjau perbedaan antara cabang. Perbedaan yang ditampilkan dalam permintaan tarik adalah perubahan antara revisi di cabang sumber dan basis gabungan, yang merupakan komit kepala cabang tujuan pada saat permintaan tarik dibuat. Jika tidak ada perubahan yang ditampilkan, cabang mungkin identik, atau Anda mungkin telah memilih cabang yang sama untuk sumber dan tujuan. 

1. Ketika Anda puas bahwa permintaan tarik berisi kode dan perubahan yang ingin Anda tinjau, pilih **Buat**.
**catatan**  
Setelah Anda membuat permintaan tarik, Anda dapat menambahkan komentar. Komentar dapat ditambahkan ke permintaan tarik atau ke baris individual dalam file serta permintaan tarik keseluruhan. Anda dapat menambahkan tautan ke sumber daya, seperti file, dengan menggunakan tanda @ diikuti dengan nama file. 

Saat Anda membuat permintaan tarik, **OnPullRequest**alur kerja mulai menggunakan file sumber di `test` cabang. Saat pengulas menyetujui perubahan kode, Anda dapat mengamati hasilnya dengan memilih alur kerja dan melihat hasil pengujian.

Setelah perubahan ditinjau, Anda dapat menggabungkan kode. Menggabungkan kode ke cabang default akan secara otomatis memulai alur kerja yang akan membangun dan menyebarkan perubahan Anda.<a name="getting-started-template-project-pull-requests-merge-console"></a>

**Untuk menggabungkan permintaan tarik dari konsol CodeCatalyst**

1. Arahkan ke proyek aplikasi modern Anda.

1. Pada halaman proyek, di bawah **Buka permintaan tarik**, pilih permintaan tarik yang ingin Anda gabungkan. Jika Anda tidak melihat permintaan tarik, pilih **Lihat semua** dan kemudian pilih dari daftar. Pilih **Gabungkan**.

1. Pilih dari strategi penggabungan yang tersedia untuk permintaan tarik. **Secara opsional pilih atau batalkan pilihan untuk menghapus cabang sumber setelah menggabungkan permintaan tarik, dan kemudian pilih Gabung.**
**catatan**  
Jika tombol **Gabung** tidak aktif, atau Anda melihat label **Tidak dapat digabungkan**, salah satu atau beberapa pengulas yang diperlukan belum menyetujui permintaan tarik, atau permintaan tarik tidak dapat digabungkan di konsol. CodeCatalyst Peninjau yang belum menyetujui permintaan tarik ditunjukkan oleh ikon jam di **Ikhtisar** di area **detail permintaan Tarik**. Jika semua pengulas yang diperlukan telah menyetujui permintaan tarik tetapi tombol **Gabung** masih belum aktif, Anda mungkin memiliki konflik gabungan. Anda dapat menyelesaikan konflik gabungan untuk cabang tujuan di CodeCatalyst konsol dan kemudian menggabungkan permintaan tarik, atau Anda dapat menyelesaikan konflik dan menggabungkan secara lokal, lalu mendorong komit yang berisi penggabungan ke. CodeCatalyst Untuk informasi selengkapnya, lihat [Menggabungkan permintaan tarik (Git)](pull-requests-merge.md#pull-requests-merge-git) dan dokumentasi Git Anda.

Setelah Anda menggabungkan perubahan dari `test` cabang ke **main** cabang, perubahan secara otomatis memulai **ApplicationDeploymentPipeline**alur kerja yang membangun dan menyebarkan perubahan Anda. <a name="getting-started-template-project-pull-requests-merge-view-success"></a>

**Untuk melihat komit gabungan berjalan melalui alur kerja ApplicationDeploymentPipeline**

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

1. Di **Alur Kerja**, di **ApplicationDeploymentPipeline**, perluas **Lari terbaru.** Anda dapat melihat alur kerja yang dijalankan oleh komit gabungan. Secara opsional pilih untuk menonton kemajuan lari. 

1. Saat proses selesai, muat ulang URL yang Anda kunjungi sebelumnya. Lihat pegasus untuk memverifikasi bahwa usia berubah.  
![\[Perubahan kode digabungkan, dibangun, dan diterapkan, terlihat dalam aplikasi\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/modified-mysfits.png)

## Langkah 8: Tutup masalah
<a name="getting-started-template-project-close-issue"></a>

Ketika masalah teratasi, itu dapat ditutup di CodeCatalyst konsol.

**Untuk menutup masalah untuk sebuah proyek**

1. Arahkan ke proyek Anda.

1. Di panel navigasi, pilih **Masalah**.

1. Drag-and-drop masalah ke kolom **Selesai**.

Untuk informasi selengkapnya, lihat [Lacak dan atur pekerjaan dengan masalah di CodeCatalystLacak dan atur pekerjaan dengan masalah](issues.md).

## Pembersihan sumber daya
<a name="getting-started-template-project-clean-up"></a>

Bersihkan CodeCatalyst dan AWS untuk menghapus jejak tutorial ini dari lingkungan Anda.

Anda dapat memilih untuk tetap menggunakan proyek yang Anda gunakan untuk tutorial ini, atau Anda dapat menghapus proyek dan sumber daya yang terkait.

**catatan**  
Menghapus proyek ini akan menghapus semua repositori, masalah, dan artefak dalam proyek untuk semua anggota.

**Untuk menghapus proyek**

1. Arahkan ke proyek Anda, lalu pilih **Pengaturan proyek**.

1. Pilih tab **Umum**.

1. Di bawah nama proyek, pilih **Hapus proyek**.

**Untuk menghapus sumber daya di CloudFormation dan Amazon S3**

1. Masuk ke akun Konsol Manajemen AWS dengan akun yang sama yang Anda tambahkan ke CodeCatalyst ruang Anda.

1. Pergi ke **CloudFormation**layanan.

1. Hapus tumpukan **mysfits. *string***

1. Hapus tumpukan **development-mysfits *string***.

1. Pilih (tapi jangan hapus) **CDKToolkit**tumpukan. Pilih tab **Sumber Daya**. Pilih **StagingBucket**tautannya, lalu hapus isi bucket dan bucket di Amazon S3.
**catatan**  
Jika Anda tidak menghapus bucket ini secara manual, Anda mungkin akan melihat kesalahan saat menjalankan ulang cetak biru aplikasi web tiga tingkat Modern.

1. (Opsional) Hapus **CDKToolkit**tumpukan.

## Referensi
<a name="getting-started-template-project-reference"></a>

Cetak biru aplikasi web tiga tingkat Modern menyebarkan sumber daya ke CodeCatalyst ruang Anda dan akun Anda di cloud. AWS AWS Sumber daya ini adalah:
+ **Di CodeCatalyst ruang Anda**:
  +  CodeCatalyst Proyek yang mencakup sumber daya berikut:
    + Repositori [sumber - Repositori](source.md) ini berisi kode contoh untuk aplikasi web 'Mysfits'.
    + [Alur kerja](workflow.md) - Alur kerja ini membangun dan menyebarkan kode aplikasi Mysfits setiap kali perubahan dilakukan ke cabang default
    + [Papan masalah](issues.md) dan backlog — Papan dan backlog ini dapat digunakan untuk merencanakan dan melacak pekerjaan.
    + [Rangkaian laporan pengujian — Suite](test-workflow-actions.md) ini mencakup laporan otomatis yang disertakan dalam kode sampel.
+ **Dalam yang terkait Akun AWS**:
  + **CDKToolkit**Tumpukan - Tumpukan ini menyebarkan sumber daya berikut:
    + Bucket pementasan Amazon S3, kebijakan bucket, dan AWS KMS kunci yang digunakan untuk mengenkripsi bucket.
    + Peran penyebaran IAM untuk tindakan penerapan.
    + AWS Peran dan kebijakan IAM dalam mendukung sumber daya dalam tumpukan.
**catatan**  
Tidak **CDKToolkit**diruntuhkan dan dibuat ulang untuk setiap penerapan. Ini adalah tumpukan yang dimulai di setiap akun untuk mendukung. AWS CDK
  + Tumpukan **pengembangan-mysfits** — *string* BackEnd Tumpukan ini menyebarkan sumber daya backend berikut:
    + Titik akhir Amazon API Gateway.
    + AWS Peran dan kebijakan IAM dalam mendukung sumber daya dalam tumpukan.
    +  AWS Lambda Fungsi dan lapisan menyediakan platform komputasi tanpa server untuk aplikasi modern.
    + Kebijakan dan peran IAM untuk penerapan bucket dan fungsi Lambda.
  + Tumpukan **mysfits** — *string* Tumpukan ini menyebarkan aplikasi frontend. AWS Amplify 

### Lihat juga
<a name="getting-started-template-project-reference-links"></a>

Untuk informasi selengkapnya tentang AWS layanan tempat sumber daya dibuat sebagai bagian dari tutorial ini, lihat berikut ini:
+ **Amazon S3** — Layanan untuk menyimpan aset frontend Anda pada layanan penyimpanan objek yang menawarkan skalabilitas terdepan di industri, ketersediaan data tinggi, keamanan, dan kinerja. Untuk informasi selengkapnya, lihat [Panduan Pengguna Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
+ **Amazon API Gateway** — Layanan untuk membuat, menerbitkan, memelihara, memantau, dan mengamankan REST, HTTP, dan WebSocket APIs pada skala apa pun Untuk informasi selengkapnya, lihat [Panduan Pengembang API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/).
+ **Amplify** — Layanan untuk hosting aplikasi frontend Anda. Untuk informasi selengkapnya, lihat [Panduan Pengguna AWS Amplify Hosting](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html).
+ **AWS Cloud Development Kit (AWS CDK)**— Kerangka kerja untuk mendefinisikan infrastruktur cloud dalam kode dan menyediakannya. AWS CloudFormation AWS CDK Termasuk AWS CDK Toolkit, yang merupakan alat baris perintah untuk berinteraksi dengan AWS CDK aplikasi dan tumpukan. Untuk informasi selengkapnya, silakan lihat [Panduan Developer AWS Cloud Development Kit (AWS CDK)](https://docs.aws.amazon.com/cdk/latest/guide/).
+ **Amazon DynamoDB** — Layanan database NoSQL yang dikelola sepenuhnya untuk menyimpan data. Untuk informasi selengkapnya, lihat [Panduan Developer Amazon DynamoDB](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html).
+ **AWS Lambda**— Layanan untuk menjalankan kode Anda pada infrastruktur komputasi ketersediaan tinggi tanpa menyediakan atau mengelola server. Untuk informasi selengkapnya, silakan lihat [Panduan Developer AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/).
+ **AWS IAM** — Layanan untuk mengontrol akses AWS dan sumber dayanya dengan aman. Untuk informasi selengkapnya, lihat [Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).

# Tutorial: Dimulai dengan proyek kosong dan menambahkan sumber daya secara manual
<a name="getting-started-blank-template"></a>

Anda dapat membuat proyek kosong tanpa sumber daya yang telah ditentukan sebelumnya di dalamnya dengan memilih cetak biru **proyek Kosong** saat Anda membuat proyek. Setelah Anda membuat proyek kosong, Anda dapat membuat dan menambahkan sumber daya sesuai dengan kebutuhan proyek Anda. Karena proyek yang dibuat tanpa cetak biru kosong saat pembuatan, opsi ini membutuhkan lebih banyak pengetahuan tentang membuat dan mengonfigurasi CodeCatalyst sumber daya untuk memulai.

**Topics**
+ [Prasyarat](#getting-started-bt-prerequisites)
+ [Buat proyek kosong](#getting-started-bt-proj-create)
+ [Buat repositori sumber](#getting-started-bt-source-create)
+ [Buat alur kerja untuk membangun, menguji, dan menerapkan perubahan kode](#getting-started-bt-workflow-create)
+ [Undang seseorang ke proyek Anda](#getting-started-bt-ipa-user)
+ [Buat masalah untuk berkolaborasi dan melacak pekerjaan](#getting-started-bt-issue)

## Prasyarat
<a name="getting-started-bt-prerequisites"></a>

Untuk membuat proyek kosong, Anda harus memiliki **administrator Space** atau peran **pengguna Power** yang ditetapkan untuk Anda. Jika ini adalah pertama kalinya Anda masuk CodeCatalyst, lihat[Siapkan dan masuk ke CodeCatalystSiapkan dan masuk ke CodeCatalyst](setting-up-topnode.md).

## Buat proyek kosong
<a name="getting-started-bt-proj-create"></a>

Membuat proyek adalah langkah pertama untuk dapat bekerja sama. Jika Anda ingin membuat sumber daya Anda sendiri, seperti repositori sumber dan alur kerja, Anda dapat memulai dengan proyek kosong. 

**Untuk membuat proyek kosong**

1. Arahkan ke ruang tempat Anda ingin membuat proyek.

1. Di dasbor ruang, pilih **Buat proyek**.

1. Pilih **Mulai dari awal**.

1. Di bawah **Berikan nama untuk proyek Anda**, masukkan nama yang ingin Anda tetapkan ke proyek Anda. Nama harus unik di dalam ruang Anda.

1. Pilih **Buat proyek**.

Sekarang Anda memiliki proyek kosong, langkah selanjutnya adalah membuat repositori sumber.

## Buat repositori sumber
<a name="getting-started-bt-source-create"></a>

Buat repositori sumber untuk menyimpan dan berkolaborasi pada kode proyek Anda. Anggota proyek dapat mengkloning repositori ini ke komputer lokal mereka untuk bekerja pada kode. Atau, Anda dapat memilih untuk menautkan repositori yang dihosting di layanan yang didukung, tetapi itu tidak tercakup dalam tutorial ini. Untuk informasi selengkapnya, lihat [Menautkan repositori sumber](source-repositories-link.md).

**Untuk membuat repositori sumber**

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

1. Arahkan ke proyek Anda.

1. Di panel navigasi, pilih **Kode**, lalu pilih **Repositori sumber**.

1. Pilih **Tambahkan repositori**, lalu pilih **Buat** repositori.

1. Dalam nama **Repositori, berikan nama** untuk repositori. Dalam panduan ini, kami menggunakan*codecatalyst-source-repository*, tetapi Anda dapat memilih nama yang berbeda. Nama repositori harus unik dalam sebuah proyek. Untuk informasi selengkapnya tentang persyaratan untuk nama repositori, lihat. [Kuota untuk repositori sumber di CodeCatalyst](source-quotas.md)

1. (Opsional) Dalam **Deskripsi**, tambahkan deskripsi untuk repositori yang akan membantu pengguna lain dalam proyek memahami untuk apa repositori digunakan. 

1. Pilih **Buat repositori (default)**. Opsi ini membuat repositori yang mencakup cabang default dan file README.md. Tidak seperti repositori kosong, Anda dapat menggunakan repositori ini segera setelah dibuat.

1. Di **cabang Default**, biarkan nama sebagai *main* kecuali Anda memiliki alasan untuk memilih nama yang berbeda. Contoh dalam panduan ini semua menggunakan nama *utama* untuk cabang default.

1. (Opsional) Tambahkan `.gitignore` file untuk jenis kode yang Anda rencanakan untuk dorong. 

1. Pilih **Buat**.
**catatan**  
CodeCatalyst menambahkan `README.md` file ke repositori Anda saat Anda membuatnya. CodeCatalyst**juga membuat komit awal untuk repositori di cabang default bernama main.** Anda dapat mengedit atau menghapus file README.md, tetapi Anda tidak dapat menghapus cabang default.

Anda dapat dengan cepat menambahkan kode di repositori Anda dengan membuat Lingkungan Dev. Untuk tutorial ini, kami menyarankan Anda membuat Lingkungan Dev menggunakan AWS Cloud9, dan memilih opsi untuk membuat cabang dari cabang **utama** saat membuat Lingkungan Dev. Kami menggunakan nama **test** untuk cabang ini, tetapi Anda dapat memasukkan nama cabang yang berbeda jika Anda mau.

**Untuk membuat Lingkungan Dev dengan cabang baru**

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

1. Arahkan ke proyek tempat Anda ingin membuat Lingkungan Dev.

1. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih **Kode**, pilih **repositori Sumber**, dan pilih repositori yang ingin Anda buat Lingkungan Dev.

1. Pada halaman rumah repositori, pilih **Create Dev** Environment.

1. Pilih IDE yang didukung dari menu tarik-turun. Untuk informasi selengkapnya, lihat [Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Dev](devenvironment-create.md#devenvironment-supported-ide).

1. Pilih repositori untuk dikloning, pilih **Bekerja di cabang baru**, masukkan nama cabang ke bidang **Nama cabang**, dan pilih cabang untuk membuat cabang baru dari Buat cabang dari menu **drop-down**.

1. Secara opsional, tambahkan alias untuk Lingkungan Dev.

1. Secara opsional, pilih tombol edit **konfigurasi Lingkungan Dev untuk mengedit konfigurasi** komputasi, penyimpanan, atau batas waktu Dev Environment.

1. Pilih **Buat**. Saat Dev Environment Anda sedang dibuat, kolom status Dev Environment akan menampilkan **Mulai**, dan kolom status akan ditampilkan **Running** setelah Dev Environment telah dibuat. Tab baru akan terbuka dengan Lingkungan Dev Anda di IDE pilihan Anda. Anda dapat mengedit kode dan melakukan dan mendorong perubahan Anda.

## Buat alur kerja untuk membangun, menguji, dan menerapkan perubahan kode
<a name="getting-started-bt-workflow-create"></a>

Di CodeCatalyst, Anda mengatur pembangunan, pengujian, dan penyebaran aplikasi atau layanan Anda dalam alur kerja. Alur kerja terdiri dari tindakan dan dapat dikonfigurasi untuk berjalan secara otomatis setelah peristiwa repositori sumber tertentu terjadi, seperti mendorong kode atau membuka atau memperbarui permintaan tarik. Untuk informasi lebih lanjut tentang alur kerja, lihat [Bangun, uji, dan terapkan dengan alur kerjaBangun, uji, dan terapkan dengan alur kerja](workflow.md).

Ikuti petunjuk [Memulai dengan alur kerja](workflows-getting-started.md) untuk membuat alur kerja pertama Anda.

## Undang seseorang ke proyek Anda
<a name="getting-started-bt-ipa-user"></a>

Sekarang setelah Anda menyiapkan proyek kustom Anda, undang orang lain untuk bekerja dengan Anda.

**Untuk mengundang seseorang ke proyek Anda**

1. Arahkan ke proyek yang ingin Anda undang pengguna.

1. Di panel navigasi, pilih **Pengaturan proyek**.

1. Pada tab **Anggota**, pilih **Undang**.

1. Ketik alamat email orang yang ingin Anda undang sebagai pengguna untuk proyek Anda. Anda dapat mengetik beberapa alamat email yang dipisahkan oleh spasi atau koma. Anda juga dapat memilih dari anggota ruang Anda yang bukan anggota proyek. 

1. Pilih peran untuk pengguna.

   Setelah selesai menambahkan pengguna, pilih **Undang**.

## Buat masalah untuk berkolaborasi dan melacak pekerjaan
<a name="getting-started-bt-issue"></a>

CodeCatalyst membantu Anda melacak fitur, tugas, bug, dan pekerjaan lain yang terlibat dalam proyek Anda dengan masalah. Anda dapat membuat masalah untuk melacak pekerjaan dan ide yang dibutuhkan. Secara default, ketika Anda membuat masalah itu ditambahkan ke backlog Anda. Anda dapat memindahkan masalah ke papan tempat Anda melacak pekerjaan yang sedang berlangsung. Anda juga dapat menetapkan masalah ke anggota proyek tertentu.

**Untuk membuat masalah untuk sebuah proyek**

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

   Pastikan Anda menavigasi dalam proyek tempat Anda ingin membuat masalah. Untuk melihat semua proyek, di panel navigasi, pilih **Amazon CodeCatalyst**, dan jika diperlukan, pilih **Lihat semua proyek**. Pilih proyek tempat Anda ingin membuat atau bekerja dengan masalah.

1. Di panel navigasi, pilih **Lacak**, lalu pilih **Backlog**.

1. Pilih **Buat masalah**. 

1. Di **judul Masalah**, berikan nama untuk masalah tersebut. Secara opsional memberikan deskripsi masalah. Pilih status, prioritas, dan estimasi untuk masalah jika diinginkan. Anda juga dapat menetapkan masalah ke anggota proyek dari daftar anggota proyek.
**Tip**  
Anda dapat memilih untuk menetapkan masalah ke **Amazon Q** agar Amazon Q mencoba menyelesaikan masalah tersebut. Jika upaya berhasil, permintaan tarik akan dibuat dan status masalah akan berubah menjadi **Dalam peninjauan** sehingga Anda dapat meninjau dan menguji kode. Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda](getting-started-project-assistance.md).  
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut. Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html). 

1. Pilih **Simpan**.

Setelah Anda membuat masalah, Anda dapat menetapkannya ke anggota proyek, memperkirakannya, dan melacaknya di papan Kanban. Lihat informasi yang lebih lengkap di [Lacak dan atur pekerjaan dengan masalah di CodeCatalystLacak dan atur pekerjaan dengan masalah](issues.md).

# Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda
<a name="getting-started-project-assistance"></a>

Jika Anda memiliki proyek dan repositori sumber CodeCatalyst di Amazon di ruang di mana fitur AI generatif diaktifkan, Anda dapat menggunakan fitur ini untuk membantu mempercepat pengembangan perangkat lunak. Pengembang sering memiliki lebih banyak tugas yang harus dilakukan daripada waktu untuk menyelesaikannya. Mereka sering tidak meluangkan waktu untuk menjelaskan perubahan kode mereka kepada rekan tim mereka saat membuat permintaan tarik untuk meninjau perubahan tersebut, mengharapkan pengguna lain menemukan perubahan yang cukup jelas. Pembuat dan pengulas permintaan tarik juga tidak punya waktu untuk menemukan dan membaca semua komentar pada permintaan tarik secara menyeluruh, terutama jika permintaan tarik memiliki beberapa revisi. CodeCatalyst terintegrasi dengan Agen Pengembang Amazon Q untuk pengembangan perangkat lunak guna menyediakan fitur AI generatif yang dapat membantu anggota tim menyelesaikan tugas mereka dengan lebih cepat, dan meningkatkan waktu yang mereka miliki untuk fokus pada bagian terpenting dari pekerjaan mereka. 

Amazon Q Developer adalah asisten percakapan bertenaga AI generatif yang dapat membantu Anda memahami, membangun, memperluas, dan mengoperasikan aplikasi. AWS Untuk mempercepat pembangunan Anda AWS, model yang mendukung Amazon Q ditambah dengan AWS konten berkualitas tinggi untuk menghasilkan jawaban yang lebih lengkap, dapat ditindaklanjuti, dan direferensikan. Untuk informasi selengkapnya, lihat [Apa itu Pengembang Amazon Q?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html) di *Panduan Pengguna Pengembang Amazon Q*. 

**catatan**  
**Didukung oleh Amazon Bedrock**: AWS mengimplementasikan deteksi [penyalahgunaan otomatis](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Karena fitur **Tuliskan deskripsi untuk saya**, **Buat rangkuman konten**, **Rekomendasikan tugas**, **Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek**, dan **Tugaskan masalah ke Amazon Q** dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak dibangun di Amazon Bedrock, pengguna dapat memanfaatkan sepenuhnya kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan kecerdasan buatan (AI) yang bertanggung jawab.

Dalam tutorial ini, Anda akan belajar cara menggunakan fitur AI generatif CodeCatalyst untuk membantu Anda membuat proyek dengan cetak biru, serta menambahkan cetak biru ke proyek yang ada. Selain itu, Anda akan belajar cara meringkas perubahan antar cabang saat membuat permintaan tarik dan meringkas komentar yang tersisa pada permintaan tarik. Anda juga akan belajar cara membuat masalah dengan ide Anda untuk perubahan atau peningkatan kode dan menetapkannya ke Amazon Q. Sebagai bagian dari menangani masalah yang ditetapkan ke Amazon Q, Anda akan belajar cara mengizinkan Amazon Q menyarankan tugas dan cara menetapkan dan mengerjakan tugas apa pun yang dibuatnya sebagai bagian dari mengerjakan suatu masalah.

**Topics**
+ [Prasyarat](#getting-started-project-assistance-prerequisites)
+ [Menggunakan Amazon Q untuk memilih cetak biru saat membuat proyek atau menambahkan fungsionalitas](#getting-started-project-assistance-create-apply-bp)
+ [Buat ringkasan perubahan kode antar cabang saat membuat permintaan tarik](#getting-started-project-assistance-pull-request-summary)
+ [Buat ringkasan komentar yang tersisa pada perubahan kode dalam permintaan tarik](#getting-started-project-assistance-comment-summary)
+ [Buat masalah dan tetapkan ke Amazon Q](#getting-started-project-assistance-issue-to-code)
+ [Buat masalah dan minta tugas yang direkomendasikan untuk itu oleh Amazon Q](#getting-started-project-assistance-issue-to-tasks)
+ [Pembersihan sumber daya](#getting-started-project-assistance-clean-up)

## Prasyarat
<a name="getting-started-project-assistance-prerequisites"></a>

Untuk bekerja dengan CodeCatalyst fitur-fitur dalam tutorial ini, Anda harus terlebih dahulu menyelesaikan dan memiliki akses ke sumber daya berikut:
+ Anda memiliki ID AWS Pembangun atau identitas masuk tunggal (SSO) untuk masuk. CodeCatalyst
+ Anda berada di ruang yang memiliki fitur AI generatif diaktifkan. Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
+ Anda memiliki peran administrator Kontributor atau Proyek dalam proyek di ruang tersebut.
+ Kecuali Anda membuat proyek dengan AI generatif, proyek Anda yang ada memiliki setidaknya satu repositori sumber yang dikonfigurasi untuknya. Repositori tertaut tidak didukung.
+ Saat menetapkan masalah untuk memiliki solusi awal yang dibuat oleh AI generatif, proyek tidak dapat dikonfigurasi dengan ekstensi Perangkat Lunak **Jira**. Ekstensi tidak didukung untuk fitur ini. 

Untuk informasi lebih lanjut, lihat [Membuat ruang](spaces-create.md), [Lacak dan atur pekerjaan dengan masalah di CodeCatalystLacak dan atur pekerjaan dengan masalah](issues.md), [Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalystTambahkan fungsionalitas ke proyek dengan ekstensi](extensions.md), dan [Memberikan akses dengan peran pengguna](ipa-roles.md) .

Tutorial ini didasarkan pada proyek yang dibuat menggunakan cetak biru **aplikasi web tiga tingkat Modern** dengan Python. Jika Anda menggunakan proyek yang dibuat dengan cetak biru yang berbeda, Anda masih dapat mengikuti langkah-langkahnya, tetapi beberapa spesifik akan bervariasi, seperti kode sampel dan bahasa. 

## Menggunakan Amazon Q untuk memilih cetak biru saat membuat proyek atau menambahkan fungsionalitas
<a name="getting-started-project-assistance-create-apply-bp"></a>

Sebagai pengembang proyek, Anda dapat berkolaborasi dengan Amazon Q, asisten AI generatif, saat membuat proyek baru atau menambahkan komponen ke proyek yang ada. Anda dapat menyediakan Amazon Q dengan persyaratan untuk proyek Anda dengan berinteraksi dengannya dalam antarmuka seperti obrolan. Berdasarkan kebutuhan Anda, Amazon Q menyarankan cetak biru dan juga menguraikan persyaratan yang tidak dapat dipenuhi. Jika ruang Anda memiliki cetak biru khusus, Amazon Q mempelajari dan menyertakan cetak biru tersebut dalam rekomendasi juga. Anda kemudian dapat melanjutkan dengan saran Amazon Q jika Anda puas, dan itu akan membuat sumber daya yang diperlukan seperti repositori sumber dengan kode untuk kebutuhan Anda. Amazon Q juga menciptakan masalah untuk persyaratan yang tidak dapat dipenuhi dengan cetak biru. Untuk mempelajari selengkapnya tentang CodeCatalyst cetak biru yang tersedia, lihat. [Membuat proyek yang komprehensif dengan CodeCatalyst cetak biruMembuat proyek yang komprehensif dengan cetak biru](project-blueprints.md) Untuk mempelajari selengkapnya tentang menggunakan Amazon Q dengan cetak biru, lihat. [Praktik terbaik saat menggunakan Amazon Q untuk membuat proyek atau menambahkan fungsionalitas dengan cetak biru](projects-create.md#projects-create-amazon-q)

**Untuk membuat proyek dengan Amazon Q**

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

1. Di CodeCatalyst konsol, arahkan ke ruang tempat Anda ingin membuat cetak biru.

1. Di dasbor ruang, pilih **Buat dengan Amazon Q**.

1. Di bidang input teks prompt Amazon Q, berikan instruksi dengan menulis deskripsi singkat tentang proyek yang ingin Anda bangun. Sebagai contoh, `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”`.

   (Opsional) Di bawah **contoh Coba**, Anda dapat menggunakan prompt yang telah ditulis sebelumnya dengan memilih cetak biru. Misalnya, jika Anda memilih aplikasi React, prompt berikut disediakan: `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”`

1. Pilih **Kirim** untuk mengirimkan instruksi Anda ke Amazon Q. Asisten AI generatif memberikan saran dan menguraikan persyaratan yang tidak dapat dipenuhi oleh cetak biru. Misalnya, Amazon Q mungkin menyarankan hal berikut berdasarkan kriteria Anda:

   ```
   I recommend using the Modern three-tier web application blueprint based on 
                       your requirements. Blueprints are dynamic and can always be updated and edited later.
   
   Modern three-tier web application
   By Amazon Web Services
   
   This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
   The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
   and serverless code functions.
   
   Version: 0.1.163
   
   View details
   
   The following requirements could not be met so I will create issues for you.
   • Add authentication and authorization mechanisms for security and allowable actions.
   ```

1. **(Opsional) Untuk melihat detail mendalam dari cetak biru yang disarankan, pilih Lihat detail.**

1. Lakukan salah satu tindakan berikut:

   1. Pilih **Ya, gunakan cetak biru ini** jika Anda puas dengan sarannya.

   1. Pilih **Edit prompt** jika Anda ingin mengubah prompt.

   1. Pilih **Mulai dari awal** jika Anda ingin menghapus prompt sepenuhnya.

1. Lakukan salah satu tindakan berikut:

   1. Pilih **Konfigurasi** jika Anda ingin mengonfigurasi cetak biru yang disarankan. Anda juga dapat mengonfigurasi cetak biru di lain waktu.

   1. Pilih **Lewati** jika Anda tidak ingin mengubah konfigurasi cetak biru saat ini.

1. Jika Anda memilih untuk mengonfigurasi cetak biru, pilih **Lanjutkan** setelah memodifikasi sumber daya proyek.

1. Saat diminta, masukkan nama yang ingin Anda tetapkan ke proyek Anda dan nama sumber daya yang terkait. Nama harus unik di dalam ruang Anda.

1. Pilih **Buat proyek** untuk membuat proyek dengan cetak biru. Amazon Q membuat sumber daya menggunakan cetak biru. Misalnya, jika Anda membuat proyek dengan cetak biru aplikasi Single-page, repositori sumber untuk kode dan alur kerja yang relevan akan dibuat. CI/CD 

1. (Opsional) Secara default, Amazon Q juga membuat masalah untuk persyaratan yang tidak dipenuhi oleh cetak biru. Anda dapat memilih item mana yang tidak ingin Anda buat masalah. Setelah Anda memilih untuk membiarkan Amazon Q membuat masalah, Anda kemudian dapat menetapkan masalah ke Amazon Q juga. Ini akan menganalisis masalah dalam konteks repositori sumber yang diberikan, memberikan ringkasan file sumber dan kode yang relevan. Lihat informasi selengkapnya di [Menemukan dan melihat masalah](issues-view.md), [Buat masalah dan tetapkan ke Amazon Q](#getting-started-project-assistance-issue-to-code), dan [Praktik terbaik saat membuat dan menangani masalah yang ditetapkan ke Amazon Q](issues-create-issue.md#issues-create-issue-assign-genai-best-practices).

Setelah membuat proyek dengan Amazon Q, Anda juga dapat menggunakan Amazon Q untuk menambahkan komponen baru karena menyarankan CodeCatalyst cetak biru berdasarkan kebutuhan Anda.

**Untuk menambahkan cetak biru dengan Amazon Q**

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

1. Di CodeCatalyst konsol, arahkan ke proyek tempat Anda ingin menambahkan cetak biru.

1. Pilih **Tambahkan dengan Amazon Q**.

1. Di bidang input teks prompt Amazon Q, berikan instruksi dengan menulis deskripsi singkat tentang proyek yang ingin Anda bangun. Sebagai contoh, `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”`.

   (Opsional) Di bawah **contoh Coba**, Anda dapat menggunakan prompt yang telah ditulis sebelumnya dengan memilih cetak biru. Misalnya, jika Anda memilih aplikasi React, prompt berikut disediakan: `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”`

1. Pilih **Kirim** untuk mengirimkan instruksi Anda ke Amazon Q. Asisten AI generatif memberikan saran dan menguraikan persyaratan yang tidak dapat dipenuhi oleh cetak biru. Misalnya, Amazon Q mungkin menyarankan hal berikut berdasarkan kriteria Anda:

   ```
   I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.
   
   Single-page application
   By Amazon Web Services
   
   This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.
   
   Version: 0.2.15
   View details
   
   The following requirements could not be met so I will create issues for you.
   • The application should have reusable UI components
   • The application should support for client-side routing
   • The application may require server-side rendering for improved performance and SEO
   ```

1. **(Opsional) Untuk melihat detail mendalam dari cetak biru yang disarankan, pilih Lihat detail.**

1. Lakukan salah satu tindakan berikut:

   1. Pilih **Ya, gunakan cetak biru ini** jika Anda puas dengan sarannya.

   1. Pilih **Edit prompt** jika Anda ingin mengubah prompt.

   1. Pilih **Mulai dari awal** jika Anda ingin menghapus prompt sepenuhnya.

1. Lakukan salah satu tindakan berikut:

   1. Pilih **Konfigurasi** jika Anda ingin mengonfigurasi cetak biru yang disarankan. Anda juga dapat mengonfigurasi cetak biru di lain waktu.

   1. Pilih **Lewati** jika Anda tidak ingin mengubah konfigurasi cetak biru saat ini.

1. Jika Anda memilih untuk mengonfigurasi cetak biru, pilih **Lanjutkan** setelah memodifikasi sumber daya proyek.

1. Pilih **Tambahkan ke proyek** untuk menambahkan sumber daya ke proyek dengan cetak biru. Amazon Q membuat sumber daya menggunakan cetak biru. Misalnya, jika Anda menambahkan proyek dengan cetak biru aplikasi Single-page, repositori sumber untuk kode dan alur kerja yang relevan akan dibuat. CI/CD 

1. (Opsional) Secara default, Amazon Q juga membuat masalah untuk persyaratan yang tidak dipenuhi oleh cetak biru. Anda dapat memilih item mana yang tidak ingin Anda buat masalah. Setelah Anda memilih untuk membiarkan Amazon Q membuat masalah, Anda kemudian dapat menetapkan masalah ke Amazon Q juga. Ini akan menganalisis masalah dalam konteks repositori sumber yang diberikan, memberikan ringkasan file sumber dan kode yang relevan. Untuk informasi selengkapnya, lihat [Buat masalah dan tetapkan ke Amazon Q](#getting-started-project-assistance-issue-to-code) dan [Praktik terbaik saat membuat dan menangani masalah yang ditetapkan ke Amazon Q](issues-create-issue.md#issues-create-issue-assign-genai-best-practices).

## Buat ringkasan perubahan kode antar cabang saat membuat permintaan tarik
<a name="getting-started-project-assistance-pull-request-summary"></a>

Permintaan tarik adalah cara utama Anda dan anggota proyek lainnya dapat meninjau, mengomentari, dan menggabungkan perubahan kode dari satu cabang ke cabang lainnya. Anda dapat menggunakan permintaan tarik untuk meninjau perubahan kode secara kolaboratif untuk perubahan kecil atau perbaikan, penambahan fitur utama, atau versi baru dari perangkat lunak yang dirilis. Meringkas perubahan kode dan maksud di balik perubahan sebagai bagian dari deskripsi permintaan tarik sangat membantu orang lain yang akan meninjau kode, dan juga membantu dengan pemahaman historis tentang perubahan kode dari waktu ke waktu. Namun, pengembang sering mengandalkan kode mereka untuk menjelaskan dirinya sendiri atau memberikan detail yang ambigu daripada menggambarkan perubahan mereka dengan detail yang cukup bagi pengulas untuk memahami apa yang mereka ulas atau apa maksud di balik perubahan dalam kode.

Anda dapat menggunakan fitur **Tulis deskripsi untuk saya** saat membuat permintaan tarik agar Amazon Q membuat deskripsi perubahan yang terkandung dalam permintaan tarik. Saat Anda memilih opsi ini, Amazon Q menganalisis perbedaan antara cabang sumber yang berisi perubahan kode dan cabang tujuan tempat Anda ingin menggabungkan perubahan ini. Ini kemudian menciptakan ringkasan tentang apa perubahan itu, serta interpretasi terbaiknya tentang maksud dan efek dari perubahan tersebut.

**catatan**  
Fitur ini tidak bekerja dengan submodul Git. Ini tidak akan meringkas perubahan apa pun dalam submodul Git yang merupakan bagian dari permintaan tarik.   
Fitur ini tidak tersedia untuk permintaan tarik di repositori tertaut.

Anda dapat mencoba fitur ini dengan permintaan tarik apa pun yang Anda buat, tetapi dalam tutorial ini, kami akan mengujinya dengan membuat beberapa perubahan sederhana pada kode yang terkandung dalam proyek yang dibuat dalam cetak biru aplikasi web **tiga tingkat Modern** berbasis Python.

**Tip**  
Jika Anda menggunakan proyek yang dibuat dengan cetak biru yang berbeda atau kode Anda sendiri, Anda masih dapat mengikuti tutorial ini, tetapi contoh dalam tutorial ini tidak akan cocok dengan kode dalam proyek Anda. Alih-alih contoh yang disarankan di bawah ini, buat perubahan sederhana pada kode proyek Anda di cabang, lalu buat permintaan tarik untuk menguji fitur seperti yang ditunjukkan pada langkah-langkah berikut.

Pertama, Anda akan membuat cabang di repositori sumber. Anda kemudian akan membuat perubahan kode cepat ke file di cabang itu menggunakan editor teks di konsol. Anda kemudian akan membuat permintaan tarik, dan menggunakan fitur **Write description for me untuk** meringkas perubahan yang Anda buat.

**Untuk membuat cabang (konsol)**

1. Di CodeCatalyst konsol, arahkan ke proyek tempat repositori sumber Anda berada.

1. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih **Kode**, lalu pilih **Repositori sumber**.

1. Pilih repositori tempat Anda ingin membuat cabang.

1. Pada halaman ikhtisar repositori, pilih **Lainnya**, lalu pilih **Buat** cabang.

1. Masukkan nama untuk cabang.

1. Pilih cabang untuk membuat cabang, lalu pilih **Buat**. 

Setelah Anda memiliki cabang, edit file di cabang itu dengan perubahan sederhana. Dalam contoh ini, Anda akan mengedit `test_endpoint.py` file untuk mengubah jumlah percobaan ulang untuk pengujian dari **3** **5**.

**Tip**  
Anda juga dapat memilih untuk membuat atau menggunakan Dev Environment untuk membuat perubahan kode ini. Untuk informasi selengkapnya, lihat [Membuat Lingkungan Pengembangan](devenvironment-create.md).

**Untuk mengedit `test_endpoint.py` file di konsol**

1. Pada halaman ikhtisar untuk repositori **mysfits** sumber, pilih drop-down cabang dan pilih cabang yang Anda buat dalam prosedur sebelumnya.

1. Di **File**, navigasikan ke file yang ingin Anda edit. Misalnya, untuk mengedit `test_endpoint.py` file, memperluas **tes**, memperluas **integ**, dan kemudian memilih`test_endpoint.py`.

1. Pilih **Edit**.

1. Pada baris 7, ubah berapa kali semua tes akan dicoba ulang dari:

   ```
   def test_list_all(retry=3):
   ```

   ke:

   ```
   def test_list_all(retry=5):
   ```

1. Pilih **Komit** dan komit perubahan Anda ke cabang Anda.

Sekarang Anda memiliki cabang dengan perubahan, Anda dapat membuat permintaan tarik.

**Buat permintaan tarik dengan ringkasan perubahan**

1. Pada halaman ikhtisar repositori, pilih **Lainnya**, lalu pilih **Buat permintaan tarik**.

1. Di **cabang Tujuan**, pilih cabang untuk menggabungkan kode setelah ditinjau. 
**Tip**  
Pilih cabang tempat Anda membuat cabang Anda dari prosedur sebelumnya untuk demonstrasi paling sederhana dari fitur ini. Misalnya, jika Anda membuat cabang dari cabang default repositori, pilih cabang itu sebagai cabang tujuan untuk permintaan tarik Anda.

1. Di **cabang Sumber**, pilih cabang yang berisi perubahan yang baru saja Anda lakukan pada `test_endpoint.py` file. 

1. Dalam **judul permintaan tarik**, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya. 

1. Dalam **deskripsi permintaan tarik**, pilih **Tulis deskripsi agar saya meminta** Amazon Q membuat deskripsi perubahan yang terkandung dalam permintaan tarik.

1. Ringkasan perubahan muncul. Tinjau teks yang disarankan lalu pilih **Terima dan tambahkan ke deskripsi**.

1. Secara opsional, ubah ringkasan untuk lebih mencerminkan perubahan yang Anda buat pada kode. Anda juga dapat memilih untuk menambahkan pengulas atau masalah tautan ke permintaan tarik ini. Setelah selesai membuat perubahan tambahan yang Anda inginkan, pilih **Buat**.

## Buat ringkasan komentar yang tersisa pada perubahan kode dalam permintaan tarik
<a name="getting-started-project-assistance-comment-summary"></a>

Saat pengguna meninjau permintaan tarik, mereka sering meninggalkan beberapa komentar tentang perubahan permintaan tarik itu. Jika ada banyak komentar dari banyak pengulas, mungkin sulit untuk memilih tema umum dalam umpan balik, atau bahkan pastikan bahwa Anda telah meninjau semua komentar di semua revisi. Anda dapat menggunakan fitur **Buat ringkasan komentar** agar Amazon Q menganalisis semua komentar yang tersisa pada perubahan kode dalam permintaan tarik dan membuat ringkasan komentar tersebut.

**catatan**  
Ringkasan komentar bersifat sementara. Jika Anda menyegarkan permintaan tarik, ringkasan akan hilang. Ringkasan konten tidak menyertakan komentar pada permintaan tarik keseluruhan, cukup komentar yang tersisa tentang perbedaan kode dalam revisi permintaan tarik.  
Fitur ini tidak berfungsi dengan komentar apa pun yang tersisa pada perubahan kode di submodul Git.  
Fitur ini tidak tersedia untuk permintaan tarik di repositori tertaut.

**Untuk membuat ringkasan komentar dalam permintaan tarik**

1. Arahkan ke permintaan tarik yang Anda buat di prosedur sebelumnya. 
**Tip**  
Jika mau, Anda dapat menggunakan permintaan tarik terbuka apa pun di proyek Anda. Di bilah navigasi, pilih **Kode**, pilih **Permintaan tarik**, dan pilih permintaan tarik terbuka.

1. Tambahkan beberapa komentar ke permintaan tarik di **Perubahan** jika permintaan tarik belum memiliki komentar.

1. Di **Ikhtisar**, pilih **Buat ringkasan komentar**. Setelah selesai, bagian **Ringkasan komentar** akan diperluas. 

1. Tinjau ringkasan komentar yang tersisa pada perubahan kode dalam revisi permintaan tarik, dan bandingkan dengan komentar dalam permintaan tarik.

## Buat masalah dan tetapkan ke Amazon Q
<a name="getting-started-project-assistance-issue-to-code"></a>

Tim pengembangan membuat masalah untuk melacak dan mengelola pekerjaan mereka, tetapi terkadang masalah tetap ada karena tidak jelas siapa yang harus mengerjakannya, atau masalah tersebut memerlukan penelitian ke bagian tertentu dari basis kode, atau pekerjaan mendesak lainnya harus dihadiri terlebih dahulu. CodeCatalyst termasuk integrasi dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak. Anda dapat menetapkan masalah ke asisten AI generatif yang disebut **Amazon Q** yang dapat menganalisis masalah berdasarkan judul dan deskripsinya. Jika Anda menetapkan masalah ke Amazon Q, itu akan mencoba membuat solusi draf untuk Anda evaluasi. Ini dapat membantu Anda dan tim Anda untuk fokus dan mengoptimalkan pekerjaan Anda pada masalah yang memerlukan perhatian Anda, sementara Amazon Q bekerja pada solusi untuk masalah yang tidak memiliki sumber daya untuk segera ditangani. 

**Tip**  
**Amazon Q** berkinerja terbaik pada masalah sederhana dan masalah langsung. Untuk hasil terbaik, gunakan bahasa sederhana untuk menjelaskan dengan jelas apa yang ingin Anda lakukan.

Ketika Anda menetapkan masalah ke **Amazon Q**, CodeCatalyst akan menandai masalah sebagai diblokir sampai Anda mengonfirmasi bagaimana Anda ingin Amazon Q bekerja pada masalah tersebut. Ini mengharuskan Anda untuk menjawab tiga pertanyaan sebelum dapat melanjutkan: 
+  Apakah Anda ingin mengonfirmasi setiap langkah yang diperlukan atau apakah Anda ingin melanjutkan tanpa umpan balik. Jika Anda memilih untuk mengonfirmasi setiap langkah, Anda dapat membalas Amazon Q dengan umpan balik tentang pendekatan yang dibuatnya sehingga dapat mengulangi pendekatannya jika diperlukan. Amazon Q juga dapat meninjau umpan balik yang ditinggalkan pengguna pada permintaan tarik apa pun yang dibuatnya jika Anda memilih opsi ini. Jika Anda memilih untuk tidak mengonfirmasi setiap langkah, Amazon Q mungkin menyelesaikan pekerjaannya lebih cepat, tetapi Amazon Q tidak akan meninjau umpan balik apa pun yang Anda berikan dalam masalah atau permintaan tarik apa pun yang dibuatnya.
+ Apakah Anda ingin mengizinkannya memperbarui file alur kerja sebagai bagian dari pekerjaannya. Proyek Anda mungkin memiliki alur kerja yang dikonfigurasi untuk mulai berjalan pada peristiwa permintaan tarik. Jika demikian, permintaan tarik apa pun yang dibuat Amazon Q yang menyertakan pembuatan atau pembaruan alur kerja YAMB mungkin memulai menjalankan alur kerja yang disertakan dalam permintaan tarik. Sebagai praktik terbaik, jangan memilih untuk mengizinkan Amazon Q bekerja pada file alur kerja kecuali Anda yakin tidak ada alur kerja dalam proyek Anda yang akan secara otomatis menjalankan alur kerja ini sebelum Anda meninjau dan menyetujui permintaan tarik yang dibuatnya.
+ Apakah Anda ingin mengizinkannya menyarankan membuat tugas untuk memecah pekerjaan dalam masalah menjadi peningkatan yang lebih kecil yang dapat ditetapkan secara individual kepada pengguna, termasuk Amazon Q itu sendiri. Mengizinkan Amazon Q untuk menyarankan dan membuat tugas dapat membantu mempercepat pengembangan pada masalah kompleks dengan memungkinkan banyak orang untuk mengerjakan bagian-bagian terpisah dari masalah tersebut. Ini juga dapat membantu mengurangi kompleksitas pemahaman keseluruhan pekerjaan karena pekerjaan yang diperlukan untuk menyelesaikan setiap tugas idealnya lebih sederhana daripada masalah yang dimilikinya.
+ Repositori sumber apa yang Anda inginkan untuk berfungsi. Bahkan jika proyek Anda memiliki beberapa repositori sumber, Amazon Q hanya dapat bekerja pada kode dalam satu repositori sumber. Repositori tertaut tidak didukung.

Setelah Anda membuat dan mengonfirmasi pilihan Anda, **Amazon Q** akan memindahkan masalah ke status **Sedang berlangsung** saat mencoba menentukan permintaan berdasarkan judul masalah dan deskripsinya, serta kode di repositori yang ditentukan. Ini akan membuat komentar yang disematkan di mana ia akan memberikan pembaruan tentang status pekerjaannya. Setelah meninjau data, Amazon Q akan merumuskan pendekatan potensial untuk solusi. Amazon Q mencatat tindakannya dengan memperbarui komentar yang disematkan dan mengomentari kemajuannya pada masalah ini di setiap tahap. Tidak seperti komentar dan balasan yang disematkan, itu tidak menyimpan catatan kronologis pekerjaannya secara ketat. Sebaliknya, ini menempatkan informasi yang paling relevan tentang pekerjaannya di tingkat atas komentar yang disematkan. Ini akan mencoba membuat kode berdasarkan pendekatannya dan analisisnya terhadap kode yang sudah ada di repositori. Jika berhasil menghasilkan solusi potensial, itu akan membuat cabang dan kode komit ke cabang itu. Kemudian membuat permintaan tarik yang akan menggabungkan cabang itu dengan cabang default. Ketika Amazon Q menyelesaikan pekerjaannya, ia memindahkan masalah ke **Dalam tinjauan** sehingga Anda dan tim Anda tahu ada kode yang siap untuk Anda evaluasi.

**catatan**  
Fitur ini hanya tersedia melalui **Masalah** di Wilayah Barat AS (Oregon). Ini tidak tersedia jika Anda telah mengonfigurasi proyek Anda untuk menggunakan Jira dengan ekstensi **Perangkat Lunak Jira**. Selain itu, jika Anda telah menyesuaikan tata letak papan Anda, masalah mungkin tidak mengubah status. Untuk hasil terbaik, hanya gunakan fitur ini dengan proyek yang memiliki tata letak papan standar.  
Fitur ini tidak bekerja dengan submodul Git. Itu tidak dapat membuat perubahan pada submodul Git apa pun yang termasuk dalam repositori.  
Setelah Anda menetapkan masalah ke Amazon Q, Anda tidak dapat mengubah judul atau deskripsi masalah atau menetapkannya kepada orang lain. Jika Anda membatalkan penetapan **Amazon Q** dari masalah, itu akan menyelesaikan langkahnya saat ini dan kemudian berhenti bekerja. Itu tidak dapat melanjutkan pekerjaan atau dipindahkan ke masalah setelah tidak ditetapkan.  
Masalah dapat secara otomatis dipindahkan ke kolom **Dalam tinjauan** jika ditetapkan ke Amazon Q jika pengguna memilih untuk mengizinkannya membuat tugas. Namun, masalah di **Dalam tinjauan** mungkin masih memiliki tugas yang berada dalam keadaan berbeda, seperti dalam status **Sedang berlangsung**.

Di bagian tutorial ini, Anda akan membuat tiga masalah berdasarkan fitur potensial untuk kode yang disertakan dalam proyek yang dibuat dengan cetak biru **aplikasi web tiga tingkat Modern**: satu untuk menambahkan untuk membuat makhluk mysfit baru, satu untuk menambahkan fitur pengurutan, dan satu untuk memperbarui alur kerja untuk menyertakan cabang bernama. **test**

**catatan**  
 Jika Anda bekerja dalam proyek dengan kode yang berbeda, buat masalah dengan judul dan deskripsi yang berhubungan dengan basis kode tersebut.

**Untuk membuat masalah dan memiliki solusi yang dihasilkan untuk Anda evaluasi**

1. Di panel navigasi, pilih **Masalah** dan pastikan Anda berada di tampilan **Papan**.

1. Pilih **Buat masalah**.

1. Berikan judul yang menjelaskan apa yang ingin Anda lakukan dalam bahasa sederhana. Misalnya, untuk masalah ini, masukkan judul**Create another mysfit named Quokkapus**. Dalam **Deskripsi**, berikan detail berikut:

   ```
   Expand the table of mysfits to 13, and give the new mysfit the following characteristics:
   
   Name: Quokkapus
   
   Species: Quokka-Octopus hybrid
   
   Good/Evil: Good
   
   Lawful/Chaotic: Chaotic
   
   Age: 216
   
   Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
   She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
   in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
   assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
   her to grow, and keep that coffee coming.
   ```

1. (Opsional) Lampirkan gambar untuk digunakan sebagai thumbnail dan gambar profil untuk mysfit ke masalah tersebut. Jika Anda melakukan ini, perbarui deskripsi untuk menyertakan detail gambar apa yang ingin Anda gunakan dan mengapa. Misalnya, Anda dapat menambahkan yang berikut ke deskripsi: “Mysfit membutuhkan file gambar untuk disebarkan ke situs web. Tambahkan gambar-gambar ini yang dilampirkan pada masalah ini ke repositori sumber sebagai bagian dari pekerjaan, dan menyebarkan gambar ke situs web.
**catatan**  
Gambar terlampir mungkin atau mungkin tidak disebarkan ke situs web selama interaksi dalam tutorial ini. Anda dapat menambahkan gambar ke situs web sendiri, dan kemudian meninggalkan komentar untuk Amazon Q untuk memperbarui kodenya untuk menunjuk ke gambar yang ingin Anda gunakan setelah membuat permintaan tarik.

   Tinjau deskripsi dan pastikan berisi semua detail yang mungkin diperlukan sebelum Anda melanjutkan ke langkah berikutnya.

1. Di **Penerima Tugas**, pilih **Tetapkan ke Amazon Q**.

1. Di **repositori Sumber**, pilih repositori sumber yang berisi kode proyek.

1. Geser **Require Amazon Q untuk berhenti setelah setiap langkah dan tunggu peninjauan pemilih kerjanya ke status aktif jika perlu**.
**catatan**  
Memilih opsi untuk menghentikan Amazon Q setelah setiap langkah memungkinkan Anda mengomentari masalah atau tugas apa pun yang dibuat untuk memiliki opsi agar Amazon Q mengubah pendekatannya hingga tiga kali berdasarkan komentar Anda. Jika Anda memilih opsi untuk tidak menghentikan Amazon Q setelah setiap langkah sehingga Anda dapat meninjau pekerjaannya, pekerjaan mungkin berjalan lebih cepat karena Amazon Q tidak menunggu umpan balik Anda, tetapi Anda tidak akan dapat memengaruhi arah Amazon Q mengambil dengan meninggalkan komentar. Amazon Q juga tidak akan menanggapi komentar yang tersisa dalam permintaan tarik jika Anda memilih opsi itu.

1. Biarkan **Izinkan Amazon Q untuk memodifikasi pemilih file alur kerja** dalam keadaan tidak aktif.

1. Geser **Izinkan Amazon Q untuk menyarankan membuat pemilih tugas** ke status aktif.

1. Pilih **Buat masalah**. Tampilan Anda berubah ke papan Masalah.

1. Pilih **Buat masalah** untuk membuat masalah lain, kali ini dengan judul**Change the get\$1all\$1mysfits() API to return mysfits sorted by the Age attribute**. Tetapkan masalah ini ke **Amazon Q** dan buat masalah.

1. Pilih **Buat masalah** untuk membuat masalah lain, kali ini dengan judul**Update the OnPullRequest workflow to include a branch named test in its triggers**. Secara opsional link ke alur kerja dalam deskripsi. Tetapkan masalah ini ke **Amazon Q** tetapi kali ini pastikan bahwa pemilih **Izinkan Amazon Q memodifikasi file alur kerja** disetel ke status aktif. Buat masalah untuk kembali ke papan Masalah.
**Tip**  
Anda dapat mencari file, termasuk file alur kerja, dengan memasukkan simbol at (`@`) dan memasukkan nama file.

Setelah Anda membuat dan menetapkan masalah, masalah akan pindah ke **Sedang berlangsung**. Amazon Q akan menambahkan komentar yang melacak kemajuannya di dalam masalah dalam komentar yang disematkan. Jika mampu mendefinisikan pendekatan untuk solusi, itu akan memperbarui deskripsi masalah dengan bagian **Latar Belakang** yang berisi analisis basis kode dan bagian **Pendekatan** yang merinci pendekatan yang diusulkan untuk membuat solusi. Jika Amazon Q berhasil menemukan solusi untuk masalah yang dijelaskan dalam masalah ini, Amazon Q akan membuat cabang dan perubahan kode di cabang yang mengimplementasikan solusi yang diusulkan. Jika kode yang diusulkan berisi kesamaan dengan kode sumber terbuka yang diketahui Amazon Q, itu akan menyediakan file yang menyertakan tautan ke kode itu sehingga Anda dapat memeriksanya. Setelah kode siap, ia membuat permintaan tarik sehingga Anda dapat meninjau perubahan kode yang disarankan, menambahkan tautan ke permintaan tarik itu ke masalah, dan memindahkan masalah ke **Dalam tinjauan**.

**penting**  
Anda harus selalu meninjau setiap perubahan kode dalam permintaan tarik sebelum menggabungkannya. Menggabungkan perubahan kode yang dibuat oleh Amazon Q, seperti perubahan kode lainnya, dapat berdampak negatif pada basis kode dan kode infrastruktur Anda jika kode gabungan tidak ditinjau dengan benar dan berisi kesalahan saat digabungkan.

**Untuk meninjau masalah dan permintaan tarik tertaut yang berisi perubahan yang dibuat oleh Amazon Q**

1. Dalam **Masalah**, pilih masalah yang ditetapkan ke Amazon Q yang **sedang berlangsung**. Tinjau komentar untuk memantau kemajuan Amazon Q. Jika ada, tinjau latar belakang dan dekati catatan dalam deskripsi masalah. Jika Anda memilih untuk mengizinkan Amazon Q menyarankan tugas, tinjau tugas apa pun yang diusulkan dan lakukan tindakan apa pun yang diperlukan. Misalnya, jika Amazon Q menyarankan tugas dan Anda ingin mengubah urutan atau menetapkan tugas ke pengguna tertentu, pilih **Ubah, tambahkan, atau susun ulang tugas** dan lakukan pembaruan apa pun yang diperlukan. Setelah selesai melihat masalah, pilih **X** untuk menutup panel masalah.
**Tip**  
Untuk melihat kemajuan tugas, pilih tugas dari daftar tugas dalam masalah. Tugas tidak muncul sebagai item terpisah di papan tulis dan hanya dapat diakses melalui masalah. Jika tugas ditetapkan ke Amazon Q, Anda harus membuka tugas untuk menyetujui tindakan apa pun yang ingin dilakukannya. Anda juga harus membuka tugas untuk melihat permintaan tarik tertaut karena tidak akan muncul sebagai tautan dalam masalah, hanya dalam tugas. Untuk kembali ke masalah dari tugas, pilih tautan ke masalah.

1. Sekarang pilih masalah yang ditetapkan ke Amazon Q yang ada di **Dalam ulasan**. Tinjau latar belakang dan dekati catatan dalam deskripsi masalah. Tinjau komentar untuk memahami tindakan yang dilakukannya. Tinjau tugas apa pun yang dibuat untuk pekerjaan yang terkait dengan masalah ini, termasuk kemajuannya, tindakan apa pun yang mungkin perlu Anda ambil, dan komentar apa pun. Di **Permintaan tarik**, pilih tautan ke permintaan tarik di sebelah label **Buka** untuk meninjau kode. 
**Tip**  
Permintaan tarik yang dihasilkan untuk tugas hanya muncul sebagai permintaan tarik tertaut dalam tampilan tugas. Mereka tidak muncul sebagai permintaan tarik tertaut untuk masalah ini.

1. Dalam permintaan tarik, tinjau perubahan kode. Untuk informasi selengkapnya, lihat [Meninjau permintaan pull](pull-requests-review.md). Tinggalkan komentar pada permintaan tarik jika Anda ingin Amazon Q mengubah kode yang disarankan. Jadilah spesifik saat meninggalkan komentar untuk Amazon Q untuk hasil terbaik. 

   Misalnya, saat meninjau permintaan tarik yang dibuat untuk**Create another mysfit named Quokkapus**, Anda mungkin memperhatikan bahwa ada kesalahan ketik dalam deskripsi. Anda dapat meninggalkan komentar untuk Amazon Q yang menyatakan “Ubah deskripsi untuk memperbaiki kesalahan ketik” needsa “dengan menambahkan spasi antara “kebutuhan” dan “a”.” Atau, Anda dapat meninggalkan komentar yang memberi tahu Amazon Q untuk memperbarui deskripsi dan memberikan seluruh deskripsi yang direvisi untuk digabungkan.

   Jika Anda mengunggah gambar untuk mysfit baru ke situs web, Anda dapat meninggalkan komentar untuk Amazon Q untuk memperbarui mysfit dengan pointer ke gambar dan thumbnail yang akan digunakan untuk mysfit baru.
**catatan**  
Amazon Q tidak akan menanggapi komentar individual. Amazon Q hanya akan memasukkan umpan balik yang tersisa di komentar dalam permintaan tarik jika Anda memilih opsi default untuk berhenti setelah setiap langkah untuk persetujuan saat Anda membuat masalah.

1. (Opsional) Setelah Anda dan pengguna proyek lainnya meninggalkan semua komentar yang Anda inginkan untuk perubahan kode, pilih **Buat revisi** agar Amazon Q membuat revisi permintaan tarik yang menggabungkan perubahan yang Anda minta dalam komentar. Kemajuan kemajuan pembuatan revisi akan dilaporkan oleh Amazon Q di **Ikhtisar**, bukan dalam **Perubahan**. Pastikan untuk menyegarkan browser Anda untuk melihat pembaruan terbaru dari Amazon Q tentang membuat revisi.
**catatan**  
Hanya pengguna yang membuat masalah yang dapat membuat revisi permintaan tarik. Anda hanya dapat meminta satu revisi permintaan tarik. Pastikan bahwa Anda telah mengatasi semua masalah dengan komentar, dan bahwa Anda puas dengan konten komentar, sebelum Anda memilih **Buat revisi**.

1. Alur kerja dijalankan untuk setiap permintaan tarik dalam proyek contoh ini. Pastikan bahwa Anda melihat alur kerja yang berhasil dijalankan sebelum Anda menggabungkan permintaan tarik. Anda juga dapat memilih untuk membuat alur kerja dan lingkungan tambahan untuk menguji kode sebelum Anda menggabungkannya. Untuk informasi selengkapnya, lihat [Memulai dengan alur kerja](workflows-getting-started.md).

1. Bila Anda puas dengan revisi terbaru dari pull request, pilih **Merge**.

## Buat masalah dan minta tugas yang direkomendasikan untuk itu oleh Amazon Q
<a name="getting-started-project-assistance-issue-to-tasks"></a>

Suatu masalah terkadang dapat berisi jumlah pekerjaan yang kompleks atau panjang. CodeCatalyst termasuk integrasi dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak. Anda dapat meminta **Amazon Q** untuk menganalisis masalah berdasarkan judul dan deskripsinya, dan merekomendasikan pemecahan logis pekerjaan menjadi tugas terpisah. Ini akan mencoba untuk membuat daftar tugas yang direkomendasikan yang kemudian dapat meninjau, memodifikasi, dan memilih apakah akan membuat. Ini dapat membantu Anda dan tim Anda untuk menetapkan bagian-bagian individual dari pekerjaan kepada pengguna dengan cara yang lebih mudah dikelola yang dapat dicapai lebih cepat. 

**Untuk membuat dan meninjau daftar tugas yang direkomendasikan untuk suatu masalah**

1. Di panel navigasi, pilih **Masalah** dan pastikan Anda berada di tampilan **Papan**.

1. Pilih **Buat masalah**.

1. Berikan judul yang menjelaskan apa yang ingin Anda lakukan dalam bahasa sederhana. Misalnya, untuk masalah ini, masukkan judul**Change the get\$1all\$1mysfits() API to return mysfits sorted by the Good/Evil attribute**. Dalam **Deskripsi**, berikan detail berikut:

   ```
   Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.
   ```

1. Tinjau deskripsi dan pastikan berisi semua detail yang mungkin diperlukan sebelum Anda melanjutkan ke langkah berikutnya.

1. Di **Penerima Tugas**, pilih untuk menetapkan masalah untuk diri Anda sendiri.

1. Pilih **Buat masalah**. Tampilan Anda berubah ke papan Masalah.

1. Pilih masalah yang baru saja Anda buat untuk membukanya. Pilih **Rekomendasikan tugas**.

1. Pilih repositori sumber yang berisi kode untuk penerbitan. Pilih **Mulai merekomendasikan tugas.**

Dialog akan ditutup dan Amazon Q akan mulai menganalisis masalah untuk kompleksitas. Jika masalahnya rumit, ini akan menyarankan pemecahan pekerjaan menjadi tugas yang terpisah dan berurutan. Saat daftar sudah siap, pilih **Lihat tugas yang disarankan**. Anda dapat menambahkan tugas tambahan, memodifikasi tugas yang disarankan, dan menyusun ulang tugas. Jika Anda setuju dengan rekomendasi, memilih **Buat tugas** akan membuat tugas. Anda kemudian dapat menetapkan tugas-tugas tersebut kepada pengguna untuk mengerjakannya, atau bahkan ke Amazon Q itu sendiri.

## Pembersihan sumber daya
<a name="getting-started-project-assistance-clean-up"></a>

Setelah Anda menyelesaikan tutorial ini, pertimbangkan untuk mengambil tindakan berikut untuk membersihkan sumber daya apa pun yang Anda buat selama tutorial ini yang tidak lagi Anda butuhkan.
+ Batalkan penugasan Amazon Q dari masalah apa pun yang tidak lagi dikerjakan. Jika Amazon Q telah menyelesaikan pekerjaannya pada suatu masalah atau tidak dapat menemukan solusi, pastikan untuk membatalkan penetapan Amazon Q untuk menghindari mencapai kuota maksimum untuk fitur AI generatif. Untuk informasi selengkapnya, lihat [Mengelola fitur dan [Harga](https://codecatalyst.aws/explore/pricing) AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
+ Pindahkan masalah apa pun di mana pekerjaan **selesai ke Selesai**.
+ Jika proyek tidak lagi diperlukan, hapus proyek.