Men-deploy aplikasi

Setelah membuat draf aplikasi dari template, Anda dapat men-deploy aplikasi. Saat Anda men-deploy aplikasi menggunakan App Design Center, aplikasi Anda akan otomatis terdaftar di App Hub. Proses deployment memungkinkan Anda melakukan hal berikut:

• Melihat pratinjau perubahan yang direncanakan Terraform untuk infrastruktur Anda.
• Mengaktifkan Google Cloud resource API yang diperlukan untuk aplikasi Anda.
• Menyelidiki masalah deployment.
• Menggunakan data telemetri untuk menganalisis performa resource.
• Mengidentifikasi dan menerapkan revisi template ke aplikasi Anda.

Dokumen ini membantu Anda men-deploy, mengelola, dan menerapkan revisi template ke aplikasi Anda.

Sebelum memulai

Untuk melakukan tugas dalam dokumen ini, minta administrator Anda untuk memberi Anda peran yang diperlukan di project pengelolaan atau folder yang mendukung aplikasi, 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	Admin IAM Project (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 an aplikasi, Google Cloud resource akan dibuat, dan Anda 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 membuat perubahan.

   Catatan: Jika Anda berencana men-deploy dan menghapus aplikasi ini nanti, 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 Akun layanan, masukkan nama akun layanan yang ada. Untuk mengonfigurasi akun layanan, lihat Memberikan peran ke akun layanan Anda.

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

6. Klik Proceed.

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

   1. Klik Preview.

   2. Tinjau perubahan, lalu klik Copy and close. Pratinjau akan disalin ke papan klip Anda.

   3. Untuk menyimpan pratinjau, tempel dan simpan dalam 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 saat 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 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 hal 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 deployment 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 hal 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 masalah 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 Anda gagal, Anda dapat melihat ringkasan error, mendapatkan analisis mendetail, mengidentifikasi langkah-langkah untuk menyelesaikannya, dan memperbaiki beberapa masalah secara otomatis.

Untuk memecahkan masalah dan memperbaiki error, lakukan hal berikut:

1. Di panel Application details, klik Deployments.

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

   Panel Troubleshooting details menampilkan saran dokumentasi, perubahan konfigurasi, dan informasi lainnya yang dapat membantu Anda mengatasi error deployment.

3. Tinjau error dan rekomendasi deployment:

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

   2. Jika hasil analisis menghasilkan rekomendasi lainnya, sistem akan menampilkan perintah gcloud CLI yang dapat Anda jalankan untuk mengatasi 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 dapat 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 hal berikut:

Kanvas desain

1. Dari menu navigasi, klik Applications.

   Buka Applications

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

   • View app in App Hub: Selidiki aplikasi Anda di Pusat Aplikasi. 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 diupdate, template sumber, region, dan akun layanan.

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

   • Deployments: 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 perubahan Anda dipertahankan saat Anda men-deploy ulang aplikasi:

• Merevisi template, lalu Menerapkan revisi template
• Merevisi aplikasi

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

   Buka Template

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

3. Dari daftar Configure an app, pilih aplikasi yang ingin Anda update.

4. Edit detail aplikasi, lalu klik Save.

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

6. Klik Deploy. Untuk 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 di aplikasi, lihat Mengonfigurasi komponen dan koneksi.

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

Langkah berikutnya

• Lacak workload Anda dengan memantau kondisi dan performa aplikasi.
• Mulai gunakan arsitektur yang telah dikonfigurasi sebelumnya dengan membuat aplikasi berdasarkan template Google.