Men-deploy aplikasi

Men-deploy draf aplikasi di App Design Center memungkinkan Anda menyediakan resource Google Cloud dan mendaftarkan aplikasi secara otomatis di App Hub. Sebelum men-deploy, Anda dapat melihat pratinjau perubahan Terraform yang direncanakan, menilai desain Anda berdasarkan kebijakan organisasi, dan mengaktifkan APIGoogle Cloud yang diperlukan. Setelah deployment, Anda dapat menyelidiki masalah deployment, menganalisis performa resource menggunakan data telemetri, dan menerapkan revisi template baru ke aplikasi Anda.

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
Men-deploy aplikasi dan menerapkan revisi template	Admin Aplikasi (roles/designcenter.applicationAdmin), atau Operator Aplikasi (roles/designcenter.applicationOperator)
Membuat akun layanan secara otomatis selama deployment	Project IAM Admin (roles/resourcemanager.projectIamAdmin)

Untuk men-deploy aplikasi menggunakan akun layanan yang ada, lihat Memberikan peran ke akun layanan Anda.

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

Men-deploy aplikasi Anda

Pilih opsi akun layanan dan deploy aplikasi Anda. Saat Anda men-deploy aplikasi, resource Google Cloud akan dibuat, dan Anda akan mulai dikenai biaya yang terkait dengan resource tersebut.

Kanvas desain

1. Dari menu navigasi, klik Applications.

   Buka Applications

2. Dari tabel, klik Application name.

3. Dari halaman Application details, tinjau detailnya, lalu klik Edit untuk melakukan perubahan.

   Catatan: Jika Anda berencana men-deploy dan nantinya menghapus aplikasi ini, deploy ke Environment TEST, DEVELOPMENT, atau STAGING.

4. Klik Deploy.

5. Pilih salah satu akun layanan berikut untuk men-deploy aplikasi Anda:

   • Pilih akun layanan: Di kolom Service account, masukkan nama akun layanan yang ada. Untuk mengonfigurasi akun layanan, lihat Memberikan peran ke akun layanan Anda.

   • Membuat akun layanan baru: Anda harus memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin), yang digunakan untuk menetapkan peran deployment yang diperlukan ke akun layanan.

6. Klik Lanjutkan.

7. Untuk melihat pratinjau perubahan yang direncanakan Terraform pada infrastruktur Anda, lakukan hal berikut:

   1. Klik Pratinjau.

   2. Tinjau perubahan, lalu klik Salin dan tutup. Pratinjau disalin ke papan klip Anda.

   3. Untuk menyimpan pratinjau, tempel dan simpan di dokumen pilihan Anda.

8. Di area Review APIs, tinjau daftar API yang diperlukan untuk aplikasi Anda. API akan otomatis diaktifkan saat Anda men-deploy.

9. Klik Deploy. Detail aplikasi dan status deployment akan ditampilkan setelah deployment selesai.

10. Jika ada masalah dengan deployment Anda, lakukan hal berikut:

    1. Di panel Application details, klik Deployments.

    2. Tinjau pesan error.

    3. Klik View logs untuk melihat informasi build yang mendetail.

    4. Untuk melihat saran guna memperbaiki error deployment, klik Troubleshoot Deployment (Pratinjau).

       Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah dan memperbaiki masalah deployment.

    Tips: Untuk melihat daftar aplikasi yang mengalami masalah deployment di Cloud Hub, lihat Melihat deployment.

11. Untuk mengelola aplikasi yang di-deploy, lihat Melihat detail aplikasi.

gcloud CLI

1. Lihat pratinjau aplikasi untuk melihat kode Terraform sebelum Anda men-deploy. Operasi ini mungkin memerlukan waktu beberapa menit hingga selesai. Lakukan salah satu hal berikut:

   • Untuk membuat akun layanan secara otomatis, gunakan perintah berikut:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

   • Untuk menggunakan akun layanan Anda sendiri, gunakan perintah berikut:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

   Ganti kode berikut:

   • APPLICATION: ID aplikasi.
   • PROJECT: ID project pengelolaan Anda.
   • LOCATION: Region aplikasi.
   • SPACE: ID ruang Anda.
   • SERVICE_ACCOUNT: Lakukan salah satu tindakan berikut:
     • Untuk membuat akun layanan baru, berikan nama untuk akun layanan.
     • Untuk menggunakan akun layanan Anda sendiri, berikan nama resource lengkap dalam format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

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

2. Deploy aplikasi secara asinkron dan salin nama operasi lengkap. Lakukan salah satu hal berikut:

   Catatan: Untuk mengupdate aplikasi yang ada, tambahkan flag --replace ke perintah deploy berikut.

   • Untuk membuat akun layanan secara otomatis, gunakan perintah berikut:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   • Untuk menggunakan akun layanan Anda sendiri, gunakan perintah berikut:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   Ganti kode berikut:

   • APPLICATION: ID aplikasi.
   • PROJECT: ID project pengelolaan Anda.
   • LOCATION: Region aplikasi.
   • SPACE: ID ruang Anda.
   • SERVICE_ACCOUNT: Lakukan salah satu tindakan berikut:
     • Untuk membuat akun layanan baru, berikan nama untuk akun layanan.
     • Untuk menggunakan akun layanan Anda sendiri, berikan nama resource lengkap dalam format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

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

3. Deployment memerlukan waktu beberapa menit hingga selesai. Lacak status deployment.

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

   Ganti kode berikut:

   • OPERATION: Nama operasi lengkap yang disalin dari output perintah deploy dalam format projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT: ID project pengelolaan Anda.
   • LOCATION: Region aplikasi.

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

Memecahkan dan memperbaiki masalah deployment

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.

Jika deployment aplikasi gagal, Anda dapat melihat ringkasan error, mendapatkan analisis mendetail, mengidentifikasi langkah-langkah untuk menyelesaikan, dan memperbaiki beberapa masalah secara otomatis.

Untuk memecahkan masalah dan memperbaiki error, lakukan tindakan berikut:

1. Di panel Application details, klik Deployments.

2. Untuk menganalisis error dan menyarankan perbaikan, klik Troubleshoot Deployment.

   Panel Detail pemecahan masalah menampilkan saran dokumentasi, perubahan konfigurasi, dan informasi lain yang dapat membantu Anda menyelesaikan error deployment.

3. Tinjau error dan rekomendasi deployment:

   1. Jika analisis menghasilkan rekomendasi konfigurasi komponen, tinjau perubahan yang disarankan dan klik Update Application untuk menerapkan perubahan.

   2. Jika analisis menghasilkan rekomendasi lain, sistem akan menampilkan perintah gcloud CLI yang dapat Anda jalankan untuk menyelesaikan error. Untuk menjalankan perintah gcloud CLI di Cloud Shell, klik Run command.

Melihat detail aplikasi

Setelah deployment aplikasi selesai, Anda dapat memeriksa informasi terkaitnya. Misalnya, Anda mungkin melihat hal berikut:

• Detail seperti waktu update terakhir, tanggal revisi, dan region.
• Output seperti URI layanan.
• Status deployment, informasi error, dan link ke log.

Untuk melihat detail aplikasi, lakukan langkah berikut:

Kanvas desain

1. Dari menu navigasi, klik Applications.

   Buka Applications

2. Dari tabel, klik Application name. Panel Application details menampilkan hal berikut:

   • Lihat aplikasi di App Hub: Selidiki aplikasi Anda di App Hub. Anda dapat melihat resource yang di-deploy dan memeriksa data telemetri untuk mendiagnosis masalah dan menganalisis performa. Untuk mengetahui informasi selengkapnya, lihat Memantau aplikasi App Hub.

   • Detail Aplikasi: Lihat informasi seperti tanggal terakhir diperbarui, template sumber, region, dan akun layanan.

   • Output: Mengidentifikasi URI layanan, yang dapat Anda gunakan untuk berinteraksi dengan frontend atau backend aplikasi.

   • Deployment: Periksa status deployment, error deployment, dan link ke log untuk memecahkan masalah error.

gcloud CLI

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

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.

Mengubah aplikasi yang di-deploy

Jika Anda ingin mengubah aplikasi yang di-deploy, lakukan salah satu hal berikut untuk memastikan bahwa perubahan Anda dipertahankan saat Anda men-deploy ulang aplikasi:

• Revisi template, lalu Terapkan revisi template
• Merevisi permohonan

Menerapkan revisi template

Jika aplikasi Anda sebelumnya di-deploy menggunakan App Design Center, dan administrator telah membagikan revisi template kepada Anda, Anda dapat menerapkan perubahan template ke aplikasi Anda. Saat Anda mengupdate aplikasi, revisi aplikasi akan dibuat. Anda dapat mengonfigurasi komponen yang diubah atau ditambahkan ke template yang direvisi.

Anda dapat melihat revisi template yang tersedia untuk aplikasi Anda menggunakan Cloud Hub. Untuk mengetahui informasi selengkapnya, lihat Melihat deployment.

Untuk menerapkan revisi template ke aplikasi Anda, lakukan hal berikut:

Perhatian: Jika Anda mengubah komponen aplikasi di luar App Design Center, perubahan tersebut tidak akan dipertahankan saat Anda men-deploy ulang. Untuk mempertahankan perubahan, lihat Mengubah aplikasi yang di-deploy.

Kanvas desain

1. Dari menu navigasi, klik Template.

   Buka Template

2. Klik ID Template yang berisi revisi yang ingin Anda terapkan.

3. Dari daftar Konfigurasi aplikasi, pilih aplikasi yang ingin Anda perbarui.

4. Edit detail aplikasi, lalu klik Simpan.

5. Klik setiap komponen di kanvas desain, dan ubah konfigurasi komponen.

6. Klik Deploy. Untuk mengetahui langkah-langkah deployment, lihat Men-deploy aplikasi Anda.

gcloud CLI

1. Identifikasi URI revisi template aplikasi untuk revisi terbaru.

    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 aplikasi yang menjadi dasar aplikasi Anda.
   • 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. Update aplikasi untuk menggunakan revisi template aplikasi.

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

   Ganti kode berikut:

   • APPLICATION: ID aplikasi.
   • 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

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

4. Untuk mengonfigurasi komponen baru atau yang diupdate dalam aplikasi, lihat Mengonfigurasi komponen dan koneksi.

5. Saat Anda men-deploy aplikasi, gunakan flag --replace. Untuk mengetahui langkah-langkah deployment, lihat Men-deploy aplikasi Anda.

Langkah berikutnya

• Lacak workload Anda dengan memantau respons dan performa aplikasi.
• Mulai gunakan arsitektur yang telah dikonfigurasi sebelumnya dengan membangun di template Google.