Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memulai dengan repositori CodeCatalyst sumber dan cetak biru aplikasi Single-page
Ikuti langkah-langkah dalam tutorial ini untuk mempelajari cara bekerja dengan repositori sumber di Amazon. CodeCatalyst
Cara tercepat untuk mulai bekerja dengan repositori sumber di Amazon CodeCatalyst adalah dengan membuat proyek menggunakan templat. Saat Anda membuat proyek menggunakan templat, sumber daya dibuat untuk Anda, termasuk repositori sumber yang menyertakan kode sampel. Anda dapat menggunakan contoh repositori dan kode ini untuk mempelajari cara:
-
Lihat repositori sumber proyek dan telusuri isinya
-
Buat Lingkungan Pengembang dengan cabang baru tempat Anda dapat mengerjakan kode
-
Ubah file, dan komit dan dorong perubahan Anda
-
Buat permintaan tarik dan tinjau perubahan kode Anda dengan anggota proyek lainnya
-
Lihat alur kerja untuk proyek Anda secara otomatis membangun dan menguji perubahan di cabang sumber permintaan tarik
-
Gabungkan perubahan Anda dari cabang sumber Anda ke cabang tujuan dan tutup permintaan tarik
-
Lihat perubahan gabungan yang dibuat dan diterapkan secara otomatis
Untuk mendapatkan hasil maksimal dari tutorial ini, undang orang lain ke proyek Anda sehingga Anda dapat bekerja sama pada permintaan tarik. Anda juga dapat menjelajahi fitur tambahan CodeCatalyst, seperti membuat masalah dan mengaitkannya dengan permintaan tarik, atau mengonfigurasi notifikasi dan mendapatkan peringatan saat alur kerja terkait berjalan. Untuk eksplorasi lengkap CodeCatalyst, lihatMemulai tutorial.
Membuat proyek dengan cetak biru
Membuat proyek adalah langkah pertama untuk dapat bekerja sama. Anda dapat menggunakan cetak biru untuk membuat proyek Anda, yang juga akan membuat repositori sumber dengan kode sampel dan alur kerja yang secara otomatis akan membangun dan menyebarkan kode Anda ketika Anda mengubahnya. Dalam tutorial ini, kami akan memandu Anda melalui proyek yang dibuat dengan cetak biru aplikasi Single-page, tetapi Anda dapat mengikuti prosedur untuk proyek apa pun dengan repositori sumber. Pastikan untuk memilih IAM peran atau menambahkan IAM peran jika Anda tidak memilikinya sebagai bagian dari pembuatan proyek. Kami menyarankan Anda menggunakan CodeCatalystWorkflowDevelopmentRole-spaceName
peran layanan untuk proyek ini.
Jika Anda sudah memiliki proyek, Anda dapat melompat ke depanMelihat repositori untuk sebuah proyek.
catatan
Hanya pengguna dengan administrator Space atau peran pengguna Power yang dapat membuat proyek CodeCatalyst. Jika Anda tidak memiliki peran ini dan Anda memerlukan proyek untuk dikerjakan untuk tutorial ini, mintalah seseorang dengan salah satu peran ini untuk membuat proyek untuk Anda dan menambahkan Anda ke proyek yang dibuat. Untuk informasi selengkapnya, lihat Memberikan akses dengan peran pengguna.
Untuk membuat proyek dengan cetak biru
-
Di CodeCatalyst konsol, arahkan ke ruang tempat Anda ingin membuat proyek.
-
Di dasbor ruang, pilih Buat proyek.
-
Pilih Mulai dengan cetak biru.
Tip
Anda dapat memilih untuk menambahkan cetak biru dengan memberikan Amazon Q persyaratan proyek Anda agar Amazon Q menyarankan cetak biru kepada Anda. Untuk informasi selengkapnya, lihat Menggunakan Amazon Q untuk memilih cetak biru saat membuat proyek atau menambahkan fungsionalitas dan Praktik terbaik saat menggunakan Amazon Q untuk membuat proyek atau menambahkan fungsionalitas dengan cetak biru. Fitur ini hanya tersedia di Wilayah AS Barat (Oregon).
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut. Untuk informasi selengkapnya, lihat Mengelola fitur AI generatif.
-
Dari cetak biru atau tab CodeCatalyst Blueprints Space, pilih cetak biru, lalu pilih Berikutnya.
-
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.
-
(Opsional) Secara default, kode sumber yang dibuat oleh cetak biru disimpan dalam repositori. CodeCatalyst Atau, Anda dapat memilih untuk menyimpan kode sumber cetak biru di repositori pihak ketiga. Untuk informasi selengkapnya, lihat Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalyst.
penting
CodeCatalyst tidak mendukung pendeteksian perubahan di cabang default untuk repositori tertaut. Untuk mengubah cabang default untuk repositori tertaut, Anda harus terlebih dahulu memutuskan tautannya CodeCatalyst, mengubah cabang default, dan kemudian menautkannya lagi. Untuk informasi selengkapnya, lihat Menautkan GitHub repositori, repositori Bitbucket, repositori GitLab proyek, dan proyek Jira di CodeCatalyst.
Sebagai praktik terbaik, selalu pastikan Anda memiliki versi ekstensi terbaru sebelum menautkan repositori.
Lakukan salah satu hal berikut tergantung pada penyedia repositori pihak ketiga yang ingin Anda gunakan:
-
GitHub repositori: Hubungkan akun. GitHub
Pilih menu tarik-turun Advanced, pilih GitHub sebagai penyedia repositori, lalu pilih GitHub akun tempat Anda ingin menyimpan kode sumber yang dibuat oleh cetak biru.
catatan
Jika Anda menghubungkan GitHub akun, Anda harus membuat koneksi pribadi untuk membuat pemetaan identitas antara CodeCatalyst identitas dan GitHub identitas Anda. Untuk informasi selengkapnya, lihat Koneksi pribadi dan Mengakses GitHub sumber daya dengan koneksi pribadi.
-
Repositori Bitbucket: Hubungkan ruang kerja Bitbucket.
Pilih menu tarik-turun Advanced, pilih Bitbucket sebagai penyedia repositori, lalu pilih ruang kerja Bitbucket tempat Anda ingin menyimpan kode sumber yang dibuat oleh cetak biru.
-
GitLab repositori: Hubungkan pengguna. GitLab
Pilih menu tarik-turun Advanced, pilih GitLab sebagai penyedia repositori, lalu pilih GitLab pengguna tempat Anda ingin menyimpan kode sumber yang dibuat oleh cetak biru.
-
-
Di bawah sumber daya Proyek, konfigurasikan parameter cetak biru. Tergantung pada cetak biru, Anda mungkin memiliki opsi untuk memberi nama nama repositori sumber.
-
(Opsional) Untuk melihat file definisi dengan pembaruan berdasarkan pilihan parameter proyek yang Anda buat, pilih Lihat kode atau Lihat alur kerja dari Hasilkan pratinjau proyek.
-
(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.
-
Pilih Buat proyek.
Halaman ikhtisar proyek terbuka segera setelah Anda membuat proyek atau menerima undangan ke proyek dan menyelesaikan proses masuk. Halaman ikhtisar proyek untuk proyek baru tidak berisi masalah terbuka atau permintaan tarik. Anda dapat memilih untuk membuat masalah dan menetapkannya untuk diri Anda sendiri. Anda juga dapat memilih untuk mengundang orang lain ke proyek Anda. Untuk informasi selengkapnya, lihat Membuat masalah di CodeCatalyst dan Mengundang pengguna ke proyek.
Melihat repositori untuk sebuah proyek
Sebagai anggota proyek, Anda dapat melihat repositori sumber untuk proyek tersebut. Anda juga dapat memilih untuk membuat repositori tambahan. Jika seseorang dengan peran administrator Space telah menginstal dan mengonfigurasi repositori, GitHub repositori Bitbucket, atau ekstensi repositori, Anda juga dapat menambahkan tautan ke GitLab repositori pihak ketiga di GitHub akun, ruang kerja Bitbucket, atau pengguna yang dikonfigurasi untuk ekstensi. GitLab Untuk informasi selengkapnya, lihat Membuat repositori sumber dan Mulai cepat: Menginstal ekstensi, menghubungkan penyedia, dan menautkan sumber daya di CodeCatalyst.
catatan
Untuk proyek yang dibuat dengan cetak biru aplikasi Single-page, nama default untuk repositori sumber yang berisi kode sampel adalah spa-app
.
Untuk menavigasi ke repositori sumber untuk sebuah proyek
-
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.
-
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.
Halaman ikhtisar untuk repositori mencakup informasi tentang alur kerja dan permintaan tarik yang dikonfigurasi untuk cabang repositori ini dan file-nya. Jika Anda baru saja membuat proyek, alur kerja awal untuk membangun, menguji, dan menyebarkan kode akan tetap berjalan, karena butuh beberapa menit untuk menyelesaikannya. Anda dapat melihat alur kerja terkait dan statusnya dengan memilih nomor di bawah alur kerja Terkait, tetapi ini membuka halaman Alur Kerja di CI/CD. Untuk tutorial ini, tetap di halaman ikhtisar dan jelajahi kode di repositori. Isi README.md
file ditampilkan pada halaman ini di bawah file repositori. Di File, isi cabang default ditampilkan. Anda dapat mengubah tampilan file untuk menampilkan isi cabang lain jika Anda memilikinya. .codecatalyst
Folder berisi kode yang digunakan untuk bagian lain dari proyek, seperti YAML file alur kerja.
Untuk melihat konten folder, pilih panah di sebelah nama folder untuk memperluasnya. Misalnya, pilih panah di sebelah src
untuk melihat file untuk aplikasi web satu halaman yang terdapat dalam folder itu. Untuk melihat isi dari sebuah file, pilih file tersebut dari daftar. Ini akan membuka Lihat file, di mana Anda dapat menelusuri konten beberapa file. Anda dapat mengedit file tunggal di konsol juga, tetapi untuk mengedit beberapa file, Anda akan ingin membuat Lingkungan Dev.
Membuat Lingkungan Dev
Anda dapat menambahkan dan mengubah file di repositori sumber di konsol Amazon CodeCatalyst . Namun, untuk bekerja secara efektif dengan banyak file dan cabang, kami sarankan menggunakan Dev Environment atau mengkloning repositori ke komputer lokal Anda. Dalam tutorial ini, kita akan membuat AWS Cloud9 Dev Environment dengan cabang bernamadevelop
. Anda dapat memilih nama cabang yang berbeda, tetapi dengan menamai cabangdevelop
, alur kerja akan secara otomatis berjalan untuk membangun dan menguji kode Anda ketika Anda membuat permintaan tarik nanti dalam tutorial ini.
Tip
Jika Anda memutuskan untuk mengkloning repositori lokal alih-alih atau selain menggunakan Lingkungan Pengembang, pastikan bahwa Anda memiliki Git di komputer lokal Anda atau bahwa Anda menyertakan Git. IDE Untuk informasi selengkapnya, lihat Menyiapkan untuk bekerja dengan repositori sumber.
Untuk membuat Lingkungan Dev dengan cabang baru
Buka CodeCatalyst konsol di https://codecatalyst.aws/
. Arahkan ke proyek tempat Anda ingin membuat Lingkungan Dev.
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.
Pada halaman rumah repositori, pilih Create Dev Environment.
Pilih yang didukung IDE dari menu tarik-turun. Untuk informasi selengkapnya, lihat Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Dev.
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.
Secara opsional, tambahkan alias untuk Lingkungan Dev.
Secara opsional, pilih tombol edit konfigurasi Lingkungan Dev untuk mengedit konfigurasi komputasi, penyimpanan, atau batas waktu Dev Environment.
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 sesuai IDE pilihan Anda. Anda dapat mengedit kode dan melakukan dan mendorong perubahan Anda.
Setelah Anda membuat Lingkungan Dev, Anda dapat mengedit file, melakukan perubahan, dan mendorong perubahan Anda ke test
cabang. Untuk tutorial ini, edit konten antara <p>
tag dalam App.tsx
file di src
folder untuk mengubah teks yang ditampilkan di halaman web. Komit dan dorong perubahan Anda, lalu kembali ke CodeCatalyst tab.
Untuk membuat dan mendorong perubahan dari Lingkungan AWS Cloud9 Pengembang
-
Di AWS Cloud9, perluas menu navigasi samping untuk menelusuri file. Perluas
src
, dan bukaApp.tsx
. -
Buat perubahan teks di dalam
<p>
tag. -
Simpan file, lalu komit dan dorong perubahan Anda dengan menggunakan menu Git. Atau, di jendela terminal, komit dan dorong perubahan Anda dengan git push perintah git commit dan.
git commit -am "Making an example change" git push
Tip
Anda mungkin perlu mengubah direktori di terminal ke direktori repositori Git sebelum Anda berhasil menjalankan perintah Git.
Membuat permintaan pull
Anda dapat menggunakan permintaan tarik untuk meninjau perubahan kode secara kolaboratif untuk perubahan kecil atau perbaikan, penambahan fitur utama, atau versi baru perangkat lunak yang dirilis. Dalam tutorial ini, Anda akan membuat permintaan tarik untuk meninjau perubahan yang Anda buat test
cabang dibandingkan dengan cabang utama. Membuat permintaan tarik dalam proyek yang dibuat dengan template juga akan memulai menjalankan alur kerja terkait, jika ada.
Untuk membuat permintaan tarik
-
Arahkan ke proyek Anda.
-
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.
-
-
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.
-
Di cabang Tujuan, pilih cabang untuk menggabungkan kode setelah ditinjau.
-
Di cabang Sumber, pilih cabang yang berisi kode komit.
-
Dalam judul permintaan tarik, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya.
-
(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.
-
(Opsional) Dalam Masalah, pilih Masalah tautan, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.
-
(Opsional) Di Reviewer wajib, 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 reviewer sebagai reviewer wajib dan reviewer opsional. Anda tidak dapat menambahkan diri Anda sebagai reviewer.
-
(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.
-
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.
-
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.
Anda dapat melihat informasi tentang alur kerja terkait yang dimulai dengan pembuatan permintaan tarik ini dengan memilih Ikhtisar dan kemudian meninjau informasi di area detail permintaan Tarik di bawah Alur kerja berjalan. Untuk melihat alur kerja berjalan, pilih run.
Tip
Jika Anda menamai cabang Anda sesuatu selaindevelop
, alur kerja tidak akan otomatis berjalan untuk membangun dan menguji perubahan Anda. Jika Anda ingin mengonfigurasinya, edit YAML file untuk onPullRequestBuildAndTestalur kerja. Untuk informasi selengkapnya, lihat Membuat alur kerja.
Anda dapat mengomentari permintaan tarik ini dan meminta anggota proyek lain untuk mengomentarinya. Anda juga dapat memilih untuk menambah atau mengubah pengulas opsional atau wajib. Anda dapat memilih untuk membuat lebih banyak perubahan pada cabang sumber untuk repositori, dan melihat bagaimana perubahan komit tersebut membuat revisi untuk permintaan tarik. Untuk informasi lebih lanjut, lihatMeninjau permintaan tarik,Memperbarui permintaan tarik,Meninjau kode dengan permintaan tarik di Amazon CodeCatalyst, danMelihat status dan detail alur kerja.
Menggabungkan permintaan tarik
Setelah permintaan tarik ditinjau dan telah menerima persetujuan dari pengulas yang diperlukan, Anda dapat menggabungkan cabang sumbernya ke cabang tujuan di konsol. CodeCatalyst Menggabungkan permintaan tarik juga akan memulai proses perubahan melalui alur kerja apa pun yang terkait dengan cabang tujuan. Dalam tutorial ini, Anda akan menggabungkan cabang pengujian menjadi main, yang akan memulai menjalankan onPushToMainDeployPipelinealur kerja.
Untuk menggabungkan permintaan tarik (konsol)
-
Di Permintaan tarik, pilih permintaan tarik yang Anda buat di langkah sebelumnya. Dalam permintaan tarik, pilih Gabung.
-
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. Setelah penggabungan selesai, status permintaan tarik berubah menjadi Gabungan dan tidak lagi muncul dalam tampilan default permintaan tarik. Tampilan default menunjukkan permintaan tarik dengan status Open. Anda masih dapat melihat permintaan tarik gabungan, tetapi Anda tidak dapat menyetujuinya atau mengubah statusnya.
catatan
Jika tombol Gabung tidak aktif, atau Anda melihat label Tidak dapat digabungkan, pengulas wajib 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, atau Anda telah melampaui kuota penyimpanan untuk ruang tersebut. Anda dapat menyelesaikan konflik gabungan untuk cabang tujuan di Lingkungan Pengembang, mendorong perubahan, lalu menggabungkan permintaan tarik, atau Anda dapat menyelesaikan konflik dan menggabungkan secara lokal, lalu mendorong komit yang berisi penggabungan. CodeCatalyst Untuk informasi selengkapnya, lihat Menggabungkan permintaan tarik (Git) dan dokumentasi Git Anda.
Melihat kode yang digunakan
Sekarang saatnya untuk melihat kode yang awalnya diterapkan yang ada di cabang default, dan perubahan gabungan Anda setelah kode tersebut dibuat, diuji, dan diterapkan secara otomatis. Untuk melakukannya, Anda dapat kembali ke halaman ikhtisar untuk repositori dan memilih nomor di sebelah ikon alur kerja terkait, atau di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.
Untuk melihat kode yang digunakan
-
Di Alur Kerja, di
onPushToMainDeployPipeline
, perluas Runs terbaru.catatan
Ini adalah nama default alur kerja untuk proyek yang dibuat dengan cetak biru aplikasi Single-page.
-
Proses terbaru adalah yang dimulai oleh komit permintaan tarik gabungan Anda ke
main
cabang dan kemungkinan akan menampilkan status Sedang berlangsung. Pilih proses yang berhasil diselesaikan dari daftar untuk membuka detail proses tersebut. -
Pilih Variabel. Salin nilai untuk App URL. Ini adalah URL untuk aplikasi web halaman tunggal yang digunakan. Buka tab browser baru dan tempel nilainya untuk melihat kode yang dibangun dan diterapkan. Biarkan tab terbuka.
-
Kembali ke daftar alur kerja yang berjalan dan tunggu hingga proses terbaru selesai. Ketika itu terjadi, kembali ke tab yang Anda buka untuk melihat aplikasi web dan menyegarkan browser Anda. Anda akan melihat perubahan yang Anda buat dalam permintaan tarik gabungan Anda.
Membersihkan sumber daya
Setelah Anda menjelajahi bekerja dengan repositori sumber dan permintaan tarik, Anda mungkin ingin menghapus sumber daya apa pun yang tidak Anda butuhkan. Anda tidak dapat menghapus permintaan tarik, tetapi Anda dapat menutupnya. Anda dapat menghapus cabang apa pun yang Anda buat.
Jika Anda tidak lagi memerlukan repositori sumber atau proyek, Anda juga dapat menghapus sumber daya tersebut. Lihat informasi yang lebih lengkap di Menghapus repositori sumber dan Menghapus proyek.