Tutorial: Membuat proyek dengan cetak biru aplikasi web tiga tingkat Modern - Amazon CodeCatalyst
PrasyaratLangkah 1: Buat proyek aplikasi web tiga tingkat modernLangkah 2: Undang seseorang ke proyek AndaLangkah 3: Buat masalah untuk berkolaborasi dan melacak pekerjaanLangkah 4: Lihat repositori sumber AndaLangkah 5: Buat Lingkungan Pengembang dengan cabang pengujian dan buat perubahan kode cepatLangkah 6: Lihat alur kerja yang membangun aplikasi modernLangkah 7: Minta orang lain untuk meninjau perubahan AndaLangkah 8: Tutup masalahPembersihan sumber dayaReferensi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Membuat proyek dengan cetak biru aplikasi web tiga tingkat Modern

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 AWS 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 AWS 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

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 dengan kode sampel dan alur kerja YAMB

  • Alur kerja 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, lihatReferensi.

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 biru

Prasyarat

Untuk membuat proyek aplikasi modern dalam tutorial ini, Anda harus telah menyelesaikan tugas-tugas Siapkan dan masuk ke CodeCatalyst sebagai berikut:

Langkah 1: Buat proyek aplikasi web tiga tingkat modern

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

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

  3. Pilih Buat proyek.

  4. Pilih Mulai dengan cetak biru.

  5. Di bilah pencarian, masukkanmodern.

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

  7. Dalam Nama proyek Anda, masukkan nama proyek. Sebagai contoh:

    MyExampleProject.

    catatan

    Nama harus unik di ruang Anda.

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

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

  10. Di platform Compute, pilih Lambda.

  11. Di Opsi Hosting Frontend, pilih Amplify Hosting. Untuk selengkapnya AWS Amplify, lihat Apa itu AWS Amplify Hosting? dalam AWS Amplify User Guide.

  12. 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 di. Referensi Umum AWS

  13. Dalam nama Aplikasi, biarkan default darimysfitsstring.

  14. (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 alur kerja CI/CD yang akan diinstal cetak biru. Pratinjau diperbarui secara dinamis berdasarkan pilihan Anda.

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

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.

  2. Di panel navigasi, pilih Pengaturan proyek.

  3. Pada tab Anggota, pilih Undang.

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

  5. Pilih peran untuk pengguna.

    Setelah selesai menambahkan pengguna, pilih Undang.

Langkah 3: Buat masalah untuk berkolaborasi dan melacak pekerjaan

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.

  2. Pilih Buat masalah.

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

  4. Pilih prioritas, estimasi, status, dan label. Di bawah penerima tugas, pilih +Tambahkan saya untuk menetapkan masalah untuk diri Anda sendiri.

  5. 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 CodeCatalyst.

Langkah 4: Lihat repositori sumber Anda

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 alur kerja CI/CD 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.

  • Dockerfilefile - Menjelaskan wadah aplikasi.

  • README.mdfile - 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.

  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.

Langkah 5: Buat Lingkungan Pengembang dengan cabang pengujian dan buat perubahan kode cepat

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

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

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

  4. Pada halaman rumah repositori, pilih Create Dev Environment.

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

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

  7. Secara opsional, tambahkan alias untuk Lingkungan Dev.

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

  9. 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. Perluasmysfits,src, dan bukasrc/mysfit_data.json.

  2. 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"
    },

  3. Simpan file tersebut.

  4. Ubah ke repositori mysfits dengan perintah. cd /projects/mysfits

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

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.

  2. 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 Alur kerja ini adalah klon alur kerja di cabang. main ApplicationDeploymentPipelineIni tidak aktif karena dikonfigurasi untuk digunakan dengan main cabang. OnPullRequestAlur 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. ApplicationDeploymentPipelineAlur kerja aktif dan berjalan dalam proses (atau selesai).

      catatan

      Jika proses ApplicationDeploymentPipelinegagal dengan Build @cdk_bootstrap atau DeployBackendkesalahan, 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.

  3. Pilih ApplicationDeploymentPipelinealur 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

  4. Pilih tab Definisi (dekat bagian atas). File definisi alur kerja muncul di sebelah kanan. File ini memiliki bagian penting berikut:

    • TriggersBagian, di bagian atas. Bagian ini menunjukkan bahwa alur kerja harus dimulai setiap kali kode didorong ke cabang repositori sumber. main Mendorong ke cabang lain (sepertitest) tidak akan memulai alur kerja ini. Alur kerja berjalan menggunakan file di main cabang.

    • ActionsBagian, di bawahTriggers. Bagian ini mendefinisikan tindakan yang Anda lihat dalam diagram alur kerja.

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

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

  7. Biarkan konsol terbuka dan pergi ke prosedur berikutnya.

Untuk meninjau log build dan laporan pengujian

  1. Pilih tab Status terbaru.

  2. Dalam diagram alur kerja, pilih DeployFrontendtindakan.

  3. Tunggu sampai aksi selesai. Perhatikan ikon “dalam proses” ( Workflow in progress. ) untuk berubah menjadi ikon “sukses” ( Workflow success. ).

  4. Pilih tindakan build_backend.

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

  6. 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, lihatPengujian dengan alur kerja.

    Tip

    Anda juga dapat melihat laporan pengujian dengan memilih Laporan di panel navigasi.

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

Untuk mengonfirmasi bahwa aplikasi modern berhasil digunakan

  1. Kembali ke ApplicationDeploymentPipelinealur kerja, dan pilih tautan Run- string dari proses terbaru.

  2. Dalam diagram alur kerja, temukan DeployFrontendtindakan dan pilih tautan Lihat aplikasi. Situs web Mysfit muncul.

    catatan

    Jika Anda tidak melihat tautan Lihat aplikasi di dalam DeployFrontendtindakan, pastikan Anda memilih tautan run ID.

  3. Cari pegasus Mysfit bernama Twilight Glitter. Perhatikan nilai untuk usia. Ini adalah6. Anda akan membuat perubahan kode untuk memperbarui usia.

Langkah 7: Minta orang lain untuk meninjau perubahan Anda

Sekarang setelah Anda memiliki perubahan di cabang bernamatest, 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.

  2. Lakukan salah satu hal berikut ini:

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

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

  4. Di cabang Tujuan, pilih cabang untuk menggabungkan kode setelah ditinjau.

  5. Di cabang Sumber, pilih cabang yang berisi kode komit.

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

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

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

  9. (Opsional) Di Reviewer yang diperlukan, 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.

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

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

  12. 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, OnPullRequestalur 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.

Untuk menggabungkan permintaan tarik dari konsol CodeCatalyst

  1. Arahkan ke proyek aplikasi modern Anda.

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

  3. 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) dan dokumentasi Git Anda.

Setelah Anda menggabungkan perubahan dari test cabang ke main cabang, perubahan secara otomatis memulai ApplicationDeploymentPipelinealur kerja yang membangun dan menyebarkan perubahan Anda.

Untuk melihat komit gabungan berjalan melalui alur kerja ApplicationDeploymentPipeline

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

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

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

Langkah 8: Tutup masalah

Ketika masalah teratasi, itu dapat ditutup di CodeCatalyst konsol.

Untuk menutup masalah untuk sebuah proyek

  1. Arahkan ke proyek Anda.

  2. Di panel navigasi, pilih Masalah.

  3. D rag-and-drop masalah ke kolom Selesai.

Untuk informasi selengkapnya, lihat Lacak dan atur pekerjaan dengan masalah di CodeCatalyst.

Pembersihan sumber daya

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.

  2. Pilih tab Umum.

  3. Di bawah nama proyek, pilih Hapus proyek.

Untuk menghapus sumber daya di AWS CloudFormation dan Amazon S3

  1. Masuk ke akun AWS Management Console dengan akun yang sama yang Anda tambahkan ke CodeCatalyst ruang Anda.

  2. Pergi ke AWS CloudFormationlayanan.

  3. Hapus tumpukan string mysfits.

  4. Hapus tumpukan string development-mysfits.

  5. Pilih (tapi jangan hapus) tumpukan CDKToolkit. Pilih tab Sumber Daya. Pilih StagingBuckettautannya, 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.

  6. (Opsional) Hapus tumpukan CDKToolkit.

Referensi

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 ini berisi kode contoh untuk aplikasi web 'Mysfits'.

      • Alur kerja - Alur kerja ini membangun dan menyebarkan kode aplikasi Mysfits setiap kali perubahan dilakukan ke cabang default

      • Papan masalah dan backlog — Papan dan backlog ini dapat digunakan untuk merencanakan dan melacak pekerjaan.

      • Rangkaian laporan pengujian — Suite ini mencakup laporan otomatis yang disertakan dalam kode sampel.

  • Dalam yang terkait Akun AWS:

    • Tumpukan CDKToolkit - 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

      CDKToolkit tidak diruntuhkan dan dibuat ulang untuk setiap penerapan. Ini adalah tumpukan yang dimulai di setiap akun untuk mendukung. AWS CDK

    • BackEndTumpukan string development-mysfits - 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 string mysfits — Tumpukan ini menyebarkan aplikasi frontend. AWS Amplify

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.

  • Amazon API Gateway — Layanan untuk membuat, menerbitkan, memelihara, memantau, dan mengamankan REST, HTTP, dan WebSocket API pada skala apa pun Untuk informasi selengkapnya, lihat Panduan Pengembang API Gateway.

  • Amplify — Layanan untuk hosting aplikasi frontend Anda. Untuk informasi selengkapnya, lihat Panduan Pengguna AWS Amplify Hosting.

  • 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, lihat AWS Cloud Development Kit (AWS CDK) Panduan Developer.

  • Amazon DynamoDB — Layanan database NoSQL yang dikelola sepenuhnya untuk menyimpan data. Untuk informasi selengkapnya, lihat Panduan Developer Amazon DynamoDB.

  • AWS Lambda— Layanan untuk menjalankan kode Anda pada infrastruktur komputasi ketersediaan tinggi tanpa menyediakan atau mengelola server. Untuk informasi selengkapnya, lihat AWS Lambda Panduan Developer.

  • AWS IAM — Layanan untuk mengontrol akses AWS dan sumber dayanya dengan aman. Untuk informasi selengkapnya, lihat Panduan Pengguna IAM.