Mengelola aplikasi

Membuat draf aplikasi dari template di Application Design Center memungkinkan Anda menyesuaikan dan men-deploy instance aplikasi terpisah untuk lingkungan seperti pengujian dan produksi. Saat membuat draf aplikasi, Anda menentukan atribut untuk mengategorikan dan memfilter aplikasi, mengonfigurasi komponen dan koneksi, serta mengedit kode Terraform yang dihasilkan secara opsional. Anda juga dapat membuat revisi baru seiring perubahan persyaratan, dan menghapus aplikasi saat Anda tidak lagi memerlukan resource yang di-deploy.

Sebelum memulai

Untuk melakukan tugas dalam dokumen ini, minta administrator untuk memberi Anda peran yang diperlukan pada folder khusus aplikasi atau project pengelolaan, seperti yang tercantum dalam tabel berikut:

Tugas Peran yang diperlukan
Membuat, mengonfigurasi, mengedit, dan membuat versi draf aplikasi Application Design Center Admin (roles/designcenter.admin), atau
Application Admin (roles/designcenter.applicationAdmin), atau
Application Editor (roles/designcenter.applicationEditor)
Menghapus aplikasi Admin Application Design Center (roles/designcenter.admin), atau
Admin Aplikasi (roles/designcenter.applicationAdmin)

Untuk mengetahui informasi selengkapnya tentang peran, lihat Kontrol akses dengan IAM.

Membuat draf aplikasi

Buat draf aplikasi dari template dengan menentukan detail dan secara opsional mengganti konfigurasi komponen. Kemudian, Anda dapat men-deploy draf untuk membuat aplikasi.

Kanvas desain

  1. Dari menu navigasi, lakukan salah satu tindakan berikut:

    • Untuk melihat template yang dibuat di ruang Anda, klik Template.

      Buka Template

    • Untuk melihat template yang dibagikan dari ruang lain, klik Template yang dibagikan.

      Buka Template bersama

  2. Klik ID Template yang ingin Anda gunakan.

  3. Dari kanvas desain, klik Configure an app. Kemudian, klik Create new application.

  4. Di area Application name, lakukan hal berikut untuk memberi nama dan mendeskripsikan aplikasi Anda:

    1. Di kolom Name, masukkan ID unik di ruang ini. Misalnya, gunakan kombinasi nama dan lingkungan yang unik seperti web-app-staging. Kolom ini wajib diisi.

      Anda dapat menggunakan hingga 63 karakter, termasuk huruf kecil, angka, dan tanda hubung. Nama harus diawali dengan huruf kecil dan tidak boleh diakhiri dengan tanda hubung. Nama tidak dapat diubah.

    2. Di kolom Display name, masukkan nama yang akan ditampilkan di Google Cloud console.

    3. Di kolom Description, masukkan tujuan aplikasi ini.

  5. Untuk menetapkan project default bagi komponen apa pun dengan kolom Project ID kosong, pilih project dari daftar Deployment project. Dalam batas level folder, project harus memiliki kualifikasi berikut:

    Jika komponen sudah memiliki project yang ditentukan di kolom Project ID, project tersebut akan digunakan, bukan setelan ini.

  6. Dari daftar Region, pilih region tempat komponen di-deploy. Region komponen diterapkan berdasarkan hal berikut:

    • Jika cakupan aplikasi adalah Global (default), region akan diterapkan ke komponen yang belum memiliki region yang dikonfigurasi.

    • Jika cakupan aplikasi adalah Regional, region akan diterapkan ke semua komponen.

  7. Dari daftar Environment, pilih lingkungan tempat Anda ingin men-deploy aplikasi ini. Misalnya, Anda mungkin ingin memverifikasi bahwa deployment Anda berfungsi seperti yang diharapkan di TEST.

  8. Dari daftar Criticality, pilih tingkat dampak pada bisnis Anda. Misalnya LOW atau HIGH.

  9. Untuk menentukan pemilik, di area Owners, klik Add owner, lalu masukkan nama tampilan dan email untuk hal berikut:

    • Di area Pemilik bisnis, masukkan pemilik yang bertanggung jawab atas kualitas dan ekspektasi pengguna.

    • Di area Developer owners, masukkan pemilik yang bertanggung jawab atas pengembangan dan coding.

    • Di area Operator owners, masukkan pemilik yang bertanggung jawab untuk mengoperasikan aplikasi.

  10. Dari daftar Cakupan, pilih salah satu opsi berikut:

    • Global (default): Aplikasi berisi resource global, atau resource berada di beberapa region.

    • Regional: Semua resource berada dalam satu region.

    Kolom ini wajib diisi. Untuk mengetahui informasi selengkapnya, lihat Membandingkan aplikasi global dan regional.

  11. Klik Create Application. Detail aplikasi akan ditampilkan.

gcloud CLI

  1. Identifikasi URI revisi template aplikasi untuk template yang ingin Anda gunakan untuk membuat aplikasi.

     gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --format='yaml(name,latestRevision)'

    Ganti kode berikut:

    • APPLICATION_TEMPLATE: ID template untuk template aplikasi yang ingin Anda gunakan sebagai dasar aplikasi.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: Region template aplikasi.
    • SPACE: ID ruang Anda.

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

  2. Salin output latestRevision.

  3. Buat draf aplikasi berdasarkan template Anda.

      gcloud design-center spaces applications create APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \
  --scope-type=SCOPE_TYPE

    Ganti kode berikut:

    • APPLICATION: ID aplikasi untuk draf aplikasi yang ingin Anda buat.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: Region aplikasi.
    • SPACE: ID ruang Anda.
    • SOURCE_APPLICATION_TEMPLATE_REVISION: URI template aplikasi Anda. Misalnya, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION
    • SCOPE_TYPE: Cakupan untuk aplikasi Anda. Salah satu dari regional atau global. Jika cakupan aplikasi adalah 'global, the region is applied to components that don't already have a configured region. If the application scope isregional`, region akan diterapkan ke semua komponen.

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

Mengonfigurasi komponen dan koneksi

Untuk setiap komponen dalam aplikasi, Anda dapat menentukan detail konfigurasi seperti project tempat resource dibuat, dan lokasi tempat resource di-deploy.

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.

Anda 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 Configuration, dari daftar Project ID, pilih project tempat Anda ingin men-deploy resource. Pilih project dengan kualifikasi berikut:

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

    • Wilayah
    • Konfigurasi pencadangan
    • Flag database
    • Konfigurasi IP

    Untuk link ke dokumentasi konfigurasi setiap komponen, lihat Referensi yang didukung.

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

    1. Di kanvas desain, klik koneksi antara dua komponen. Panel Connection 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. Menjelaskan aplikasi untuk melihat parameter komponen, dan mengidentifikasi parameter yang diperlukan untuk aplikasi Anda.

     gcloud design-center spaces applications describe APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --format='yaml(name,componentParameters)'

    Ganti kode berikut:

    • APPLICATION: ID aplikasi.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: Region aplikasi.
    • SPACE: ID ruang Anda.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces applications describe.

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

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

      {
    "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
    "parameters": [
       {
          "key": "service_name",
          "value": "frontend-service"
       },
       {
          "key": "project_id",
          "value": "DEPLOYMENT_PROJECT"
       }
    ]
  }

  3. Perbarui aplikasi untuk mengonfigurasi parameter yang diperlukan.

     gcloud design-center spaces applications update APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --component-parameters=COMPONENT_FILE_PATH_1

    Ganti kode berikut:

    • APPLICATION: ID aplikasi.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: Region aplikasi.
    • SPACE: ID ruang Anda.
    • COMPONENT_FILE_PATH_1: File JSON yang menyertakan parameter komponen. Untuk setiap file JSON tambahan, tambahkan argumen dan nilai --component-parameter lainnya.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces applications update.

Untuk mengetahui langkah-langkah deployment, lihat Men-deploy aplikasi.

Memverifikasi kepatuhan keamanan

Anda dapat melakukan penilaian keamanan aplikasi untuk memvalidasi konfigurasi Anda berdasarkan framework Security Command Center. Penilaian komprehensif ini mengevaluasi hal-hal berikut:

  • Nilai konfigurasi komponen: Setelan konfigurasi yang otomatis diwarisi dari template, atau setelan yang Anda ubah untuk aplikasi ini.
  • Parameter aplikasi: Detail khusus instance yang disediakan untuk aplikasi Anda, seperti region atau lingkungan deployment.
  • Komponen yang diizinkan: Layanan dan workload dalam aplikasi saat ini yang diizinkan untuk digunakan oleh organisasi Anda.

Aplikasi mewarisi framework Security Command Center dari template-nya. Pertama, administrator Anda harus melampirkan framework keamanan ke template aplikasi Anda. Kemudian, lakukan hal berikut untuk menilai kepatuhan keamanan dari aplikasi Anda:

gcloud CLI 

  gcloud alpha design-center spaces applications preview APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --generate-assessment-report=true

Ganti kode berikut:

  • APPLICATION: ID aplikasi untuk aplikasi yang ingin Anda nilai.
  • PROJECT: Project ID pengelolaan Anda.
  • LOCATION: Region aplikasi.
  • SPACE: ID ruang Anda.

Output menampilkan laporan penilaian untuk aplikasi Anda berdasarkan framework yang dilampirkan template.

Mengedit kode Terraform

Aplikasi Anda menghasilkan kode Terraform untuk mencerminkan detail desain dan konfigurasi. Anda dapat mengedit Terraform untuk menentukan detail konfigurasi komponen.

Sistem akan membuat 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 Code. Sistem akan menampilkan file Terraform yang dihasilkan.

  2. Klik main.tf. Sistem akan 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 tindakan berikut:

    1. Klik View diff.

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

    3. Klik View diff 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.

Membuat revisi aplikasi

Buat revisi aplikasi untuk mengubah detail atau komponen. Jika Anda mengubah komponen aplikasi di luar App Design Center, perubahan tersebut tidak akan dipertahankan saat Anda men-deploy ulang.

Untuk membuat revisi aplikasi:

Kanvas desain

  1. Dari menu navigasi, klik Applications.

    Buka Applications

  2. Dari tabel, klik Nama aplikasi yang ingin Anda revisi.

  3. Untuk mengubah detail aplikasi, lakukan hal berikut:

  4. Klik Edit dan ubah detailnya.

  5. Klik Simpan untuk menyimpan perubahan.

  6. Untuk mengubah komponen dalam aplikasi ini, lakukan hal berikut:

    1. Klik komponen di kanvas desain dan edit detail di area Configuration.

    2. Klik Simpan untuk menyimpan perubahan.

gcloud CLI

Lihat Mengonfigurasi komponen dan koneksi.

Untuk mengetahui langkah-langkah deployment, lihat Men-deploy aplikasi.

Menghapus aplikasi

Jika tidak lagi memerlukan aplikasi, Anda dapat menghapusnya. Misalnya, Anda dapat men-deploy aplikasi untuk memverifikasi template di lingkungan TEST, lalu menghapus aplikasi tersebut.

Anda dapat menghapus aplikasi berikut:

  • Aplikasi yang belum di-deploy. Di halaman Applications, Status tercantum sebagai Draft.
  • Aplikasi yang di-deploy ke Lingkungan TEST, DEVELOPMENT, atau STAGING.

Saat Anda menghapus aplikasi, hal berikut akan terjadi:

  • Detail aplikasi akan dihapus dari Application Design Center.
  • Aplikasi App Hub yang mendasarinya akan dihapus.
  • Jika Anda men-deploy, resource akan dihapus.

Untuk menghapus aplikasi:

Kanvas desain

  1. Dari menu navigasi, klik Applications.

    Buka Applications

  2. Dari tabel, klik Application name.

  3. Klik Actions, lalu pilih Delete Application.

  4. Di kolom Delete, masukkan nama aplikasi.

  5. Klik Hapus.

gcloud CLI

Menghapus aplikasi.

    gcloud design-center spaces applications delete APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE

Ganti kode berikut:

Langkah berikutnya