Dokumen ini menjelaskan cara mengupgrade root certificate authority (CA) yang digunakan untuk validasi paket di peralatan Google Distributed Cloud (GDC) dengan air gap.
Validasi paket GDC menggunakan root certificate authority (CA) untuk memvalidasi sertifikat kunci rilis. Anda harus mengupgrade root CA ini jika pemberitahuan rilis mengharuskannya, atau jika Anda melihat pesan peringatan selama upgrade sistem.
Sebelum memulai
Minta izin yang diperlukan dari administrator IAM Anda. Terapkan akses dengan hak istimewa terendah dengan hanya meminta peran yang diperlukan untuk tugas spesifik Anda.
Akses yang diperlukan
Untuk mengupgrade sertifikat validasi paket, Anda harus menggunakan salah satu
opsi berikut untuk memeriksa dan mengupdate objek package-validation-root-certs
ConfigMap di cluster infrastruktur org (root-infra):
- Gunakan file
root-infrakubeconfigdari kredensial darurat yang Anda simpan selama penyiapan peralatan. - Minta Security Admin Anda untuk mengikuti runbook
IAM-R0013
guna membuat resource
RoledanRoleBindingsementara untuk Anda di namespaceharbor-system. ResourceRoleharus memberikan izinget,update, danpatchpada objekConfigMapdengan kolomresourceNamesyang ditetapkan ke["package-validation-root-certs"].
Verifikasi bahwa upgrade sertifikat diperlukan
Pastikan upgrade sertifikat validasi paket diperlukan sebelum melakukan operasi, dengan membandingkan ConfigMap aktif di cluster Anda dengan root certificate staging terbaru dalam paket upgrade:
Tetapkan variabel lingkungan
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEGanti
PATH_TO_KUBECONFIG_FILEdengan jalur ke filekubeconfigyang Anda dapatkan untuk cluster infrastruktur organisasi (root-infra).Tentukan apakah upgrade diperlukan dengan membandingkan trust anchor saat ini dengan trust anchor terbaru. Data
ConfigMapdiharbor-system/package-validation-root-certsdibandingkan dengan trust anchor lokal:$ CURRENT_TRUST_ANCHOR=$(kubectl --kubeconfig=$KUBECONFIG get cm package-validation-root-certs -n harbor-system -o jsonpath='{.data.ca\.crt}') $ LATEST_TRUST_ANCHOR=$(cat /root/release/staging_root_ca_certificate.crt) $ diff <( echo "$CURRENT_TRUST_ANCHOR" ) <( echo "$LATEST_TRUST_ANCHOR" ) && echo trust anchors are same || echo trust anchors are different, upgrade required!
Mengupgrade sertifikat
Jika upgrade diperlukan, update objek ConfigMap yang terletak di
harbor-system/package-validation-root-certs di cluster infrastruktur organisasi
(root-infra).
Tetapkan variabel lingkungan
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEGanti
PATH_TO_KUBECONFIG_FILEdengan jalur ke filekubeconfigyang Anda dapatkan untuk cluster infrastruktur organisasi (root-infra).Buat dan tetapkan nilai ke variabel berikut:
USERNAME=USER_NAME #IO TARGET_FOLDER=/tmp/${USERNAME} OUTPUT="${TARGET_FOLDER}/package-validation-root-certs.yaml" LATEST_TRUST_ANCHOR_CA_FILE=/root/release/staging_root_ca_certificate.crt CONFIGMAP_NAME=package-validation-root-certs NAMESPACE=harbor-systemGanti
USER_NAMEdengan nama pengguna IO.Buat folder target yang akan berisi file output dari proses upgrade sertifikat:
mkdir -p "${TARGET_FOLDER}"Dapatkan trust anchor saat ini dan simpan di file sementara lokal:
CURRENT_TRUST_ANCHOR=$(kubectl --kubeconfig=$KUBECONFIG get configmap "${CONFIGMAP_NAME}" -n "${NAMESPACE}" -o jsonpath="{.data.ca\.crt}" ) CURRENT_TRUST_ANCHOR_CA_FILE=$(mktemp) echo "$CURRENT_TRUST_ANCHOR" > "${CURRENT_TRUST_ANCHOR_CA_FILE}"Buat file trust anchor yang telah diperbarui:
cat <<EOF > "${OUTPUT}" apiVersion: v1 kind: ConfigMap metadata: name: ${CONFIGMAP_NAME} namespace: ${NAMESPACE} data: ca.crt: | $(sed 's/^/ /' "${LATEST_TRUST_ANCHOR_CA_FILE}") $(sed 's/^/ /' "${CURRENT_TRUST_ANCHOR_CA_FILE}") EOFPastikan trust anchor telah diupdate dengan benar:
Trust anchor harus berisi sertifikat trust anchor saat ini dan terbaru.
$ cat "${OUTPUT}" apiVersion: v1 data: ca.crt: | -----BEGIN CERTIFICATE----- (certificate content) -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- (certificate content) -----END CERTIFICATE----- (other certificate) kind: ConfigMap metadata: name: package-validation-root-certs namespace: harbor-systemTerapkan konfigurasi baru dengan
kubectl:kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}Pastikan ca.crt yang baru diterapkan ada dalam
ConfigMap:kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
Tindakan ini akan mengupgrade sertifikat baru di package-validation-root-cert.