שדרוג אישור האימות של החבילה

במאמר הזה מוסבר איך לשדרג את רשות אישורי הבסיס (CA) שמשמשת לאימות חבילות במכשיר Google Distributed Cloud (GDC)‎ עם air gap.

אימות החבילה של GDC משתמש ברשות אישורי בסיס (CA) כדי לאמת אישורים של מפתחות הפצה. צריך לשדרג את ה-CA הבסיסי הזה אם יש דרישה לכך בהודעת השדרוג, או אם מופיעה הודעת אזהרה במהלך שדרוג המערכת.

לפני שמתחילים

מבקשים את ההרשאות הנדרשות מהאדמין ב-IAM. כדי לאכוף את העיקרון של הרשאות מינימליות, בקשו רק את התפקידים שנדרשים למשימות הספציפיות שלכם.

הגישה הנדרשת

כדי לשדרג את אישור האימות של החבילה, צריך להשתמש באחת מהאפשרויות הבאות כדי לבדוק ולעדכן את האובייקט package-validation-root-certs ConfigMap באשכול התשתית של הארגון (root-infra):

  • משתמשים בקובץ root-infra kubeconfig מתוך פרטי הכניסה למקרה חירום ששמרתם במהלך הגדרת הציוד.
  • מבקשים מהאדמין לענייני אבטחה לפעול לפי ההוראות במדריך ההפעלה IAM-R0013 כדי ליצור בשבילכם משאבים זמניים של Role ו-RoleBinding במרחב השמות harbor-system. המשאב Role צריך לתת הרשאות מסוג get,‏ update ו-patch לאובייקטים מסוג ConfigMap, כשהשדה resourceNames מוגדר לערך ["package-validation-root-certs"].

צריך לאמת את שדרוג האישור

לפני שמבצעים את הפעולה, צריך לוודא שנדרש שדרוג של אישור אימות החבילה. לשם כך, משווים בין ה-ConfigMap הפעיל באשכול לבין אישור הבסיס האחרון של ה-staging בחבילת השדרוג:

  1. מגדירים את משתנה הסביבה KUBECONFIG:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    מחליפים את PATH_TO_KUBECONFIG_FILE בנתיב לקובץ kubeconfig שקיבלתם בשביל אשכול התשתית של הארגון (root-infra).

  2. כדי לקבוע אם נדרש שדרוג, משווים בין ישות העוגן האמינה הנוכחית לבין ישות העוגן האמינה העדכנית. הנתונים של 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).

  1. מגדירים את משתנה הסביבה KUBECONFIG:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    מחליפים את PATH_TO_KUBECONFIG_FILE בנתיב לקובץ kubeconfig שקיבלתם בשביל אשכול התשתית של הארגון (root-infra).

  2. יוצרים את המשתנים הבאים ומקצים להם ערכים:

    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.

  3. יוצרים את תיקיית היעד שתכיל את קובצי הפלט מתהליך שדרוג האישור:

    mkdir -p "${TARGET_FOLDER}"
    
  4. מורידים את ישות העוגן האמינה הנוכחית ושומרים אותה בקובץ זמני מקומי:

    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}"
    
  5. יוצרים את קובץ ישות העוגן האמינה המעודכן:

    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
    
  6. מוודאים שישות העוגן האמינה עודכנה בצורה תקינה:

    ישות העוגן האמינה צריכה להכיל גם את האישור הנוכחי וגם את האישור האחרון של ישות העוגן האמינה.

    $ 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
    
  7. מחילים את ההגדרות החדשות באמצעות kubectl:

      kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}
    
  8. מוודאים שהקובץ ca.crt החדש נמצא ב-ConfigMap:

      kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
    

כך מתבצע שדרוג של אישור חדש ב-package-validation-root-cert.