Mengupgrade sertifikat validasi paket

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-infra kubeconfig dari kredensial darurat yang Anda simpan selama penyiapan peralatan.
  • Minta Security Admin Anda untuk mengikuti runbook IAM-R0013 guna membuat resource Role dan RoleBinding sementara untuk Anda di namespace harbor-system. Resource Role harus memberikan izin get, update, dan patch pada objek ConfigMap dengan kolom resourceNames yang 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:

  1. Tetapkan variabel lingkungan KUBECONFIG:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    Ganti PATH_TO_KUBECONFIG_FILE dengan jalur ke file kubeconfig yang Anda dapatkan untuk cluster infrastruktur organisasi (root-infra).

  2. Tentukan apakah upgrade diperlukan dengan membandingkan trust anchor saat ini dengan trust anchor terbaru. Data ConfigMap di harbor-system/package-validation-root-certs dibandingkan 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).

  1. Tetapkan variabel lingkungan KUBECONFIG:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    Ganti PATH_TO_KUBECONFIG_FILE dengan jalur ke file kubeconfig yang Anda dapatkan untuk cluster infrastruktur organisasi (root-infra).

  2. 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-system
    

    Ganti USER_NAME dengan nama pengguna IO.

  3. Buat folder target yang akan berisi file output dari proses upgrade sertifikat:

    mkdir -p "${TARGET_FOLDER}"
    
  4. 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}"
    
  5. 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}")
    EOF
    
  6. Pastikan 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-system
    
  7. Terapkan konfigurasi baru dengan kubectl:

      kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}
    
  8. 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.