You can no longer deploy new instances of the Java application using Compute Engine Jump Start Solution. This page describes how to delete an existing deployment of the solution.

Halaman ini diterjemahkan oleh Cloud Translation API.

Menghapus aplikasi Java menggunakan Compute Engine

Last reviewed 2023-09-29 UTC

Panduan ini menjelaskan cara menghapus aplikasi Java menggunakan Solusi Praktis Compute Engine. Anda dapat menggunakan panduan ini untuk menghapus deployment solusi yang ada.

Aplikasi Java yang menggunakan Compute Engine tidak dapat lagi di-deploy dari konsol Google Cloud, dan tidak didukung.

Biaya

Untuk mengetahui perkiraan biaya resource Google Cloud yang digunakan oleh aplikasi Java yang menggunakan solusi Compute Engine, lihat perkiraan yang telah dihitung sebelumnya di Kalkulator Harga Google Cloud.

Gunakan perkiraan biaya tersebut sebagai titik awal untuk menghitung biaya deployment Anda. Anda dapat mengubah perkiraan biaya untuk mencerminkan setiap perubahan konfigurasi yang Anda buat pada resource yang digunakan dalam solusi.

Perkiraan yang telah dihitung sebelumnya didasarkan pada asumsi untuk faktor-faktor tertentu, termasuk hal-hal berikut:

Lokasi Google Cloud tempat resource di-deploy.
Durasi waktu resource tersebut digunakan.

Anda juga dapat meninjau biaya penggunaan untuk resource yang telah di-deploy. Untuk detail selengkapnya, lihat Melihat laporan penagihan dan tren biaya.

Mendapatkan izin IAM yang diperlukan

Untuk menghapus deployment yang ada, Anda memerlukan izin Identity and Access Management (IAM) yang tercantum dalam tabel berikut. Jika Anda memiliki peran dasar roles/owner untuk project tempat solusi di-deploy, berarti Anda telah memiliki semua izin yang diperlukan. Jika Anda tidak memiliki peran roles/owner, mintalah administrator Anda untuk memberikan izin ini (atau peran yang menyertakan izin ini) kepada Anda.

Izin IAM diperlukan	Peran bawaan yang mencakup izin yang diperlukan
`serviceusage.services.enable`	Service Usage Admin (`roles/serviceusage.serviceUsageAdmin`)
`iam.serviceAccounts.create`	Service Account Admin (`roles/iam.serviceAccountAdmin`)
`resourcemanager.projects.setIamPolicy`	Project IAM Admin (`roles/resourcemanager.projectIamAdmin`)
`config.deployments.create` `config.deployments.list`	Cloud Infrastructure Manager Admin (`roles/config.admin`)

Akun layanan yang dibuat untuk solusi

Saat Anda memulai proses penghapusan melalui konsol, akun layanan akan dibuat untuk men-deploy solusi atas nama Anda (dan akan menghapus deployment jika Anda menginginkannya). Akun layanan ini diberi izin IAM tertentu untuk sementara; izin tersebut akan secara otomatis dicabut setelah operasi deployment dan penghapusan solusi selesai. Google merekomendasikan bahwa setelah Anda menghapus deployment, Anda harus menghapus akun layanan, seperti yang akan dijelaskan dalam panduan ini.

Melihat peran yang ditetapkan ke akun layanan

Peran-peran tersebut tercantum di sini untuk mengantisipasi jika administrator project Google Cloud atau organisasi Anda membutuhkan informasi ini.

roles/compute.admin
roles/cloudsql.admin
roles/logging.admin
roles/monitoring.admin
roles/resourcemanager.projectIamAdmin
roles/secretmanager.admin
roles/iam.serviceAccountAdmin
roles/servicenetworking.networksAdmin
roles/serviceusage.serviceUsageAdmin
roles/storage.admin
roles/storage.hmacKeyAdmin
roles/file.editor
roles/iam.serviceAccountUser

Menghapus deployment

Jika tidak lagi membutuhkan solusi, hapus semua resource yang telah Anda buat dalam solusi tersebut untuk menghindari penagihan berkelanjutan.

Menghapus melalui konsol

Gunakan prosedur ini jika Anda men-deploy solusi melalui konsol.

Pada Konsol Google Cloud, buka halaman Deployment solusi.

Buka Deployment solusi
Pilih project berisi deployment yang ingin Anda hapus.
Cari deployment yang ingin Anda hapus.
Di baris untuk deployment, klik Tindakan, lalu pilih Hapus.

Anda mungkin perlu men-scroll untuk melihat Tindakan di baris.
Masukkan nama deployment, lalu klik Konfirmasi.

Kolom Status menampilkan Menghapus.

Jika penghapusan gagal, lihat panduan pemecahan masalah pada bagian Error saat menghapus deployment.

Jika tidak lagi memerlukan project Google Cloud yang digunakan untuk solusi, Anda dapat menghapus project tersebut. Untuk informasi selengkapnya, lihat Opsional: Menghapus project

Menghapus menggunakan Terraform CLI

Gunakan prosedur ini jika Anda men-deploy solusi menggunakan Terraform CLI.

Di Cloud Shell, pastikan direktori kerja saat ini adalah $HOME/cloudshell_open/terraform-example-deploy-java-multizone/infra. Jika bukan, buka direktori tersebut.
Hapus resource yang disediakan oleh Terraform:
```
terraform destroy
```
Terraform menampilkan daftar resource yang akan dimusnahkan.
Ketika Anda diminta untuk melakukan tindakan, masukkan yes.

Terraform menampilkan pesan yang menunjukkan progres. Setelah semua resource dihapus, Terraform akan menampilkan pesan berikut:
```
Destroy complete!
```
Jika penghapusan gagal, lihat panduan pemecahan masalah pada bagian Error saat menghapus deployment.

Jika tidak lagi memerlukan project Google Cloud yang digunakan untuk solusi, Anda dapat menghapus project tersebut. Untuk informasi selengkapnya, lihat Opsional: Menghapus project

Opsional: Menghapus project

Jika Anda men-deploy solusi di project Google Cloud baru, dan tidak lagi memerlukan project tersebut, hapus dengan melakukan langkah-langkah berikut:

Pada Konsol Google Cloud, buka halaman Kelola resource
Buka Kelola resource
Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus.
Pada layar perintah, ketik project ID, lalu klik Matikan.

Jika Anda memutuskan untuk mempertahankan project, hapus akun layanan yang dibuat untuk solusi ini, seperti yang akan dijelaskan pada bagian selanjutnya.

Opsional: Menghapus akun layanan

Jika Anda menghapus project yang digunakan untuk solusi tersebut, lewati bagian ini.

Seperti yang telah disebutkan dalam panduan ini, ketika men-deploy solusi, akun layanan akan dibuat atas nama Anda. Akun layanan telah diberi izin IAM tertentu untuk sementara; yaitu, izin yang otomatis dicabut setelah operasi deployment dan penghapusan solusi selesai, tetapi akun layanan tidak dihapus. Google merekomendasikan agar Anda menghapus akun layanan ini.

Jika Anda men-deploy solusi melalui Konsol Google Cloud, buka halaman Deployment solusi. (Jika Anda sudah berada di halaman tersebut, muat ulang browser.) Proses terpicu di latar belakang untuk menghapus akun layanan. Tidak ada tindakan lebih lanjut yang diperlukan.
Jika Anda men-deploy solusi menggunakan Terraform CLI, lakukan langkah-langkah berikut:
1. Di Konsol Google Cloud, buka halaman Service accounts.
  
  Buka halaman Service accounts
2. Pilih project yang Anda gunakan untuk solusi tersebut.
3. Pilih akun layanan yang ingin Anda hapus.
  
  ID email akun layanan yang digunakan untuk membuat solusi menggunakan format berikut:
```
goog-sc-DEPLOYMENT_NAME-NNN@PROJECT_ID.
```
  ID email berisi nilai-nilai berikut:
  - DEPLOYMENT_NAME: nama deployment.
  - NNN: 3 digit angka acak.
  - PROJECT_ID: ID project tempat Anda men-deploy solusi.
4. Klik Delete.

Mengatasi error

Jika Anda mengalami error, lihat hal berikut:

Error ketika menghapus deployment

Dalam kasus tertentu, upaya untuk menghapus deployment mungkin akan gagal:

Jika Anda mengubah resource yang disediakan oleh solusi setelah men-deploy solusi melalui konsol, lalu Anda mencoba menghapus deployment, penghapusan mungkin akan gagal. Kolom Status pada halaman Deployment solusi akan menampilkan Gagal, dan log Cloud Build akan menunjukkan penyebab error.
Jika Anda mengubah resource dengan menggunakan antarmuka non-Terraform (misalnya, konsol) setelah men-deploy solusi menggunakan Terraform CLI, kemudian Anda mencoba menghapus deployment, penghapusan mungkin akan gagal. Pesan dalam output perintah terraform destroy menunjukkan penyebab error.

Tinjau log dan pesan error serta identifikasi dan hapus resource yang menyebabkan error tersebut. Setelah itu, coba hapus kembali deployment.

Jika deployment berbasis konsol tidak dapat dihapus dan Anda tidak dapat mendiagnosis error menggunakan log Cloud Build, Anda dapat menghapus deployment tersebut menggunakan Terraform CLI yang akan dijelaskan pada bagian berikutnya.

Menghapus deployment berbasis konsol menggunakan Terraform CLI

Bagian ini menjelaskan cara menghapus deployment berbasis konsol jika terjadi error saat Anda mencoba menghapusnya melalui konsol. Dalam pendekatan ini, Anda perlu mendownload konfigurasi Terraform untuk deployment yang ingin dihapus, lalu gunakan Terraform CLI untuk menghapus deployment tersebut.

Identifikasi region tempat kode Terraform, log, dan data deployment lainnya disimpan. Region ini mungkin berbeda dari region yang Anda pilih ketika men-deploy solusi.
1. Pada Konsol Google Cloud, buka halaman Deployment solusi.
  
  Buka Deployment solusi
2. Pilih project berisi deployment yang ingin Anda hapus.
3. Dalam daftar deployment, identifikasi baris deployment yang ingin Anda hapus.
4. Klik Lihat semua konten baris.
5. Pada kolom Lokasi, catat lokasi kedua seperti yang ditandai dalam contoh berikut:
Di konsol Google Cloud, aktifkan Cloud Shell.

Aktifkan Cloud Shell

Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.
Membuat variabel lingkungan untuk project ID, region, dan nama deployment yang ingin Anda hapus:
```
export REGION="REGION"
export PROJECT_ID="PROJECT_ID"
export DEPLOYMENT_NAME="DEPLOYMENT_NAME"
```
Dalam perintah ini, ganti kode berikut:
- REGION: lokasi yang Anda catat sebelumnya dalam prosedur ini.
- PROJECT_ID: ID project tempat Anda men-deploy solusi.
- DEPLOYMENT_NAME: nama deployment yang ingin Anda hapus.

Dapatkan ID revisi deployment terbaru yang ingin Anda hapus:

export REVISION_ID=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .latestRevision -r)
    echo $REVISION_ID

Outputnya mirip dengan yang berikut ini:

projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME/revisions/r-0

Dapatkan lokasi Cloud Storage dari konfigurasi Terraform untuk deployment:

export CONTENT_PATH=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/${REVISION_ID}" \
    | jq .applyResults.content -r)
    echo $CONTENT_PATH

Berikut adalah contoh output dari perintah ini:

gs://PROJECT_ID-REGION-blueprint-config/DEPLOYMENT_NAME/r-0/apply_results/content

Download konfigurasi Terraform dari Cloud Storage ke Cloud Shell:
```
gcloud storage cp $CONTENT_PATH $HOME --recursive
cd $HOME/content/infra
```
Tunggu hingga pesan Operation completed ditampilkan, seperti yang ditunjukkan dalam contoh berikut:
```
Operation completed over 45 objects/268.5 KiB
```
Lakukan inisialisasi Terraform:
```
terraform init
```
Tunggu hingga Anda melihat pesan berikut:
```
Terraform has been successfully initialized!
```
Menghapus resource yang di-deploy:
```
terraform destroy
```
Terraform menampilkan daftar resource yang akan dimusnahkan.

Jika muncul peringatan tentang variabel yang tidak dideklarasikan, abaikan peringatan tersebut.
Ketika Anda diminta untuk melakukan tindakan, masukkan yes.

Terraform menampilkan pesan yang menunjukkan progres. Setelah semua resource dihapus, Terraform akan menampilkan pesan berikut:
```
Destroy complete!
```

Menghapus artefak deployment:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}?force=true&delete_policy=abandon"

Tunggu beberapa detik, lalu verifikasi bahwa artefak deployment telah dihapus:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .error.message

Jika output menampilkan null, tunggu beberapa detik, lalu jalankan kembali perintah.

Setelah artefak deployment dihapus, pesan seperti yang ditunjukkan pada contoh yang ditampilkan berikut ini:

Resource 'projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME' was not found