במאמר הזה מוסבר איך לשדרג את רשות אישורי הבסיס (CA) שמשמשת לאימות חבילות במכשיר Google Distributed Cloud (GDC) עם air gap.
אימות החבילה של GDC משתמש ברשות אישורי בסיס (CA) כדי לאמת אישורים של מפתחות הפצה. צריך לשדרג את ה-CA הבסיסי הזה אם יש דרישה לכך בהודעת השדרוג, או אם מופיעה הודעת אזהרה במהלך שדרוג המערכת.
לפני שמתחילים
מבקשים את ההרשאות הנדרשות מהאדמין ב-IAM. כדי לאכוף את העיקרון של הרשאות מינימליות, בקשו רק את התפקידים שנדרשים למשימות הספציפיות שלכם.
הגישה הנדרשת
כדי לשדרג את אישור האימות של החבילה, צריך להשתמש באחת מהאפשרויות הבאות כדי לבדוק ולעדכן את האובייקט package-validation-root-certs ConfigMap באשכול התשתית של הארגון (root-infra):
- משתמשים בקובץ
root-infrakubeconfigמתוך פרטי הכניסה למקרה חירום ששמרתם במהלך הגדרת הציוד. - מבקשים מהאדמין לענייני אבטחה לפעול לפי ההוראות במדריך ההפעלה IAM-R0013 כדי ליצור בשבילכם משאבים זמניים של
Roleו-RoleBindingבמרחב השמותharbor-system. המשאבRoleצריך לתת הרשאות מסוגget,updateו-patchלאובייקטים מסוגConfigMap, כשהשדהresourceNamesמוגדר לערך["package-validation-root-certs"].
צריך לאמת את שדרוג האישור
לפני שמבצעים את הפעולה, צריך לוודא שנדרש שדרוג של אישור אימות החבילה. לשם כך, משווים בין ה-ConfigMap הפעיל באשכול לבין אישור הבסיס האחרון של ה-staging בחבילת השדרוג:
מגדירים את משתנה הסביבה
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEמחליפים את
PATH_TO_KUBECONFIG_FILEבנתיב לקובץkubeconfigשקיבלתם בשביל אשכול התשתית של הארגון (root-infra).כדי לקבוע אם נדרש שדרוג, משווים בין ישות העוגן האמינה הנוכחית לבין ישות העוגן האמינה העדכנית. הנתונים של
ConfigMapב-harbor-system/package-validation-root-certsמושווים לישות העוגן האמינה המקומית:$ 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!
שדרוג האישור
אם נדרש שדרוג, צריך לעדכן את האובייקט ConfigMap שנמצא ב-harbor-system/package-validation-root-certs באשכול התשתית של הארגון (root-infra).
מגדירים את משתנה הסביבה
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEמחליפים את
PATH_TO_KUBECONFIG_FILEבנתיב לקובץkubeconfigשקיבלתם בשביל אשכול התשתית של הארגון (root-infra).יוצרים את המשתנים הבאים ומקצים להם ערכים:
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-systemמחליפים את
USER_NAMEבשם המשתמש של ה-IO.יוצרים את תיקיית היעד שתכיל את קובצי הפלט מתהליך שדרוג האישור:
mkdir -p "${TARGET_FOLDER}"מורידים את ישות העוגן האמינה הנוכחית ושומרים אותה בקובץ זמני מקומי:
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}"יוצרים את קובץ ישות העוגן האמינה המעודכן:
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}") EOFמוודאים שישות העוגן האמינה עודכנה בצורה תקינה:
ישות העוגן האמינה צריכה להכיל גם את האישור הנוכחי וגם את האישור האחרון של ישות העוגן האמינה.
$ 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-systemמחילים את ההגדרות החדשות באמצעות
kubectl:kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}מוודאים שהקובץ ca.crt החדש נמצא ב-
ConfigMap:kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
כך מתבצע שדרוג של אישור חדש ב-package-validation-root-cert.