Halaman ini diterjemahkan oleh Cloud Translation API.

Menjalankan alat pra-upgrade

Dokumen ini menunjukkan cara menjalankan alat mandiri sebagai persiapan untuk upgrade. Sebelum mengupgrade cluster admin atau pengguna yang berada di versi 1.9 dan versi yang lebih baru Google Distributed Cloud, sebaiknya jalankan alat pra-upgrade.

Untuk menjalankan alat, gunakan skrip bash dalam dokumen ini yang menggunakan Secure Hash Algorithms (SHA) yang dikodekan secara permanen. Untuk setiap rilis alat, dokumen ini akan diperbarui dengan SHA baru. Skrip ini membuat Job Kubernetes untuk menjalankan pemeriksaan awal versi tertentu, bergantung pada versi yang akan Anda upgrade.

Pemeriksaan sebelum upgrade

Alat ini memeriksa hal-hal berikut sebelum Anda mengupgrade cluster pengguna:

Kategori	Deskripsi
Kesehatan Cluster	Memvalidasi PDB di semua namespace cluster admin. Memvalidasi PDB di semua namespace cluster pengguna. Memvalidasi bahwa upgrade sebelumnya pada cluster admin telah berhasil diselesaikan.
Konfigurasi	Merekomendasikan versi patch yang akan diupgrade. Memeriksa apakah kunci SA akses komponen dihapus seperti yang dijelaskan dalam masalah umum terkait. Jika Anda mengupgrade ke 1.10, peringatan akan muncul jika Anda perlu menerapkan solusi sementara dalam masalah umum ini.

Kategori

Deskripsi

Kesehatan Cluster

Memvalidasi PDB di semua namespace cluster admin.

Memvalidasi PDB di semua namespace cluster pengguna.

Memvalidasi bahwa upgrade sebelumnya pada cluster admin telah berhasil diselesaikan.

Konfigurasi

Merekomendasikan versi patch yang akan diupgrade.

Memeriksa apakah kunci SA akses komponen dihapus seperti yang dijelaskan dalam masalah umum terkait.

Jika Anda mengupgrade ke 1.10, peringatan akan muncul jika Anda perlu menerapkan solusi sementara dalam masalah umum ini.

Alat ini memeriksa hal berikut sebelum Anda mengupgrade cluster admin:

Kategori	Deskripsi
Kesehatan Cluster	Memvalidasi `PodDisruptionBudgets` (PDB) di semua namespace cluster admin.
Konfigurasi	Merekomendasikan versi patch yang akan diupgrade. Merekomendasikan pencadangan cluster admin . Memberi peringatan jika Anda mungkin terpengaruh oleh masalah yang diketahui ini.

Bersiap untuk menjalankan alat

Upgrade workstation admin Anda jika Anda belum melakukannya.
Jalankan gkectl prepare untuk mengimpor image OS ke vSphere jika Anda belum melakukannya:
```
gkectl prepare \
    --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG
```
Ganti kode berikut:
- TARGET_VERSION: Versi patch Google Distributed Cloud yang ingin Anda upgrade. Format nomor versi harus berupa versi patch lengkap, seperti 1.13.10-gke.42.
- ADMIN_CLUSTER_KUBECONFIG: Jalur ke kubeconfig cluster admin.
Catatan: Anda tidak perlu menjalankan ulang gkectl prepare saat siap mengupgrade cluster.

Jika Anda menggunakan registry pribadi, download image container pra-penerbangan dengan ringkasan docker yang diberikan dan upload image ke registry pribadi. Jika Anda tidak menggunakan registry pribadi, lewati ke langkah berikutnya.

export SRC_IMAGE=gcr.io/gke-on-prem-release/preflight@sha256:9704315c6637750a014d0079ca04a8f97d0ca3735e175020377107c3181f6234
export DST_IMAGE=REGISTRY_ADDRESS/preflight:$(date +%Y-%m%d-%H%M%S)
docker pull $SRC_IMAGE
docker tag $SRC_IMAGE $DST_IMAGE
docker push $DST_IMAGE

Ganti REGISTRY_ADDRESS dengan alamat registry pribadi.

Dalam skrip bash berikut, tetapkan nilai untuk placeholder ini:

ADMIN_CLUSTER_KUBECONFIG: Jalur ke kubeconfig cluster admin.
REGISTRY_ADDRESS: Jika cluster admin menggunakan registry pribadi, ini adalah alamat registry pribadi yang Anda tentukan pada langkah sebelumnya. Jika Anda tidak menggunakan registry pribadi, tentukan registry publik: gcr.io/gke-on-prem-release

#!/bin/bash
UPGRADE_TARGET_VERSION=${1}
CLUSTER_NAME=${2}
ADMIN_KUBECONFIG=ADMIN_CLUSTER_KUBECONFIG
REGISTRY_ADDRESS=REGISTRY_ADDRESS
pre_upgrade_namespace=kube-system
if [[ -z "$CLUSTER_NAME" ]]
then
  echo "Running the pre-ugprade tool before admin cluster upgrade"
else
  echo "Running the pre-ugprade tool before user cluster upgrade"
  pre_upgrade_namespace=$CLUSTER_NAME-gke-onprem-mgmt
fi
kubectl apply --kubeconfig ${ADMIN_KUBECONFIG} -f - <<EOF
apiVersion: v1
kind: ServiceAccount
metadata:
  name: pre-upgrade-job
  namespace: $pre_upgrade_namespace
EOF
kubectl apply --kubeconfig ${ADMIN_KUBECONFIG} -f - <<EOF
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  creationTimestamp: null
  name: pre-upgrade-job-rolebinding-in-$pre_upgrade_namespace
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: onprem-user-cluster-controller-role
subjects:
  - kind: ServiceAccount
    name: pre-upgrade-job
    namespace: $pre_upgrade_namespace
EOF
kubectl apply --kubeconfig ${ADMIN_KUBECONFIG} -f - <<EOF
apiVersion: batch/v1
kind: Job
metadata:
  name: pre-upgrade-$(date +%Y-%m%d-%H%M%S)
  namespace: $pre_upgrade_namespace
  labels:
    onprem.cluster.gke.io/job-usage: preflight
spec:
  ttlSecondsAfterFinished: 2592000
  backoffLimit: 2
  template:
    metadata:
      labels:
        onprem.cluster.gke.io/pod-usage: preflight
    spec:
      containers:
      - name: preflight
        image: $REGISTRY_ADDRESS/preflight@sha256:9704315c6637750a014d0079ca04a8f97d0ca3735e175020377107c3181f6234
        imagePullPolicy: Always
        command:
        - /preflight
        - --upgrade-target-version
        - "$UPGRADE_TARGET_VERSION"
        - --cluster-name
        - "$CLUSTER_NAME"
        - --scenario
        - pre-upgrade
      restartPolicy: Never
      serviceAccountName: pre-upgrade-job
      imagePullSecrets:
      - name: private-registry-creds
EOF

Simpan skrip bash di atas ke file bernama pre-upgrade.sh dan buat file tersebut dapat dieksekusi:
```
chmod +x pre-upgrade.sh
```

Jalankan skrip:

Argumen yang Anda berikan saat menjalankan skrip bergantung pada apakah Anda mengupgrade cluster pengguna atau cluster admin:
- Sebelum mengupgrade cluster admin, jalankan skrip sebagai berikut:
```
./pre-upgrade.sh TARGET_VERSION
```
- Sebelum mengupgrade cluster pengguna:
```
./pre-upgrade.sh TARGET_VERSION USER_CLUSTER_NAME
```
Ganti USER_CLUSTER_NAME dengan nama cluster pengguna yang akan Anda upgrade.

Outputnya mirip dengan hal berikut ini:
```
job.batch/pre-upgrade-2023-0822-213551 created
```
Jalankan perintah berikut pada Pod yang dikontrol oleh tugas untuk mendapatkan daftar hasil validasi.
```
kubectl logs -n JOB_NAMESPACE jobs/JOB_NAME \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG
```
Ganti kode berikut:
- JOB_NAME: Ini adalah nama tugas yang dihasilkan skrip dari langkah sebelumnya.
- JOB_NAMESPACE: Nilai yang Anda tetapkan bergantung pada apakah Anda mengupgrade cluster admin atau pengguna. Jika Anda mengupgrade cluster admin, tentukan kube-system. Jika Anda mengupgrade cluster pengguna, tentukan USER_CLUSTER_NAME-gke-onprem-mgmt.
Tunggu beberapa menit hingga tugas selesai atau mencapai batas mundur dan gagal. Dalam hasil, tinjau Reason untuk setiap pemeriksaan dengan status Warning, Unknown, atau Failure untuk melihat apakah Anda dapat menyelesaikan masalah tersebut.

Penting: Sebaiknya selesaikan semua masalah dengan status Failure karena masalah ini akan menyebabkan upgrade gagal. Hubungi dukungan Google jika diperlukan.

Sebelum mengupgrade cluster, jalankan perintah berikut untuk menghapus Job:

kubectl delete jobs JOB_NAME -n JOB_NAMESPACE \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG