Mendesain template aplikasi

Administrator membuat template aplikasi untuk membantu memastikan bahwa arsitektur pilihan mereka digunakan oleh setiap tim pengembangan. Hal ini membantu Anda mengatur resource dan konfigurasi yang digunakan developer dalam deployment aplikasi mereka.

Setelah Anda membuat template aplikasi, orang lain di ruang Anda dapat mengaksesnya. Anda juga dapat menambahkan template ke katalog untuk dibagikan ke ruang lain.

Developer dapat menggunakan template Anda untuk membuat dan men-deploy aplikasi. Saat developer membuat aplikasi, mereka dapat mengonfigurasi setiap komponen dari template, tetapi mereka tidak dapat menambahkan atau menghapus komponen apa pun. Template ini menghasilkan kode Terraform, yang dapat didownload atau di-deploy oleh developer dari Pusat Desain Aplikasi.

Dokumen ini membantu Anda mendesain, mengonfigurasi, dan membagikan template aplikasi menggunakan Pusat Desain Aplikasi.

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)

Membuat template aplikasi

Buat template aplikasi untuk membagikan desain arsitektur Anda kepada tim pengembangan. Anda dapat menambahkan komponen berikut ke desain template:

  • Aset: Resource tingkat tinggi yang membantu Anda mengontrol resource lain. Misalnya, akun layanan.

  • Layanan: Antarmuka jaringan atau API yang digunakan melalui jaringan. Contohnya mencakup Cloud Storage dan Vertex AI.

  • Workload: Deployment biner yang menjalankan fungsi bisnis. Contohnya mencakup Cloud Run dan Compute Engine.

Anda dapat memilih dari komponen berikut:

Saat Anda mendesain template, Pusat Desain Aplikasi akan membuat kode Terraform untuk mencerminkan detail desain dan konfigurasi.

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:

  1. Dari menu navigasi, klik Template.

    Buka Template

  2. Klik Buat template.

  3. Di kolom Template ID, masukkan ID unik untuk template. Kolom ini wajib diisi.

  4. Di kolom Template Name, masukkan ID yang mudah dibaca 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.

Mendesain template

Desain template Anda dengan menambahkan dan menghubungkan komponen di kanvas desain. Contoh berikut mencakup tiga komponen yang terhubung.

Aplikasi web tiga tingkat di kanvas desain. Aplikasi ini mencakup komponen frontend, backend, dan database.

Anda dapat mendesain template dengan menambahkan komponen ke titik awal berikut:

Untuk mendesain template, lakukan tindakan berikut:

  1. Dari kanvas desain, pastikan Desain dipilih.

  2. Lakukan salah satu tindakan berikut untuk memulai:

    • Untuk memulai dari awal, dari area Komponen, klik komponen untuk menambahkannya ke area kanvas.

    • Untuk memulai dari template yang disediakan Google, klik nama template.

    • Untuk menggunakan percakapan bahasa alami guna membuat template, klik Custom Application with Gemini.

  3. Untuk membuat saluran komunikasi antar-komponen, lakukan salah satu hal berikut:

    • Untuk menghubungkan dua komponen di kanvas, tarik dari titik biru pada satu komponen ke titik biru pada komponen lain.

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

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

  4. Untuk menghapus komponen atau koneksi, lakukan langkah-langkah berikut:

    1. Di kanvas, klik komponen atau koneksi.

    2. Di area Konfigurasi, klik Hapus.

    3. Di kolom, masukkan delete.

    4. Klik Hapus.

Mengonfigurasi nilai default untuk komponen

Untuk setiap komponen yang Anda tambahkan ke kanvas, Anda dapat menentukan detail konfigurasi seperti project tempat resource dibuat, dan lokasi tempat resource di-deploy. Jika Anda menentukan detail konfigurasi, Pusat Desain Aplikasi akan menggunakannya sebagai nilai default untuk aplikasi.

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

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:

  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:

  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.

Edit kode Terraform

Saat Anda mendesain template aplikasi, Pusat Desain Aplikasi akan membuat kode Terraform untuk mencerminkan detail desain dan konfigurasi. Anda dapat mengedit Terraform untuk menentukan detail konfigurasi komponen.

Sistem menghasilkan file Terraform berikut:

  • main.tf: Kode infrastruktur yang menyertakan modul untuk setiap komponen dalam template.
  • outputs.tf: Mengekspos informasi tentang komponen infrastruktur yang di-deploy.
  • variables.tf: Mendeklarasikan nama, jenis, dan deskripsi untuk variabel yang digunakan dalam file main.tf.
  • input.tfvars: Menentukan nilai untuk variabel yang digunakan dalam file main.tf.
  • providers.tf: Menentukan label yang membantu Terraform berinteraksi dengan API dan resource Google Cloud .

Untuk mengetahui informasi latar belakang, lihat Ringkasan Terraform di Google Cloud.

Untuk mengedit kode Terraform, lakukan hal berikut:

  1. Dari kanvas desain, klik Kode. Sistem akan menampilkan file Terraform yang dihasilkan.

  2. Klik main.tf. Sistem menampilkan modul Terraform untuk setiap komponen.

  3. Edit detail konfigurasi. Untuk mengetahui informasi selengkapnya, lihat dokumentasi konfigurasi untuk setiap resource yang didukung.

    Sistem akan otomatis memvalidasi hasil edit Anda, dan menampilkan error jika hasil edit Anda tidak valid.

  4. Untuk menandai dan membandingkan hasil edit Anda, lakukan langkah-langkah berikut:

    1. Klik Lihat perbedaan.

    2. Untuk mengembalikan perubahan, di margin, klik Klik untuk mengembalikan perubahan.

    3. Klik Lihat perbedaan untuk menutup tampilan perbandingan.

  5. Untuk menyimpan hasil edit, klik Simpan perubahan kode.

  6. Untuk memverifikasi perubahan Anda, lakukan hal berikut.

    1. Klik Desain.
    2. Klik komponen dan tinjau detail konfigurasinya.

Menghapus template

Jika tidak lagi memerlukan template, Anda dapat menghapusnya.

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

Verifikasi template Anda

Sebelum membagikan template kepada developer, pastikan template tersebut berfungsi seperti yang Anda inginkan. Untuk memverifikasi template Anda, lakukan hal berikut:

  1. Buat aplikasi dengan setelan berikut:
    1. Dari daftar Environment, pilih TEST.
    2. Dari daftar Criticality, pilih LOW.
  2. Deploy aplikasi. Untuk mengetahui langkah-langkah deployment, lihat Men-deploy aplikasi dari konsol.
  3. Uji infrastruktur Anda untuk memastikan infrastruktur tersebut memenuhi persyaratan Anda.
  4. Untuk menghindari biaya berulang, hapus deployment pengujian.

Membagikan template ke katalog

Setelah memverifikasi template, Anda dapat memublikasikan template ke katalog. Template ini dapat digunakan oleh developer aplikasi yang memiliki akses ke ruang tempat katalog dibagikan.

  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 aplikasi. 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 kembali template ke katalog yang relevan.

Langkah berikutnya