Memulai dengan cetak biru khusus - Amazon CodeCatalyst
PrasyaratLangkah 1: Buat cetak biru khusus di CodeCatalystLangkah 2: Kembangkan cetak biru khusus dengan komponenLangkah 3: Pratinjau cetak biru khusus(Opsional) Langkah 4: Publikasikan versi pratinjau cetak biru kustom

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

Memulai dengan cetak biru khusus

Selama proses pembuatan cetak biru, Anda dapat mengonfigurasi cetak biru dan menghasilkan pratinjau sumber daya proyek. Setiap cetak biru kustom dikelola oleh CodeCatalyst proyek, yang berisi alur kerja secara default untuk dipublikasikan ke katalog cetak biru ruang.

Saat mengonfigurasi detail cetak biru kustom Anda, Anda juga dapat memilih untuk menyimpan kode sumber cetak biru Anda di repositori pihak ketiga, di mana Anda masih dapat mengelola cetak biru khusus dan memanfaatkan kemampuan manajemen siklus hidup untuk menjaga proyek ruang Anda tetap disinkronkan saat cetak biru kustom dimodifikasi. Untuk informasi selengkapnya, lihat Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalyst dan Bekerja dengan manajemen siklus hidup sebagai penulis cetak biru.

Jika Anda sudah memiliki repositori sumber dengan standardisasi dan praktik terbaik, Anda dapat memilih untuk mengubah repositori sumber itu menjadi cetak biru khusus. Untuk informasi selengkapnya, lihat Mengonversi repositori sumber ke cetak biru khusus.

Prasyarat

Sebelum membuat cetak biru khusus, pertimbangkan persyaratan berikut:

  • CodeCatalyst Ruang Anda harus tingkat Enterprise. Untuk informasi selengkapnya, lihat Mengelola penagihan di Panduan CodeCatalyst Administrator Amazon.

  • Anda harus memiliki administrator Space atau peran pengguna Power untuk membuat cetak biru kustom. Untuk informasi selengkapnya, lihat Memberikan akses dengan peran pengguna.

Langkah 1: Buat cetak biru khusus di CodeCatalyst

Saat Anda membuat cetak biru khusus dari pengaturan ruang Anda, repositori dibuat untuk Anda. Repositori mencakup semua sumber daya yang diperlukan yang harus Anda miliki untuk mengembangkan cetak biru Anda sebelum menerbitkannya ke katalog cetak biru ruang.

Untuk membuat cetak biru kustom

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

  2. Di CodeCatalyst konsol, navigasikan ke ruang tempat Anda ingin membuat cetak biru khusus.

  3. Di dasbor ruang, pilih tab Pengaturan, lalu pilih Blueprints.

  4. Pilih Buat cetak biru.

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

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

    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 menggunakan koneksi ke 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.

  7. Di bawah detail Blueprint, lakukan hal berikut:

    1. Di kolom input teks nama tampilan Blueprint, masukkan nama yang akan muncul di katalog cetak biru ruang Anda.

    2. Di bidang masukan teks Deskripsi, masukkan deskripsi untuk cetak biru kustom Anda.

    3. Di kolom masukan teks nama penulis, masukkan nama penulis untuk cetak biru kustom Anda.

    4. (Opsional) Pilih Pengaturan lanjutan.

      1. Pilih + Tambahkan untuk menambahkan tag yang ditambahkan ke package.json file.

      2. Pilih menu tarik-turun Lisensi, lalu pilih lisensi untuk cetak biru kustom Anda.

      3. Di kolom input teks nama paket Blueprint, masukkan nama untuk mengidentifikasi paket cetak biru Anda.

      4. Secara default, alur kerja rilis dihasilkan menggunakan cetak biru penerbitan dalam proyek Anda yang disebut Blueprint Builder. Alur kerja menerbitkan versi cetak biru terbaru ke ruang Anda saat Anda mendorong perubahan karena izin penerbitan diaktifkan oleh alur kerja rilis. Untuk mematikan pembuatan alur kerja, hapus centang pada kotak centang Rilis alur kerja.

  8. (Opsional) Proyek cetak biru dilengkapi dengan kode yang telah ditentukan untuk mendukung penerbitan cetak biru ke katalog cetak biru ruang. Untuk melihat file definisi dengan pembaruan berdasarkan pilihan parameter proyek yang Anda buat, pilih Lihat kode atau Lihat alur kerja dari Buat pratinjau cetak biru.

  9. Pilih Buat cetak biru.

Jika Anda tidak menonaktifkan pembuatan alur kerja untuk cetak biru kustom Anda, alur kerja secara otomatis mulai berjalan saat cetak biru Anda dibuat. Saat alur kerja selesai, cetak biru kustom Anda tersedia untuk ditambahkan ke katalog cetak biru ruang Anda secara default. Anda dapat menonaktifkan izin penerbitan jika Anda tidak ingin versi cetak biru terbaru dipublikasikan secara otomatis ke ruang Anda. Untuk informasi selengkapnya, lihat Menyetel izin penerbitan untuk cetak biru kustom dan Menjalankan alur kerja.

Karena alur kerja penerbitan yang blueprint-release disebut dibuat menggunakan cetak biru, cetak biru dapat ditemukan sebagai cetak biru yang diterapkan dalam proyek Anda. Untuk informasi selengkapnya, lihat Menambahkan cetak biru dalam proyek untuk mengintegrasikan sumber daya dan Memutuskan cetak biru dari proyek untuk menghentikan pembaruan.

Langkah 2: Kembangkan cetak biru khusus dengan komponen

Wizard cetak biru dihasilkan saat Anda membuat cetak biru khusus, dan dapat dimodifikasi dengan komponen saat mengembangkan cetak biru kustom. Anda dapat memperbarui src/defaults.json file src/blueprints.js dan untuk memodifikasi wizard.

penting

Jika Anda ingin menggunakan paket cetak biru dari sumber eksternal, pertimbangkan risiko yang mungkin datang dengan paket tersebut. Anda bertanggung jawab atas cetak biru khusus yang Anda tambahkan ke ruang Anda dan kode yang dihasilkannya.

Buat Lingkungan Pengembang di CodeCatalyst proyek Anda dengan lingkungan pengembangan terintegrasi (IDE) yang didukung sebelum mengonfigurasi kode cetak biru Anda. Lingkungan Pengembang diperlukan untuk bekerja dengan alat dan paket yang diperlukan.

Untuk membuat Lingkungan Dev

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

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

    2. Pilih Kode, lalu pilih Dev Environments.

    3. Pilih Kode, pilih repositori Sumber, dan pilih repositori yang Anda buat saat membuat cetak biru Anda.

  2. Pilih Buat Lingkungan Pengembang.

  3. Pilih IDE yang didukung dari menu tarik-turun. Lihat Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Pengembang untuk informasi selengkapnya.

  4. Pilih Bekerja di cabang yang ada, dan dari menu dropdown cabang yang ada, pilih cabang fitur yang Anda buat.

  5. (Opsional) Di kolom Alias - input teks opsional, masukkan alias untuk mengidentifikasi Lingkungan Pengembang.

  6. Pilih Buat. Saat Dev Environment Anda sedang dibuat, kolom status Dev Environment menampilkan Mulai, dan kolom status menampilkan Berjalan saat Lingkungan Dev telah dibuat.

Untuk informasi selengkapnya, lihat Menulis dan memodifikasi kode dengan Dev Environments di CodeCatalyst.

Untuk mengembangkan cetak biru kustom Anda

  1. Di terminal yang berfungsi, gunakan yarn perintah berikut untuk menginstal dependensi:

    yarn

    Alat dan paket yang diperlukan tersedia melalui CodeCatalyst Dev Environment, termasuk Yarn. Jika Anda mengerjakan cetak biru khusus tanpa Dev Environment, instal Yarn ke sistem Anda terlebih dahulu. Untuk informasi selengkapnya, lihat dokumentasi instalasi Yarn.

  2. Kembangkan cetak biru khusus Anda sehingga dikonfigurasi sesuai preferensi Anda. Anda dapat memodifikasi wizard cetak biru Anda dengan menambahkan komponen. Lihat informasi selengkapnya di Mengembangkan cetak biru khusus untuk memenuhi persyaratan proyek, Memodifikasi fitur cetak biru dengan wizard front-end, dan Menerbitkan cetak biru khusus ke spasi.

Langkah 3: Pratinjau cetak biru khusus

Setelah menyiapkan dan mengembangkan cetak biru kustom Anda, Anda dapat melihat pratinjau dan mempublikasikan versi pratinjau cetak biru Anda ke ruang Anda. Versi pratinjau memberi Anda kemampuan untuk memeriksa apakah cetak biru adalah apa yang Anda inginkan sebelum digunakan untuk membuat proyek baru atau diterapkan pada proyek yang ada.

Untuk melihat pratinjau cetak biru kustom

  1. Di terminal yang berfungsi, gunakan yarn perintah berikut:

    yarn blueprint:preview

  2. Arahkan ke See this blueprint at: tautan yang disediakan untuk melihat pratinjau cetak biru kustom Anda.

  3. Periksa apakah UI, termasuk teks, muncul seperti yang Anda harapkan berdasarkan konfigurasi Anda. Jika Anda ingin mengubah cetak biru kustom Anda, Anda dapat mengedit blueprint.ts file, mensintesis ulang cetak biru, dan kemudian mempublikasikan versi pratinjau lagi. Untuk informasi selengkapnya, lihat Resintesis.

(Opsional) Langkah 4: Publikasikan versi pratinjau cetak biru kustom

Anda dapat mempublikasikan versi pratinjau cetak biru kustom Anda ke ruang Anda jika Anda ingin menambahkannya ke katalog cetak biru ruang Anda. Ini memungkinkan Anda untuk melihat cetak biru sebagai pengguna sebelum menambahkan versi non-pratinjau ke katalog. Versi pratinjau memungkinkan Anda untuk mempublikasikan tanpa mengambil versi sebenarnya. Misalnya, jika Anda bekerja pada 0.0.1 versi, Anda dapat mempublikasikan dan menambahkan versi pratinjau, sehingga pembaruan baru untuk versi kedua dapat dipublikasikan dan ditambahkan sebagai0.0.2.

Untuk mempublikasikan versi pratinjau cetak biru kustom

Arahkan ke Enable version [version number] at: tautan yang disediakan untuk mengaktifkan cetak biru kustom Anda. Tautan ini disediakan saat menjalankan yarn perintah diLangkah 3: Pratinjau cetak biru khusus.

Setelah membuat, mengembangkan, melihat pratinjau, dan menerbitkan cetak biru kustom Anda, Anda dapat mempublikasikan dan menambahkan versi cetak biru akhir ke katalog cetak biru ruang Anda. Lihat informasi yang lebih lengkap di Menerbitkan cetak biru khusus ke spasi dan Menambahkan cetak biru khusus ke katalog cetak biru ruang.