Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mereset node dan menghapus cluster

Saat cluster Google Distributed Cloud sedang dalam proses penginstalan, biner dan layanan systemd diinstal pada node yang menghosting cluster tersebut, dan layanan mulai memproses port di node.

Namun, jika penginstalan cluster gagal, semua biner dan layanan ini harus dihapus. Dengan kata lain, node harus di-reset atau dihapus sepenuhnya untuk mempersiapkannya agar dapat mencoba kembali menginstal cluster. Jika node tidak direset dengan cara ini, upaya berikutnya untuk menginstal cluster di node tersebut akan gagal.

Halaman ini menjelaskan cara melakukan operasi pembersihan node tertentu dan cara menghapus cluster.

Halaman ini ditujukan untuk Admin, arsitek, dan Operator yang mengelola siklus proses infrastruktur teknologi yang mendasarinya. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam Google Cloud konten, lihat Peran dan tugas pengguna GKE umum.

Memilih metode penghapusan

Metode yang Anda gunakan untuk menghapus cluster bergantung pada:

Jenis cluster.
Apakah Anda hanya ingin membersihkan node tertentu dan tidak menghapus seluruh cluster.
Cara cluster dibuat.

Google Distributed Cloud menyediakan metode penghapusan berikut:

Konsol atau Google Cloud CLI: Google Cloud
- Gunakan konsol atau gcloud CLI untuk menghapus cluster pengguna yang dikelola oleh GKE On-Prem API. Cluster pengguna dikelola oleh GKE On-Prem API jika salah satu hal berikut benar:
  - Cluster dibuat di Google Cloud konsol atau menggunakan gcloud CLI, yang secara otomatis mengonfigurasi GKE On-Prem API untuk mengelola cluster.
  - Cluster dibuat menggunakan bmctl, tetapi dikonfigurasi untuk dikelola oleh GKE On-Prem API.
bmctl:
- Gunakan bmctl reset nodes untuk mereset node tertentu.
- Gunakan bmctl reset untuk menghapus jenis cluster berikut:
  - Cluster admin, hybrid, dan mandiri (disebut sebagai cluster yang dikelola sendiri). Hal ini mencakup cluster admin yang dikelola oleh GKE On-Prem API.
  - Cluster pengguna yang tidak dikelola oleh GKE On-Prem API.
Jika Anda menggunakan bmctl untuk mereset node atau menghapus cluster, perintah tersebut mengharapkan file konfigurasi cluster berada di direktori kerja saat ini. Secara default, jalur tersebut seperti berikut:

bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME.yaml

Jika Anda menggunakan flag --workspace-dir untuk menentukan direktori lain selama pembuatan cluster, Anda harus menggunakan flag tersebut untuk menentukan direktori kerja selama reset cluster.
kubectl:
- Gunakan kubectl delete cluster untuk menghapus cluster pengguna saja yang tidak dikelola oleh cluster GKE On-Prem API. Jangan menjalankan perintah pada jenis cluster lainnya.
- Perhatikan bahwa jika Anda menggunakan kubectl delete cluster, Anda juga harus menghapus namespace tempat cluster berada setelah menghapus cluster.

Setelah menghapus cluster, Anda dapat menginstalnya kembali setelah melakukan perubahan konfigurasi yang diperlukan.

Menghapus cluster yang dikelola sendiri

Untuk menghapus cluster admin, hybrid, atau mandiri, jalankan perintah berikut:

bmctl reset --cluster CLUSTER_NAME

Dalam perintah, ganti CLUSTER_NAME dengan nama cluster yang ingin Anda reset.

Output dari perintah bmctl cluster reset terlihat mirip dengan contoh ini:

Please check the logs at bmctl-workspace/example-cluster-1/log/reset-20221025-184705/reset.log
[2022-10-25 18:47:11+0000] Creating bootstrap cluster... OK
[2022-10-25 18:48:18+0000] Loading images... OK
[2022-10-25 18:48:18+0000] Waiting for reset jobs to finish...
[2022-10-25 18:48:28+0000] Operation reset in progress: 1       Completed: 0    Failed: 0
...
[2022-10-25 18:50:08+0000] Operation reset in progress: 0       Completed: 1    Failed: 0
[2022-10-25 18:50:08+0000] Flushing logs... OK
[2022-10-25 18:50:08+0000] Deleting GKE Hub member example-cluster-1 in project example-project-12345...
[2022-10-25 18:50:11+0000] Successfully deleted GKE Hub member example-cluster-1 in project example-project-12345
[2022-10-25 18:50:11+0000] Deleting bootstrap cluster... OK

Selain menghapus cluster, perintah ini juga menghapus keanggotaan cluster dari fleet.

Untuk cluster admin yang dikelola oleh GKE On-Prem API, Anda juga perlu menghapus resource API di Google Cloud. Jika tidak, cluster akan ditampilkan di cluster GKE halaman di Google Cloud konsol. Gunakan perintah berikut untuk menghapus resource GKE On-Prem API untuk cluster admin:

gcloud container bare-metal admin-clusters unenroll CLUSTER_NAME \
    --project=FLEET_HOST_PROJECT_ID \
    --location=REGION \
    --ignore-errors

Ganti kode berikut:

FLEET_HOST_PROJECT_ID: Project ID fleet tempat cluster admin menjadi anggota.
REGION: Region tempat GKE On-Prem API menyimpan metadata cluster. Google Cloud

Flag --ignore-errors memastikan bahwa pembatalan pendaftaran resource cluster admin bare metal berhasil meskipun terjadi error selama pembatalan pendaftaran.

Setelah penghapusan cluster selesai, Anda dapat membuat cluster baru. Untuk mengetahui detailnya, lihat Ringkasan pembuatan cluster.

Menghapus cluster pengguna

Jika cluster pengguna dikelola oleh GKE On-Prem API, hapus cluster menggunakan konsol atau gcloud CLI. Jika tidak, gunakan bmctl atau kubectl untuk menghapus cluster.

`bmctl`

Anda dapat menggunakan bmctl untuk menghapus cluster pengguna yang dibuat dengan bmctl atau kubectl, dan yang tidak terdaftar di GKE On-Prem API.

Jalankan perintah berikut untuk menghapus cluster pengguna dengan bmctl:

bmctl reset --cluster USER_CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH

Dalam perintah, ganti entri berikut dengan informasi khusus untuk lingkungan Anda:

USER_CLUSTER_NAME: nama cluster pengguna yang Anda hapus.
ADMIN_KUBECONFIG_PATH: jalur ke file kubeconfig cluster admin terkait. bmctl mendukung penggunaan --kubeconfig sebagai alias untuk flag --admin-kubeconfig.

Output dari perintah bmctl cluster reset terlihat mirip dengan contoh ini:

Please check the logs at bmctl-workspace/example-cluster-1/log/reset-20221025-184705/reset.log
[2022-10-25 18:47:11+0000] Creating bootstrap cluster... OK
[2022-10-25 18:48:18+0000] Loading images... OK
[2022-10-25 18:48:18+0000] Waiting for reset jobs to finish...
[2022-10-25 18:48:28+0000] Operation reset in progress: 1       Completed: 0    Failed: 0
...
[2022-10-25 18:50:08+0000] Operation reset in progress: 0       Completed: 1    Failed: 0
[2022-10-25 18:50:08+0000] Flushing logs... OK
[2022-10-25 18:50:08+0000] Deleting GKE Hub member example-cluster-1 in project example-project-12345...
[2022-10-25 18:50:11+0000] Successfully deleted GKE Hub member example-cluster-1 in project example-project-12345
[2022-10-25 18:50:11+0000] Deleting bootstrap cluster... OK

`kubectl`

Anda dapat menggunakan kubectl untuk menghapus cluster pengguna yang dibuat dengan bmctl atau kubectl, dan yang tidak terdaftar di GKE On-Prem API. Untuk menggunakan kubectl guna menghapus cluster pengguna, Anda harus menghapus objek cluster terlebih dahulu, lalu namespace-nya. Jika tidak, tugas untuk mereset mesin tidak dapat dibuat, dan proses penghapusan mungkin akan macet tanpa batas waktu.

Untuk menghapus cluster pengguna dengan kubectl:

Jalankan perintah berikut untuk menghapus objek cluster:
```
kubectl delete cluster USER_CLUSTER_NAME -n USER_CLUSTER_NAMESPACE \
    --kubeconfig ADMIN_KUBECONFIG_PATH
```
Dalam perintah, ganti entri berikut dengan informasi khusus untuk lingkungan Anda:
- USER_CLUSTER_NAME: nama cluster pengguna yang Anda hapus.
- USER_CLUSTER_NAMESPACE: namespace untuk cluster. Secara default, namespace cluster untuk Google Distributed Cloud adalah nama cluster yang diawali dengan cluster-. Misalnya, jika Anda memberi nama cluster test, namespace akan memiliki nama seperti cluster-test.
- ADMIN_KUBECONFIG_PATH: jalur ke file kubeconfig cluster admin terkait.

Setelah cluster berhasil dihapus, jalankan perintah berikut untuk menghapus namespace:

kubectl delete namespace USER_CLUSTER_NAMESPACE --kubeconfig ADMIN_KUBECONFIG_PATH

Konsol

Jika cluster pengguna dikelola oleh GKE On-Prem API, lakukan langkah-langkah berikut untuk menghapus cluster:

Di konsol, buka halaman Ringkasan cluster Google Kubernetes Engine.

Buka cluster GKE
Pilih project tempat cluster pengguna berada. Google Cloud
Dalam daftar cluster, klik cluster yang ingin Anda hapus.
Dalam daftar cluster, temukan cluster yang ingin Anda hapus. Jika Jenis adalah eksternal, hal ini menunjukkan bahwa cluster dibuat menggunakan bmctl dan tidak terdaftar di GKE On-Prem API. Dalam hal ini, ikuti langkah-langkah di tab bmctl atau kubectl untuk menghapus cluster.

Jika ikon di kolom Status menunjukkan masalah, ikuti langkah-langkah di tab gcloud CLI untuk menghapus cluster. Anda harus menambahkan flag --ignore-errors ke perintah penghapusan.
Klik nama cluster yang ingin Anda hapus.
Di panel Detail, di dekat bagian atas jendela, klik Hapus.
Saat diminta untuk mengonfirmasi, masukkan nama cluster, lalu klik Hapus.

gcloud CLI

Jika cluster pengguna dikelola oleh GKE On-Prem API, lakukan langkah-langkah berikut untuk menghapus cluster di komputer yang telah menginstal gcloud CLI:

Login dengan Akun Google.
```
gcloud auth login
```
Perbarui komponen:
```
gcloud components update
```
Dapatkan daftar cluster untuk membantu memastikan bahwa Anda menentukan nama cluster yang benar dalam perintah penghapusan:
```
gcloud container bare-metal clusters list \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION
```
Ganti kode berikut:
- FLEET_HOST_PROJECT_ID: ID project tempat cluster dibuat.
- LOCATION: Lokasi yang terkait dengan cluster pengguna. Google Cloud
Outputnya mirip dengan hal berikut ini:
```
NAME                      LOCATION    VERSION         ADMIN_CLUSTER            STATE
example-user-cluster-1a   us-west1    1.35.0-gke.525          example-admin-cluster-1  RUNNING
```
Jalankan perintah berikut untuk menghapus cluster:
```
gcloud container bare-metal clusters delete USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing
```
Ganti kode berikut:
- USER_CLUSTER_NAME: Nama cluster pengguna yang akan dihapus.
- FLEET_HOST_PROJECT_ID: ID project tempat cluster dibuat.
- LOCATION: Lokasi yang terkait dengan cluster pengguna. Google Cloud
Flag --force memungkinkan Anda menghapus cluster yang memiliki node pool. Tanpa flag --force, Anda harus menghapus node pool terlebih dahulu, lalu menghapus cluster.

Flag --allow-missing adalah flag Google API standar. Jika Anda menyertakan flag ini, perintah akan menampilkan keberhasilan jika cluster tidak ditemukan.

Jika perintah menampilkan error yang berisi teks failed connecting to the cluster's control plane, hal ini menunjukkan masalah konektivitas dengan cluster admin, Connect Agent, atau lingkungan lokal. Untuk memecahkan masalah dengan Connect Agent, lihat Mengumpulkan log Connect Agent.
- Jika Anda merasa masalah konektivitas bersifat sementara, misalnya, karena masalah jaringan, tunggu dan coba lagi perintahnya.
- Jika Anda mengetahui bahwa cluster admin telah dihapus, atau jika mesin node untuk cluster admin atau pengguna telah dimatikan atau di-offline-kan, sertakan flag --ignore-errors dan coba lagi perintahnya.
  
  Anda juga harus menyertakan --ignore-errors jika cluster dihapus menggunakan bmctl atau kubectl, yang akan meninggalkan resource GKE On-Prem API di Google Cloud. Salah satu gejalanya adalah cluster masih ditampilkan di halaman cluster GKE di konsol dalam status tidak sehat.
Perhatian: Jika cluster admin dan pengguna tidak dapat dijangkau, dan Anda menyertakan --ignore-errors, perintah penghapusan hanya akan menghapus Google Cloud resource saja. Dalam hal ini, Anda tetap perlu menghapus cluster menggunakan bmctl.

Untuk mengetahui informasi tentang flag lainnya, lihat referensi gcloud CLI.

Mereset node cluster tertentu

Anda mungkin ingin mereset node cluster tertentu jika, misalnya, cluster admin telah dihapus tetapi cluster pengguna yang dikelola oleh cluster admin tersebut tetap ada. Dalam hal ini, cluster pengguna secara keseluruhan tidak dapat dihapus karena cluster admin telah dihapus. Oleh karena itu, node cluster pengguna harus direset satu per satu.

Untuk mereset node, Anda memerlukan akun layanan dengan akses baca ke Artifact Registry. Perintah bmctl mengharapkan file kunci JSON untuk akun layanan ini sebagai argumen. Untuk mereset node cluster satu per satu, jalankan perintah berikut:

bmctl reset nodes --addresses NODE_1_IP_ADDRESS,NODE_2_IP_ADDRESS \
    --ssh-private-key-path SSH_KEY_PATH \
    --gcr-service-account-key SERVICE_ACCOUNT_KEY_PATH \
    --login-user root

Dalam perintah, ganti entri berikut dengan informasi khusus untuk lingkungan Anda:

NODE_1_IP_ADDRESS , NODE_2_IP_ADDRESS: daftar alamat IP node yang dipisahkan koma yang ingin Anda hapus.
SSH_KEY_PATH: jalur ke kunci pribadi SSH. Ini adalah kunci yang akan digunakan untuk membuat koneksi SSH dengan node selama reset.
SERVICE_ACCOUNT_KEY_PATH: jalur ke file JSON yang berisi kunci akun layanan. Kunci ini memberikan izin bmctl untuk mengambil image dari Artifact Registry. Anda dapat membuat kunci akun layanan menggunakan konsol atau gcloud CLI. Untuk mengetahui detailnya, lihat Membuat dan mengelola kunci akun layanan. Cara lain untuk membuat file kunci akun layanan adalah jika Anda menjalankan perintah create config dengan flag --create-service-accounts. Untuk mengetahui detail tentang perintah tersebut, lihat Membuat dan mengonfigurasi cluster admin dengan bmctl.

Catatan: Kunci akun layanan akan berisiko keamanan jika tidak dikelola dengan benar. Anda bertanggung jawab atas keamanan kunci pribadi dan atas operasi lainnya yang dijelaskan dalam Praktik terbaik untuk mengelola kunci akun layanan. Jika Anda tidak dapat membuat kunci akun layanan, pembuatan kunci akun layanan mungkin dinonaktifkan untuk organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Mengelola resource organisasi yang aman secara default.
Jika Anda mendapatkan kunci akun layanan dari sumber eksternal, Anda harus memvalidasinya sebelum digunakan. Untuk mengetahui informasi selengkapnya, lihat Persyaratan keamanan untuk kredensial yang bersumber dari eksternal.

Detail penghapusan cluster

Selama penghapusan, pendaftaran keanggotaan fleet cluster, pemasangan penyimpanan, dan data dari anthos-system StorageClass akan dihapus.

Untuk semua node, antarmuka tunnel yang digunakan untuk jaringan cluster akan dihapus, dan direktori berikut akan dihapus:

/etc/kubernetes
/etc/cni/net.d
/root/.kube
/var/lib/kubelet

Untuk node load balancer:

Layanan keepalived dan haproxy akan dihapus.
File konfigurasi untuk keepalived dan haproxy akan dihapus.