Tutorial: Membuat aplikasi full-stack dengan cetak biru yang dapat dikomposisi PDK

1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

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

3. Di dasbor ruang, pilih Buat proyek.

4. Pilih Mulai dengan cetak biru.

5. Pilih cetak biru PDK- Monorepo, lalu pilih Berikutnya.

6. Di bawah Nama proyek Anda, masukkan nama yang ingin Anda tetapkan ke proyek Anda dan nama sumber daya yang terkait. Nama harus unik di dalam ruang Anda.

7. Di bawah sumber daya Proyek, lakukan hal berikut:

   1. Di bawah Bahasa pemrograman utama, pilih bahasa yang ingin Anda kembangkan kode proyek Anda. Anda dapat memilih dari TypeScript, Java, atau Python.

   2. Pilih Konfigurasi Kode

   3. Di bidang input teks Source Repository, masukkan nama repositori sumber, yang akan membuat repositori baru, atau pilih dari repositori tertaut yang ada. Repositori yang ada harus kosong. Untuk informasi selengkapnya, lihat Menautkan repositori sumber.

   4. (Opsional) Dari menu tarik-turun Package Manager, pilih manajer paket. Ini hanya diperlukan jika Anda memilih TypeScript sebagai bahasa pemrograman utama Anda.

8. (Opsional) Untuk melihat kode yang akan dihasilkan berdasarkan pilihan parameter proyek yang Anda buat, pilih Lihat kode dari Hasilkan pratinjau proyek.

9. (Opsional) Pilih Lihat detail dari kartu cetak biru untuk melihat detail spesifik tentang cetak biru, seperti ikhtisar arsitektur cetak biru, koneksi dan izin yang diperlukan, dan jenis sumber daya yang dibuat cetak biru.

10. Pilih Buat proyek untuk membuat proyek monorepo Anda. Proyek tingkat root yang dibuat mengelola saling ketergantungan antar proyek dalam monorepo, serta menyediakan caching build dan manajemen ketergantungan.

    Untuk informasi selengkapnya tentang cetak biru proyek, lihat. Membuat proyek yang komprehensif dengan CodeCatalyst cetak biru

1. Di panel navigasi proyek monorepo Anda, pilih Blueprints, lalu pilih Add blueprint.

2. Pilih API cetak biru PDK- Ketik Aman, lalu pilih Berikutnya.

3. Di bawah Konfigurasi cetak biru, konfigurasikan parameter cetak biru:

   • Di bawah Model Language, pilih bahasa yang didefinisikan oleh API model.

   • Di bidang input teks Namespace, masukkan namespace untuk Anda. API

   • Di kolom input teks APInama, masukkan nama untuk AndaAPI.

   • Di bawah CDKbahasa, pilih bahasa pilihan Anda untuk menulis CDK infrastruktur untuk digunakan. API

   • Pilih menu tarik-turun bahasa Handler, lalu pilih bahasa yang ingin Anda terapkan penangan untuk operasi. API

   • Pilih menu dropdown format Dokumentasi, lalu pilih format yang Anda inginkan untuk menghasilkan API dokumentasi.

4. Di tab Perubahan kode, tinjau perubahan yang diusulkan. Perbedaan yang ditampilkan dalam permintaan tarik menunjukkan perubahan pada proyek Anda pada saat permintaan tarik dibuat.

5. Jika Anda puas dengan perubahan yang diusulkan yang akan dibuat saat cetak biru diterapkan, pilih Tambahkan cetak biru.

   Setelah permintaan tarik dibuat, 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.

   catatan

   Cetak biru tidak akan diterapkan sampai permintaan tarik disetujui dan digabungkan. Untuk informasi selengkapnya, silakan lihat Meninjau permintaan tarik dan Menggabungkan permintaan tarik.

6. Dari kolom Status, pilih Permintaan tarik tertunda untuk baris API cetak biru PDK- Ketik Aman, lalu pilih tautan permintaan tarik terbuka.

7. Pilih Gabung, pilih strategi penggabungan pilihan Anda, lalu pilih Gabung untuk menggabungkan perubahan dari cetak biru yang diterapkan.

   Setelah permintaan tarik digabungkan, packages/apis/mypdkapi folder baru dihasilkan dalam proyek monorepo Anda, yang berisi semua kode sumber API terkait untuk Type Safe yang dikonfigurasi. API

8. Di panel navigasi, pilih Cetak Biru untuk mengonfirmasi bahwa Status PDK - Jenis Aman API ditampilkan Terbaru.

1. Di panel navigasi proyek monorepo Anda, pilih Blueprints, lalu pilih Add blueprint.

2. Pilih cetak biru PDK- Cloudscape React Website, lalu pilih Berikutnya.

3. Di bawah Konfigurasi cetak biru, konfigurasikan parameter cetak biru:

   • Di kolom input teks nama situs web, masukkan nama untuk situs web Anda.

   • Pilih menu APIs tarik-turun Type Safe, lalu pilih API cetak biru yang ingin Anda integrasikan dalam situs web. Melewati pengaturan klien API yang diautentikasi dan menambahkan dependensi, API penjelajah, dan kemampuan lainnya yang diperlukan.

4. Di tab Perubahan kode, tinjau perubahan yang diusulkan. Perbedaan yang ditampilkan dalam permintaan tarik menunjukkan perubahan pada proyek Anda pada saat permintaan tarik dibuat.

5. Jika Anda puas dengan perubahan yang diusulkan yang akan dibuat saat cetak biru diterapkan, pilih Tambahkan cetak biru.

   Setelah permintaan tarik dibuat, 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.

   catatan

   Cetak biru tidak akan diterapkan sampai permintaan tarik disetujui dan digabungkan. Untuk informasi selengkapnya, silakan lihat Meninjau permintaan tarik dan Menggabungkan permintaan tarik.

6. Dari kolom Status, pilih Permintaan tarik tertunda untuk baris cetak biru PDK- Cloudscape React Website, lalu pilih tautan permintaan tarik terbuka.

7. Pilih Gabung, pilih strategi penggabungan pilihan Anda, lalu pilih Gabung untuk menggabungkan perubahan dari cetak biru yang diterapkan.

   Setelah permintaan tarik digabungkan, packages/websites/my-website-name folder baru dihasilkan dalam proyek monorepo Anda, yang berisi semua kode sumber untuk situs web baru Anda.

8. Di panel navigasi, pilih Blueprints untuk mengonfirmasi bahwa Status Situs Web PDK- Cloudscape React muncul Terbaru.

1. Di panel navigasi proyek monorepo Anda, pilih Blueprints, lalu pilih Add blueprint.

2. Pilih cetak biru PDK- Infrastruktur, lalu pilih Berikutnya.

3. Di bawah Konfigurasi cetak biru, konfigurasikan parameter cetak biru:

   • Di bawah CDKbahasa, pilih bahasa yang Anda inginkan untuk mengembangkan infrastruktur Anda.

   • Di bidang input teks nama Stack, masukkan nama CloudFormation tumpukan yang dihasilkan untuk cetak biru Anda.

     catatan

     Catat nama tumpukan ini untuk langkah berikutnya, di mana Anda akan mengatur DevOps alur kerja.

   • Pilih menu APIs tarik-turun Type Safe, lalu pilih API cetak biru yang ingin Anda integrasikan dalam situs web.

   • Pilih menu dropdown Cloudscape React TS Websites, lalu pilih cetak biru situs web yang ingin Anda terapkan dalam infrastruktur Anda (misalnya, - Situs Web Cloudscape React). PDK

4. Di tab Perubahan kode, tinjau perubahan yang diusulkan. Perbedaan yang ditampilkan dalam permintaan tarik menunjukkan perubahan pada proyek Anda pada saat permintaan tarik dibuat.

5. Jika Anda puas dengan perubahan yang diusulkan yang akan dibuat saat cetak biru diterapkan, pilih Tambahkan cetak biru.

   Setelah permintaan tarik dibuat, 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.

   catatan

   Cetak biru tidak akan diterapkan sampai permintaan tarik disetujui dan digabungkan. Untuk informasi selengkapnya, silakan lihat Meninjau permintaan tarik dan Menggabungkan permintaan tarik.

6. Dari kolom Status, pilih Permintaan tarik tertunda untuk baris cetak biru PDK- Infrastruktur, lalu pilih tautan permintaan tarik terbuka.

7. Pilih Gabung, pilih strategi penggabungan pilihan Anda, lalu pilih Gabung untuk menggabungkan perubahan dari cetak biru yang diterapkan.

   Setelah permintaan tarik digabungkan, packages/infra folder baru dibuat dalam proyek monorepo Anda, yang berisi infrastruktur yang akan menyebarkan proyek Anda ke cloud. AWS

8. Di panel navigasi, pilih Cetak biru untuk mengonfirmasi bahwa Status PDK - Infrastruktur ditampilkan Terbaru.

1. Di panel navigasi proyek monorepo Anda, pilih Blueprints, lalu pilih Add blueprint.

2. Pilih PDK- DevOps cetak biru, lalu pilih Berikutnya.

3. Di bawah Konfigurasi cetak biru, konfigurasikan parameter cetak biru:

   • Pilih Bootstrap CDK di environemnt saat ini.

   • Di bidang input teks nama Stack, masukkan nama CloudFormation tumpukan yang ingin Anda gunakan. Ini harus cocok dengan nama tumpukan yang dikonfigurasi Langkah 4: Hasilkan infrastruktur untuk menyebarkan aplikasi ke cloud AWS untuk cetak biru PDK- Infrastruktur.

   • Pilih menu tarik-turun koneksi AWS akun, lalu pilih AWS akun yang ingin Anda gunakan untuk sumber daya. Untuk informasi selengkapnya, lihat Menambahkan Akun AWS ke spasi.

   • Pilih Peran yang akan digunakan untuk menerapkan menu tarik-turun aplikasi Anda, lalu pilih IAM peran yang ingin Anda gunakan untuk menyebarkan aplikasi proyek Anda.

     catatan

     Saat membuat IAM peran, batasi SourceArn ke saat ini yang ProjectID ditemukan dalam pengaturan proyek. Untuk informasi selengkapnya, lihat Memahami peran CodeCatalystWorkflowDevelopmentRole-spaceNamelayanan.

   • Pilih menu tarik-turun Wilayah, lalu pilih wilayah yang ingin Anda gunakan proyek monorepo Anda. Penerapan hanya berfungsi di wilayah di mana AWS layanan yang diperlukan ada. Untuk informasi selengkapnya, lihat AWSLayanan menurut Wilayah.

4. Di tab Perubahan kode, tinjau perubahan yang diusulkan. Perbedaan yang ditampilkan dalam permintaan tarik menunjukkan perubahan pada proyek Anda pada saat permintaan tarik dibuat.

5. Jika Anda puas dengan perubahan yang diusulkan yang akan dibuat saat cetak biru diterapkan, pilih Tambahkan cetak biru.

   Setelah permintaan tarik dibuat, 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.

   catatan

   Cetak biru tidak akan diterapkan sampai permintaan tarik disetujui dan digabungkan. Untuk informasi selengkapnya, silakan lihat Meninjau permintaan tarik dan Menggabungkan permintaan tarik.

6. Dari kolom Status, pilih Permintaan tarik tertunda untuk baris cetak biru PDK- Infrastruktur, lalu pilih tautan permintaan tarik terbuka.

7. Pilih Gabung, pilih strategi penggabungan pilihan Anda, lalu pilih Gabung untuk menggabungkan perubahan dari cetak biru yang diterapkan.

   Setelah permintaan tarik digabungkan, .codecatalyst/workflows folder baru dihasilkan dalam proyek monorepo Anda.

8. Di panel navigasi, pilih Cetak biru untuk mengonfirmasi bahwa Status PDK - DevOps ditampilkan Terbaru.

1. Di panel navigasi proyek monorepo Anda, pilih CI/CD, lalu pilih Alur kerja.

2. Untuk alur kerja rilis, pilih alur kerja terbaru yang dijalankan untuk melihat detailnya. Untuk informasi selengkapnya, lihat Melihat status dan detail dari satu run.

3. Setelah alur kerja berhasil diselesaikan, pilih tindakan terakhir dalam alur kerja (misalnya, Deploy-B eta-ap-souteast -2, lalu pilih Variabel.

   

4. Lihat situs web yang digunakan dengan menyalin dan menempelkan tautan yang ditemukan di tabel Variabel (misalnya, MyPDKApiwebsiteDistributionDomainNama XXXXX) ke jendela browser baru.

   

   Anda memerlukan akun Amazon Cognito untuk masuk ke situs web Anda. Secara default, kumpulan pengguna tidak diatur untuk mengizinkan pendaftaran mandiri.

   1. Arahkan ke konsol AWSCognito.

   2. Dari tabel kumpulan Pengguna, pilih nama kumpulan Pengguna yang cocok dengan kumpulan pengguna yang dibuat oleh PDK- DevOps cetak biru, yang dapat ditemukan di tabel Variabel (misalnya, infra calculatebetaUserIdentityinfracalculatebetaUserIdentityIdentityPoolIdXXXXX. Untuk informasi selengkapnya, lihat Memulai dengan kumpulan pengguna.

      

   3. Pilih Create user (Buat pengguna).

   4. Konfigurasikan parameter informasi pengguna:

      • Di bawah Pesan undangan, pilih Kirim undangan email.

      • Di kolom masukan teks nama pengguna, masukkan nama pengguna.

      • Di bidang masukan teks alamat email, masukkan nama pengguna.

      • Di bawah Kata sandi sementara, pilih Buat kata sandi.

   5. Pilih Create user (Buat pengguna).

   6. Arahkan ke akun email yang Anda masukkan untuk parameter informasi Pengguna, buka email dengan kata sandi sementara. Catat kata sandi.

   7. Arahkan kembali ke situs web yang digunakan, masukkan nama pengguna yang Anda buat dan kata sandi sementara yang Anda terima, lalu pilih Masuk.

5. (Opsional) Setelah alur kerja berhasil diselesaikan, Anda juga dapat melihat diagram yang dihasilkan. Pilih tab Artefak di CodeCatalyst, pilih Unduh untuk baris Diagram, lalu buka file yang diunduh.

   
   

Untuk mengundang anggota ke proyek Anda dari tab Pengaturan proyek

1. Arahkan ke proyek Anda.

   Tip

   Anda dapat memilih proyek mana yang akan dilihat di bilah navigasi atas.

2. Di panel navigasi, pilih Pengaturan proyek.

3. Pilih tab Anggota.

4. Di anggota Project, pilih Undang anggota baru.

5. Ketik alamat email anggota baru, pilih peran untuk anggota ini, lalu pilih Undang. Untuk informasi lebih lanjut tentang peran, lihat Memberikan akses dengan peran pengguna.

Untuk mengundang anggota ke proyek Anda dari halaman ikhtisar Proyek

1. Arahkan ke proyek Anda.

   Tip

   Anda dapat memilih proyek mana yang akan dilihat di bilah navigasi atas.

2. Pilih tombol Anggota +.

3. Ketik alamat email anggota baru, pilih peran untuk anggota ini, lalu pilih Undang. Untuk informasi lebih lanjut tentang peran, lihat Memberikan akses dengan peran pengguna.

1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

2. Arahkan ke proyek monorepo Anda di mana Anda ingin membuat masalah.

3. Pada halaman beranda proyek, pilih Buat masalah. Atau, di panel navigasi, pilih Masalah.

4. Pilih Buat masalah.

   catatan

   Anda juga dapat menambahkan masalah sebaris saat menggunakan tampilan kisi.

5. Masukkan judul untuk masalah ini.

6. (Opsional) Masukkan Deskripsi. Untuk masalah ini, masukkan deskripsi berikut:a change in the src/mysfit_data.json file.. Anda dapat menggunakan Markdown untuk menambahkan pemformatan.

7. (Opsional) Pilih Status, Prioritas, Estimasi untuk masalah ini.

8. (Opsional) Tambahkan label yang ada atau buat label baru dan tambahkan dengan memilih+Tambahkan label.

   1. Untuk menambahkan label yang ada, pilih label dari daftar. Anda dapat memasukkan istilah pencarian di bidang untuk mencari semua label yang berisi istilah itu dalam proyek.

   2. Untuk membuat label baru dan menambahkannya, masukkan nama label yang ingin Anda buat di bidang pencarian dan tekan enter.

9. (Opsional) Tambahkan penerima tugas dengan memilih + Tambahkan penerima tugas. Anda dapat dengan cepat menambahkan diri Anda sebagai penerima tugas dengan memilih + Tambahkan saya.

   Tip

   Anda dapat memilih untuk menetapkan masalah ke Amazon Q agar Amazon Q mencoba menyelesaikan masalah tersebut. Untuk informasi selengkapnya, lihat Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda.

   Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut. Untuk informasi selengkapnya, lihat Mengelola fitur AI generatif.

10. (Opsional) Tambahkan bidang kustom yang ada atau buat bidang kustom baru. Masalah dapat memiliki beberapa bidang khusus.

    1. Untuk menambahkan bidang kustom yang ada, pilih bidang kustom dari daftar. Anda dapat memasukkan istilah pencarian di bidang untuk mencari semua bidang kustom yang berisi istilah itu dalam proyek.

    2. Untuk membuat bidang kustom baru dan menambahkannya, masukkan nama bidang khusus yang ingin Anda buat di bidang pencarian dan tekan enter. Kemudian pilih jenis bidang khusus yang ingin Anda buat dan tetapkan nilainya.

11. Pilih Buat masalah. Pemberitahuan muncul di sudut kanan bawah: Jika masalah berhasil dibuat, pesan konfirmasi muncul yang mengatakan masalah berhasil dibuat. Jika masalah tidak berhasil dibuat, pesan kesalahan dengan alasan kegagalan muncul. Anda kemudian dapat memilih Coba lagi untuk mengedit dan mencoba lagi membuat masalah, atau memilih Buang untuk membuang masalah. Kedua opsi akan mengabaikan notifikasi.

    catatan

    Anda tidak dapat menautkan permintaan tarik ke masalah saat Anda membuatnya. Namun, Anda dapat mengeditnya setelah Anda membuatnya untuk menambahkan tautan ke permintaan tarik.

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.

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

1. Di panel navigasi proyek monorepo Anda, lakukan salah satu hal berikut:

   • Pilih Ikhtisar, lalu arahkan ke bagian My Dev Environments.

   • Pilih Kode, lalu pilih Lingkungan Dev.

   • Pilih Kode, pilih repositori Sumber, dan kemudian pilih repositori monorepo yang ingin Anda buat Lingkungan Dev.

2. Pilih yang didukung IDE dari menu tarik-turun. Untuk informasi selengkapnya, lihat Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Dev.

3. Pilih Kloning repositori.

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

   catatan

   Jika Anda membuat Lingkungan Dev dari halaman repositori Sumber atau dari repositori sumber tertentu, Anda tidak perlu memilih repositori. Lingkungan Dev akan dibuat dari repositori sumber yang Anda pilih dari halaman repositori Sumber.

5. (Opsional) Di Alias - opsional, masukkan alias untuk Lingkungan Pengembang.

6. (Opsional) Pilih tombol edit konfigurasi Lingkungan Dev untuk mengedit konfigurasi komputasi, penyimpanan, atau batas waktu Dev Environment.

7. (Opsional) Di Amazon Virtual Private Cloud (AmazonVPC) - opsional, pilih VPC koneksi yang ingin Anda kaitkan dengan Lingkungan Pengembang Anda dari menu tarik-turun.

   Jika default VPC disetel untuk ruang Anda, Lingkungan Dev Anda akan berjalan terhubung dengan ituVPC. Anda dapat mengganti ini dengan mengaitkan koneksi yang berbedaVPC. Juga, perhatikan bahwa Lingkungan Dev VPC yang terhubung tidak mendukung AWS Toolkit.

   catatan

   Saat Anda membuat Lingkungan Dev dengan VPC koneksi, antarmuka jaringan baru dibuat di dalam file. VPC CodeCatalyst berinteraksi dengan antarmuka ini menggunakan VPC peran terkait. Juga, pastikan bahwa IPv4 CIDR blok Anda tidak dikonfigurasi ke rentang alamat 172.16.0.0/12 IP.

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

1. Di terminal kerja Dev Environment Anda, navigasikan ke proyek monorepo Anda, lalu instal dependensi proyek Anda dengan menjalankan perintah berikut:

   npx projen install

2. Arahkan kepackages/apis/mypdkapi/model/src/main/smithy/operations/say-hello.smithy, yang mendefinisikan API operasi contoh. Dalam tutorial ini, Anda akan membangun Calculate operasi sederhana yang menambahkan dua angka bersama-sama. Buat perubahan pada kode untuk menentukan operasi ini, termasuk input dan outputnya.

   Contoh:

   $version: "2"
   namespace com.aws
   
   @http(method: "POST", uri: "/calculate")
   @handler(language: "typescript")
   operation Calculate {
       input := {
           @required
           numberA: Integer
           @required
           numberB: Integer
       }
       output := {
           @required
           result: Integer
       }
   }

   @handlerSifat ini memberi tahu Type Safe API bahwa Anda akan menerapkan operasi ini sebagai penangan AWS Lambda yang ditulis. TypeScript Type Safe API akan menghasilkan rintisan untuk operasi ini untuk Anda terapkan. TypeScript @requiredSifat ditambahkan, yang berarti akan diberlakukan saat runtime oleh API gateway yang akan diterapkan. Untuk informasi lebih lanjut, lihat dokumentasi Smithy.

3. Ganti nama /say-hello.smithy file dengan nama yang sejajar dengan perubahan kode Anda (misalnya,). calculate.smithy

4. Arahkan kepackages/apis/mypdkapi/model/src/main/smithy/main.smithy, dan buat perubahan pada kode untuk menghubungkan operasi. Anda dapat mengekspos Calculate operasi yang ditentukan dalam /calculate.smithy dengan mencantumkannya di operations bidang file ini.

   Contoh:

   $version: "2"
   namespace com.aws
   
   use aws.protocols#restJson1
   
   /// A sample smithy api
   @restJson1
   service MyPDKApi {
       version: "1.0"
       operations: [Calculate]
       errors: [
         BadRequestError
         NotAuthorizedError
         InternalFailureError
       ]
   }

5. Bangun perubahan dengan menjalankan perintah berikut:

   npx projen build

   catatan

   Secara opsional, Anda dapat meneruskan --parallel X flag, yang akan mendistribusikan build di seluruh X core.

   Sejak @handler sifat ditambahkan, file berikut dibuat setelah build selesai:

   • /packages/apis/mypdkapi/handlers/typescript/src/calculate.ts

   • /packages/apis/mypdkapi/handlers/typescript/test/calculate.test.ts

6. Arahkan kepackages/apis/mypdkapi/handlers/typescript/src/calculate.ts, dan buat perubahan pada kode. File ini adalah handler server yang dipanggil untuk file. API

   import {
     calculateHandler,
     CalculateChainedHandlerFunction,
     INTERCEPTORS,
     Response,
     LoggingInterceptor,
   } from 'mypdkapi-typescript-runtime';
   
   /**
    * Type-safe handler for the Calculate operation
    */
   export const calculate: CalculateChainedHandlerFunction = async (request) => {
     LoggingInterceptor.getLogger(request).info('Start Calculate Operation');
   
     const { input } = request;
   
     return Response.success({
       result: input.body.numberA + input.body.numberB,
     });
   };
   
   /**
    * Entry point for the AWS Lambda handler for the Calculate operation.
    * The calculateHandler method wraps the type-safe handler and manages marshalling inputs and outputs
    */
   export const handler = calculateHandler(...INTERCEPTORS, calculate);

7. Arahkan ke /packages/apis/mypdkapi/handlers/typescript/test/calculate.test.ts file, dan buat perubahan pada kode untuk memperbarui pengujian unit.

   Contoh:

   import {
     CalculateChainedRequestInput,
     CalculateResponseContent,
   } from 'mypdkapi-typescript-runtime';
   import {
     calculate,
   } from '../src/calculate';
   
   // Common request arguments
   const requestArguments = {
     chain: undefined as never,
     event: {} as any,
     context: {} as any,
     interceptorContext: {
       logger: {
         info: jest.fn(),
       },
     },
   } satisfies Omit<CalculateChainedRequestInput, 'input'>;
   
   describe('Calculate', () => {
   
     it('should return correct sum', async () => {
       const response = await calculate({
         ...requestArguments,
         input: {
           requestParameters: {},
           body: {
             numberA: 1,
             numberB: 2
           }
         },
       });
   
       expect(response.statusCode).toBe(200);
       expect((response.body as CalculateResponseContent).result).toEqual(3);
     });
   
   });

8. Arahkan ke /packages/infra/main/src/constructs/apis/mypdkapi.ts file, dan buat perubahan pada kode untuk menambahkan integrasi untuk Calculate operasi di CDK infrastruktur Anda. APIKonstruk memiliki properti integrasi, di mana Anda dapat meneruskan implementasi yang Anda tambahkan sebelumnya. Karena Anda menggunakan @handler sifat dalam model Smithy Anda untuk Calculate operasi, Anda dapat menggunakan CalculateFunction CDK konstruksi yang dihasilkan, yang telah dikonfigurasi sebelumnya, untuk menunjuk ke implementasi handler Anda.

   Contoh:

   import { UserIdentity } from "@aws/pdk/identity";
   import { Authorizers, Integrations } from "@aws/pdk/type-safe-api";
   import { Stack } from "aws-cdk-lib";
   import { Cors } from "aws-cdk-lib/aws-apigateway";
   import {
     AccountPrincipal,
     AnyPrincipal,
     Effect,
     PolicyDocument,
     PolicyStatement,
   } from "aws-cdk-lib/aws-iam";
   import { Construct } from "constructs";
   import { Api, CalculateFunction } from "calculateapi-typescript-infra";
   
   /**
    * Api construct props.
    */
   export interface CalculateApiProps {
     /**
      * Instance of the UserIdentity.
      */
     readonly userIdentity: UserIdentity;
   }
   
   /**
    * Infrastructure construct to deploy a Type Safe API.
    */
   export class CalculateApi extends Construct {
     /**
      * API instance
      */
     public readonly api: Api;
   
     constructor(scope: Construct, id: string, props?: CalculateApiProps) {
       super(scope, id);
   
       this.api = new Api(this, id, {
         defaultAuthorizer: Authorizers.iam(),
         corsOptions: {
           allowOrigins: Cors.ALL_ORIGINS,
           allowMethods: Cors.ALL_METHODS,
         },
         integrations: {
           calculate: {
             integration: Integrations.lambda(new CalculateFunction(this, "CalculateFunction"))
           }
         },
         policy: new PolicyDocument({
           statements: [
             // Here we grant any AWS credentials from the account that the prototype is deployed in to call the api.
             // Machine to machine fine-grained access can be defined here using more specific principals (eg roles or
             // users) and resources (ie which api paths may be invoked by which principal) if required.
             // If doing so, the cognito identity pool authenticated role must still be granted access for cognito users to
             // still be granted access to the API.
             new PolicyStatement({
               effect: Effect.ALLOW,
               principals: [new AccountPrincipal(Stack.of(this).account)],
               actions: ["execute-api:Invoke"],
               resources: ["execute-api:/*"],
             }),
             // Open up OPTIONS to allow browsers to make unauthenticated preflight requests
             new PolicyStatement({
               effect: Effect.ALLOW,
               principals: [new AnyPrincipal()],
               actions: ["execute-api:Invoke"],
               resources: ["execute-api:/*/OPTIONS/*"],
             }),
           ],
         }),
       });
   
       // Grant authenticated users access to invoke the api
       props?.userIdentity.identityPool.authenticatedRole.addToPrincipalPolicy(
         new PolicyStatement({
           effect: Effect.ALLOW,
           actions: ["execute-api:Invoke"],
           resources: [this.api.api.arnForExecuteApi("*", "/*", "*")],
         }),
       );
     }
   }

9. Bangun perubahan dengan menjalankan perintah berikut:

   npx projen build

• Komit dan dorong perubahan ke cabang fitur Anda dengan menjalankan perintah berikut:

  git add .

  git commit -m "my commit message"

  git push

1. Dalam proyek monorepo Anda, lakukan salah satu hal 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.

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

3. Di cabang Tujuan, pilih cabang utama untuk menggabungkan kode setelah ditinjau.

4. Di cabang Sumber, pilih cabang fitur yang berisi kode komit.

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

6. (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 tersebut. Untuk informasi selengkapnya, lihat Mengelola fitur AI generatif di Amazon CodeCatalyst.

7. Dalam Masalah, pilih Masalah tautan, lalu pilih masalah yang Anda buatLangkah 2: Buat masalah untuk berkolaborasi dan melacak pekerjaan. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.

8. (Opsional) Di Reviewer wajib, pilih Tambahkan pengulas yang diperlukan. Pilih dari daftar anggota proyek untuk menambahkannya. Pengulas yang diperlukan harus menyetujui perubahan sebelum permintaan tarik dapat digabungkan ke cabang tujuan.

   catatan

   Anda tidak dapat menambahkan reviewer sebagai reviewer wajib dan reviewer opsional. Anda tidak dapat menambahkan diri Anda sebagai reviewer.

9. (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.

10. Permintaan tarik Anda harus ditinjau dan digabungkan ke cabang utama oleh pengulas atau Anda sendiri. Untuk informasi selengkapnya, lihat Menggabungkan permintaan tarik.

    Saat perubahan Anda digabungkan ke cabang utama repositori sumber Anda, alur kerja baru akan dipicu secara otomatis.

11. Setelah penggabungan selesai, Anda dapat memindahkan masalah Anda ke Selesai.

    1. Di panel navigasi, pilih Masalah.

    2. Pilih masalah yang dibuatLangkah 2: Buat masalah untuk berkolaborasi dan melacak pekerjaan, pilih tarik-turun Status, lalu pilih Selesai.

1. Di panel navigasi proyek monorepo Anda, pilih CI/CD, lalu pilih Alur kerja.

2. Untuk alur kerja rilis, pilih alur kerja terbaru yang dijalankan untuk melihat detailnya. Untuk informasi selengkapnya, lihat Melihat status dan detail dari satu run.

3. Setelah alur kerja berhasil diselesaikan, pilih tindakan terakhir dalam alur kerja (Deploy-B eta-ap-souteast -2), lalu pilih Variabel.

4. Lihat situs web yang digunakan dengan menyalin dan menempelkan tautan dari MyPDKApiwebsiteDistributionDomainNama XXXXX baris ke jendela browser baru.

5. Masukkan nama pengguna dan kata sandi yang Anda buatLangkah 6: Konfirmasikan alur kerja rilis dan lihat situs web Anda, lalu pilih Masuk.

6. (Opsional) Uji perubahan dalam aplikasi Anda.

   1. Pilih menu POSTdropdown.

   2. Masukkan dua nilai untuk numberA dannumber B, lalu pilih Execute.

   3. Konfirmasikan hasilnya di badan Response.