Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

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

# Memulai dengan cetak biru khusus
<a name="getting-started-bp"></a>

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, silakan lihat [Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalystTambahkan fungsionalitas ke proyek dengan ekstensi](extensions.md) dan [Bekerja dengan manajemen siklus hidup sebagai penulis cetak biru](lifecycle-management-dev.md).

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](convert-bp.md).

**Topics**
+ [Prasyarat](#prerequisites-bp)
+ [Langkah 1: Buat cetak biru khusus di CodeCatalyst](#getting-started-create-bp)
+ [Langkah 2: Kembangkan cetak biru khusus dengan komponen](#getting-started-develop-bp)
+ [Langkah 3: Pratinjau cetak biru khusus](#getting-started-publish-bp)
+ [(Opsional) Langkah 4: Publikasikan versi pratinjau cetak biru kustom](#getting-started-add-bp)

## Prasyarat
<a name="prerequisites-bp"></a>

Sebelum membuat cetak biru khusus, pertimbangkan persyaratan berikut:
+  CodeCatalyst Ruang Anda harus tingkat **Enterprise**. Untuk informasi selengkapnya, lihat [Mengelola penagihan](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-view-plan.html) 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](ipa-roles.md).

## Langkah 1: Buat cetak biru khusus di CodeCatalyst
<a name="getting-started-create-bp"></a>

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/](https://codecatalyst.aws/).

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

1. Di dasbor ruang, pilih tab **Pengaturan**, lalu pilih **Blueprints**.

1. Pilih **Buat cetak biru**.

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

1. (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 CodeCatalystTambahkan fungsionalitas ke proyek dengan ekstensi](extensions.md).

   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, silakan lihat [Koneksi pribadi](concepts.md#personal-connection-concept) dan [Mengakses GitHub sumber daya dengan koneksi pribadi](ipa-settings-connections.md).
   + **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.

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

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

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

   1. (Opsional) Pilih **Pengaturan lanjutan**.

      1. Pilih **\$1 Tambahkan** untuk menambahkan tag yang ditambahkan ke `package.json` file.

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

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

      1. **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**.

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

1. 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, silakan lihat [Menyetel izin penerbitan untuk cetak biru kustom](manage-permissions-bp.md) dan [Menjalankan alur kerja](workflows-working-runs.md).

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, silakan lihat [Menambahkan cetak biru dalam proyek untuk mengintegrasikan sumber daya](apply-bp.md) dan [Memutuskan cetak biru dari proyek untuk menghentikan pembaruanMemutuskan cetak biru dari sebuah proyek](disassociate-bp.md).

## Langkah 2: Kembangkan cetak biru khusus dengan komponen
<a name="getting-started-develop-bp"></a>

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

   1. Pilih **Kode**, lalu pilih **Dev Environments**.

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

1. Pilih **Buat Lingkungan Pengembang**.

1. Pilih IDE yang didukung dari menu tarik-turun. Lihat [Lingkungan pengembangan terintegrasi yang didukung untuk Lingkungan Pengembang](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html#devenvironment-supported-ide) untuk informasi selengkapnya.

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

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

1. 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 CodeCatalystMenulis dan memodifikasi kode dengan Dev Environments](devenvironment.md).

**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](https://classic.yarnpkg.com/en/docs/install#mac-stable).

1. 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](develop-bp.md), [Memodifikasi fitur cetak biru dengan wizard front-end](wizard-bp.md), dan [Menerbitkan cetak biru khusus ke spasi](publish-bp.md).

## Langkah 3: Pratinjau cetak biru khusus
<a name="getting-started-publish-bp"></a>

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

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

1. 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](custom-bp-concepts.md#resynthesis-concept).

## (Opsional) Langkah 4: Publikasikan versi pratinjau cetak biru kustom
<a name="getting-started-add-bp"></a>

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 sebagai`0.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 di[Langkah 3: Pratinjau cetak biru khusus](#getting-started-publish-bp).

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. Untuk informasi selengkapnya, silakan lihat [Menerbitkan cetak biru khusus ke spasi](publish-bp.md) dan [Menambahkan cetak biru khusus ke katalog cetak biru ruang](add-bp.md).