Mendesain template gabungan

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Saat Anda ingin membuat aplikasi kompleks dari elemen penyusun yang lebih kecil dan dapat digunakan kembali, buat template komposit. Misalnya, Anda dapat membuat template komposit yang mencakup beberapa template aplikasi yang terhubung.

Anda juga dapat membuat template komposit untuk memodelkan dan memaketkan unit deployment untuk penawaran SaaS yang Anda deploy dengan App Lifecycle Manager. Untuk mengetahui informasi selengkapnya, lihat Unit deployment model dan paket.

Desain template komposit dengan menambahkan dan menghubungkan template aplikasi standar dan komponen individual. Pendekatan modular ini membantu Anda mencapai hal-hal berikut:

• Mempercepat pengembangan: Susun aplikasi kompleks dari elemen dasar yang lebih kecil. Anda dapat menggunakan kembali setiap template aplikasi standar dalam beberapa template komposit.
• Mengaktifkan pengembangan paralel: Memungkinkan tim modular mengkhususkan diri dalam blok penyusun tertentu. Misalnya, tim database dapat menangani penyimpanan dan analisis data dengan hanya sedikit mengandalkan tim logika aplikasi.
• Mengurangi dampak kerentanan: Developer dapat memperbarui atau memperbaiki blok bangunan tanpa men-deploy ulang seluruh aplikasi.
• Meningkatkan postur keamanan: Batasi akses dengan membuat akun layanan yang berbeda untuk men-deploy setiap blok penyusun. Pastikan setiap tim hanya memiliki izin untuk elemen penyusun yang mereka konfigurasi.

Dokumen ini menunjukkan cara mendesain, memverifikasi, dan membagikan template komposit.

Sebelum memulai

Anda harus memiliki salah satu peran berikut di folder atau project pengelolaan yang mendukung aplikasi:

• Admin Application Design Center (roles/designcenter.admin)
• Pengguna Application Design Center (roles/designcenter.user)

Untuk menggunakan template aplikasi standar Anda sendiri sebagai elemen penyusun, tetapkan variabel input dan output untuk membuat variabel yang dapat dikonfigurasi, dan buat koneksi antar-template aplikasi Anda. Untuk informasi selengkapnya, lihat referensi berikut:

• Mendesain template aplikasi standar
• Membagikan template ke katalog

Membuat template aplikasi gabungan

Buat template komposit saat Anda ingin mendesain dan membagikan aplikasi yang kompleks. Anda dapat menambahkan dan menghubungkan hal berikut dalam desain template:

• Template aplikasi standar: Pilih dari template yang ada berikut:

  • Template yang dirancang oleh Google, yang menggabungkan Google Cloud praktik terbaik dan konfigurasi keamanan default.
  • Template yang sebelumnya Anda buat dan tambahkan ke katalog ruang Anda.

• Komponen: Pilih dari Google Cloud referensi berikut:

  • Komponen yang dirancang oleh Google, yang menggabungkan praktik terbaik dan konfigurasi keamanan default. Google Cloud
  • Komponen Anda sendiri yang Anda impor, berdasarkan modul Terraform Anda sendiri.

Tentukan detail template

Detail template membantu Anda mengategorikan template dan membantu developer memutuskan apakah akan menggunakan template Anda.

Untuk memasukkan detail template, lakukan hal berikut:

Kanvas desain

1. Dari menu navigasi, klik Template.

   Buka Template

2. Dari daftar Create Template, pilih Composite template.

3. Kolom ID Template akan otomatis diisi. Atau, masukkan ID unik untuk template. Kolom ini wajib diisi.

4. Di kolom Template Name, masukkan ID yang mudah dibaca manusia untuk ditampilkan di konsol Google Cloud .

   Jika Anda tidak memberikan nama, ID Template akan disalin ke kolom ini.

5. Di kolom Deskripsi, masukkan penjelasan singkat tentang tujuan aplikasi.

6. Klik Buat template. Kanvas desain akan ditampilkan.

gcloud CLI

Buat template aplikasi komposit baru.

gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION \
--composition-type=COMPOSITE

Ganti kode berikut:

• APPLICATION_TEMPLATE: ID template untuk template aplikasi yang ingin Anda buat.
• PROJECT: Project ID pengelolaan Anda.
• LOCATION: Region template aplikasi.
• SPACE: ID ruang Anda.
• DISPLAY_NAME: Nama yang akan ditampilkan di konsol Google Cloud .
• DESCRIPTION: Deskripsi singkat.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates create.

Mendesain template

Rancang template komposit Anda dengan menambahkan dan menghubungkan template dan komponen aplikasi standar ke titik awal berikut:

• Kanvas kosong.
• Template yang disediakan Google.
• Template yang Anda buat dengan bantuan Gemini.

Saat Anda mendesain template, App Design Center akan membuat kode Terraform untuk mencerminkan detail desain dan konfigurasi.

Untuk mendesain template, lakukan tindakan berikut:

Kanvas desain

1. Dari kanvas desain, pilih Desain untuk melihat kanvas.

2. Lakukan salah satu tindakan berikut untuk memulai:

   • Untuk memulai dari template yang disediakan Google, di area Mulai di kanvas, klik nama template.

   • Untuk memulai dari kanvas kosong, lanjutkan ke langkah berikutnya.

3. Untuk menambahkan template aplikasi standar ke kanvas, lakukan hal berikut:

   1. Di area Components, klik Embed templates.

   2. Untuk menambahkan template yang ada, klik template dalam salah satu daftar berikut:

      • Template: template aplikasi standar yang ada di katalog ruang Anda, atau telah dibagikan ke ruang Anda.
      • Template Google: template aplikasi standar yang dibuat oleh Google dan ditambahkan ke katalog Google.

   3. Untuk menambahkan template yang dipilih ke kanvas, klik Pilih.

4. Untuk membuat template aplikasi standar baru, klik Buat template baru. Halaman Create new template akan terbuka.

   Untuk mengetahui informasi selengkapnya, lihat Mendesain template aplikasi standar.

5. Untuk menambahkan komponen ke kanvas, dari area Komponen, klik komponen.

6. Untuk membuat saluran komunikasi antara template dan komponen, lakukan salah satu hal berikut:

   • Tarik dari titik biru di satu blok bangunan ke titik biru di blok bangunan lain.

   • Untuk menambahkan komponen terhubung ke komponen yang ada, klik Tambahkan, lalu pilih komponen yang akan ditambahkan.

   Untuk mengetahui detail koneksi, lihat dokumentasi konfigurasi untuk setiap resource yang didukung.

7. Untuk menghapus blok penyusun atau koneksi, lakukan langkah-langkah berikut:

   1. Di kanvas, klik blok penyusun atau koneksi.

   2. Di area Konfigurasi, klik Hapus.

   3. Di kolom, masukkan delete.

   4. Klik Hapus.

gcloud CLI

1. Identifikasi URI revisi template untuk elemen penyusun di katalog ruang Anda.

   gcloud design-center spaces shared-templates list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Ganti kode berikut:

   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces shared-templates list.

2. Identifikasi URI revisi template untuk elemen penyusun katalog Google yang ingin Anda tambahkan ke template.

   gcloud design-center spaces shared-templates list \
   --google-catalog \
   --location=us-central1
   

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces shared-templates list.

3. Tambahkan template atau komponen aplikasi standar ke template komposit Anda.

   gcloud design-center spaces application-templates components create COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI
   

   Ganti kode berikut:

   • COMPONENT: ID untuk template atau komponen aplikasi standar yang ingin Anda tambahkan ke template.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • APPLICATION_TEMPLATE: ID template untuk template aplikasi komposit tempat Anda menambahkan template atau komponen aplikasi standar.
   • SHARED_TEMPLATE_URI: URI template aplikasi standar atau template komponen bersama. Contoh, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components create.

4. Tambahkan template atau komponen aplikasi standar kedua ke template Anda.

   gcloud design-center spaces application-templates components create COMPONENT_2 \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI_2
   

   Ganti kode berikut:

   • COMPONENT_2: ID untuk template atau komponen aplikasi standar kedua yang ingin Anda tambahkan ke template.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • APPLICATION_TEMPLATE: ID template untuk template komposit tempat Anda menambahkan template atau komponen aplikasi standar.
   • SHARED_TEMPLATE_URI_2: URI template atau komponen bersama template aplikasi standar kedua. Contoh, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components create.

5. Buat koneksi antara template atau komponen aplikasi standar.

   gcloud design-center spaces application-templates components connections create CONNECTION \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --component=COMPONENT \
   --destination-component-uri=COMPONENT_2
   

   Ganti kode berikut:

   • CONNECTION: ID koneksi untuk koneksi yang ingin Anda tambahkan ke template.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • APPLICATION_TEMPLATE: ID template untuk template aplikasi tempat Anda menambahkan koneksi.
   • COMPONENT: ID komponen atau template aplikasi standar sumber.
   • COMPONENT_2: ID komponen atau template aplikasi standar tujuan.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components connections create.

Mengonfigurasi nilai default untuk komponen

Untuk setiap komponen yang Anda tambahkan ke template, Anda dapat menentukan detail konfigurasi default, seperti project dan lokasi deployment resource. Application Design Center menerapkan default ini saat aplikasi dibuat dari template ini.

Developer aplikasi juga dapat mengubah detail koneksi jika konfigurasi default tidak memenuhi persyaratan mereka. Misalnya, Anda dapat mengubah nama kunci variabel lingkungan, mengubah port koneksi, atau menambahkan peran tambahan ke akun layanan saat Anda membuat aplikasi.

Sebelum men-deploy aplikasi, developer dapat melihat dan mengubah nilai default yang Anda konfigurasi dalam template. Developer harus mengonfigurasi detail yang diperlukan untuk setiap resource yang didukung.

Untuk mengonfigurasi komponen dan koneksi, lakukan hal berikut:

Kanvas desain

1. Dari kanvas desain, klik komponen.

2. Di area Konfigurasi, dari daftar Project ID, pilih project tempat Anda ingin men-deploy resource. Pilih project dengan kualifikasi berikut:

   • Project harus merupakan turunan dari folder yang mendukung aplikasi yang dipilih.

   • Project tidak boleh berupa project pengelolaan.

3. Konfigurasi setelan tambahan untuk resource. Misalnya, untuk Cloud SQL, Anda dapat mengonfigurasi hal berikut:

   • Wilayah
   • Konfigurasi pencadangan
   • Tanda database
   • Konfigurasi IP

   Untuk mengetahui link ke dokumentasi konfigurasi setiap komponen, lihat Sumber daya yang didukung.

4. Saat Anda menghubungkan komponen di kanvas desain, nilai konfigurasi default digunakan untuk membuat koneksi. Untuk menambahkan atau mengubah detail koneksi, lakukan hal berikut.

   1. Di kanvas desain, klik koneksi antara dua komponen. Panel Koneksi akan terbuka dan menampilkan parameter koneksi.

   2. Lakukan salah satu hal berikut:

      • Untuk mengubah parameter koneksi yang ada, klik Edit.

      • Untuk menambahkan parameter koneksi baru, klik Tambahkan parameter.

   3. Perbarui kolom Kunci dan Nilai. Misalnya, Anda mungkin ingin mengubah detail berikut:

      • Nama kunci variabel lingkungan agar sesuai dengan persyaratan aplikasi Anda.
      • Nilai port koneksi.
      • Peran yang ditambahkan ke akun layanan.

5. Klik Simpan.

gcloud CLI

1. Jelaskan setiap komponen dalam template aplikasi untuk melihat parameter komponen.

   gcloud design-center spaces application-templates components describe COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE
   

   Ganti kode berikut:

   • COMPONENT: ID komponen untuk komponen yang ingin Anda deskripsikan.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • APPLICATION_TEMPLATE: ID template untuk template aplikasi.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components describe.

2. Untuk setiap komponen yang ingin Anda ubah, buat file JSON di direktori berisi nilai parameter.

   Misalnya, Anda dapat membuat file berikut untuk komponen Cloud Run:

     [
         {
           "key": "service_name",
           "value": "frontend-service"
         },
         {
           "key": "project_id",
           "value": "DEPLOYMENT_PROJECT"
         }
     ]
   

3. Perbarui setiap komponen dalam template aplikasi untuk mengonfigurasi parameter yang diperlukan.

   gcloud design-center spaces application-templates components update COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --parameters=PARAMETERS_FILE_PATH \
   --application-template=APPLICATION_TEMPLATE
   

   Ganti kode berikut:

   • COMPONENT: ID komponen untuk komponen yang ingin Anda perbarui.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • PARAMETERS_FILE_PATH: File JSON yang menyertakan parameter komponen.
   • APPLICATION_TEMPLATE: ID template untuk template aplikasi.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components update.

4. Jelaskan koneksi komponen.

   gcloud design-center spaces application-templates components connections describe CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Ganti kode berikut:

   • CONNECTION: ID koneksi.
   • COMPONENT: ID komponen.
   • APPLICATION_TEMPLATE: ID template.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components connections describe.

5. Edit parameter koneksi komponen.

   gcloud design-center spaces application-templates components connections update CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --source-component-parameters='[{"key": SOURCE_KEY, "value": SOURCE_VALUE}]'
   

   Ganti kode berikut:

   • CONNECTION: ID koneksi.
   • COMPONENT: ID komponen.
   • APPLICATION_TEMPLATE: ID template.
   • PROJECT: Project ID pengelolaan Anda.
   • LOCATION: Region template aplikasi.
   • SPACE: ID ruang Anda.
   • SOURCE_KEY: Kunci parameter baru.
   • SOURCE_VALUE: Nilai parameter baru.

   Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates components connections update.

Mengonfigurasi template aplikasi standar

Saat developer men-deploy template komposit Anda sebagai aplikasi, aplikasi dibuat untuk setiap hal berikut:

• Setiap grup template aplikasi standar.
• Setiap grup komponen.

Anda dapat memberikan nilai default untuk setiap grup. Misalnya, Anda dapat menyertakan project deployment, region, dan pemilik. Saat men-deploy aplikasi di Pusat Desain Aplikasi, developer dapat menggunakan nilai default, atau menentukan detailnya sendiri untuk setiap aplikasi.

Untuk memberikan detail aplikasi default untuk setiap grup, lakukan hal berikut:

Kanvas desain

1. Dari kanvas desain, klik template aplikasi standar.

   Panel Template Sematan akan terbuka.

2. Di area Konfigurasi, masukkan detail aplikasi.

   Untuk mengetahui informasi selengkapnya, lihat Membuat draf aplikasi.

gcloud CLI

Untuk mengetahui informasi selengkapnya, lihat Mendesain template Anda.

Verifikasi template Anda

Sebelum membagikan template komposit kepada developer, deploy dan verifikasi template Anda di Pusat Desain Aplikasi. Langkah ini membantu Anda memverifikasi fungsi sebelum deployment berskala di beberapa komputer.

Untuk memverifikasi template Anda, lakukan hal berikut:

1. Dari kanvas desain, klik Lanjutkan, lalu pilih Buat aplikasi untuk di-deploy.

   Panel Create an application akan terbuka.

2. Di area Composite application details, masukkan detail aplikasi.

   Untuk mengetahui informasi selengkapnya, lihat Membuat draf aplikasi.

3. Klik Berikutnya.

4. Untuk setiap elemen penyusun yang Anda tambahkan ke template komposit, aplikasi akan dibuat saat Anda men-deploy. Konfigurasi setiap aplikasi, lalu klik Next.

   Untuk mengetahui informasi selengkapnya, lihat Membuat draf aplikasi.

5. Uji aplikasi yang di-deploy untuk memastikan aplikasi tersebut memenuhi persyaratan Anda.

6. Untuk menghindari biaya berulang, hapus deployment pengujian.

Membuat deployment yang diskalakan

Untuk men-deploy dan mengelola beberapa instance template komposit, gunakan Pengelola Siklus Proses Aplikasi.

1. Verifikasi template Anda di App Design Center.

2. Dari kanvas desain, klik Lanjutkan, lalu pilih Deploy at scale with App Lifecycle Manager.

   Halaman App Lifecycle Manager Units akan terbuka.

3. Untuk mengetahui langkah-langkah deployment, lihat Men-deploy penawaran SaaS.

Membagikan template

Agar template Anda tersedia bagi developer, Anda dapat menambahkannya ke katalog dan membagikannya. Saat Anda menambahkan template ke katalog, template tersebut tersedia sebagai sumber aplikasi di ruang tempat katalog dibagikan.

Untuk membagikan template, lakukan tindakan berikut:

1. Dari kanvas desain, klik Tambahkan ke Katalog.

2. Untuk mengelola ruang tempat katalog dibagikan, lihat Mengelola katalog.

Merevisi dan membagikan ulang template Anda

Seiring Anda mendapatkan pengalaman dengan aplikasi dan kebutuhan bisnis Anda berkembang, Anda mungkin ingin memperbarui template. Misalnya, Anda dapat memutuskan untuk meningkatkan performa layanan backend dengan menambahkan layanan Memorystore untuk caching.

Saat mengubah template, Anda membuat revisi template. Untuk menerapkan perubahan pada aplikasi yang ada, developer harus men-deploy aplikasi menggunakan revisi.

Pusat Desain Aplikasi tidak otomatis memublikasikan revisi template ke katalog. Untuk membagikan revisi terbaru, publikasikan template ke katalog lagi.

Untuk membuat revisi baru, lakukan hal berikut:

1. Dari menu navigasi, klik Template.

   Buka Template

2. Pilih template aplikasi yang ingin Anda revisi. Kanvas akan terbuka.

3. Ubah template agar sesuai dengan persyaratan baru Anda. Misalnya, tambahkan dan konfigurasi komponen baru.

4. Untuk membagikan revisi terbaru ke ruang lain, tambahkan template ke katalog Anda lagi.

Menghapus template

Jika tidak lagi memerlukan template, Anda dapat menghapusnya.

Kanvas desain

1. Dari kanvas desain, klik Tindakan.
2. Klik Hapus.

gcloud CLI

Hapus template aplikasi.

```sh
gcloud design-center spaces application-templates delete APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
```

Ganti kode berikut:

• APPLICATION_TEMPLATE: ID template untuk template aplikasi yang ingin Anda hapus.
• PROJECT: Project ID pengelolaan Anda.
• LOCATION: Region template aplikasi.
• SPACE: ID ruang Anda.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates delete.

Langkah berikutnya

• Untuk men-deploy template komposit dengan App Lifecycle Manager, lihat Men-deploy penawaran SaaS.

• Untuk membagikan template ke ruang lain, buat dan bagikan katalog.

• Untuk menggunakan modul Terraform Anda sendiri dalam desain template aplikasi, impor komponen.