In diesem Dokument wird beschrieben, wie Sie die Root-Zertifizierungsstelle (CA) aktualisieren, die für die Paketvalidierung in der Google Distributed Cloud (GDC) Air-Gapped-Appliance verwendet wird.
Bei der GDC-Paketvalidierung wird eine Root-Zertifizierungsstelle verwendet, um Release-Schlüsselzertifikate zu validieren. Sie müssen diese Stammzertifizierungsstelle aktualisieren, wenn dies in einer Release-Mitteilung gefordert wird oder wenn Sie während eines Systemupgrades eine Warnmeldung sehen.
Hinweis
Fordern Sie die erforderlichen Berechtigungen von Ihrem IAM-Administrator an. Erzwingen Sie den Zugriff mit den geringsten Berechtigungen, indem Sie nur die Rollen anfordern, die für Ihre spezifischen Aufgaben erforderlich sind.
Erforderlicher Zugriff
Wenn Sie das Zertifikat für die Paketvalidierung aktualisieren möchten, müssen Sie eine der folgenden Optionen verwenden, um das package-validation-root-certs-ConfigMap-Objekt im Organisationsinfrastrukturcluster (root-infra) zu prüfen und zu aktualisieren:
- Verwenden Sie die Datei
root-infrakubeconfigaus den Notfall-Anmeldedaten, die Sie während der Einrichtung der Appliance gespeichert haben. - Bitten Sie Ihren Security Admin, dem Runbook IAM-R0013 zu folgen, um temporäre
Role- undRoleBinding-Ressourcen für Sie im Namespaceharbor-systemzu erstellen. Die RessourceRolemuss die Berechtigungenget,updateundpatchfürConfigMap-Objekte gewähren, wobei das FeldresourceNamesauf["package-validation-root-certs"]festgelegt ist.
Prüfen, ob ein Zertifikatsupgrade erforderlich ist
Prüfen Sie vor dem Ausführen des Vorgangs, ob ein Upgrade des Zertifikats für die Paketvalidierung erforderlich ist. Vergleichen Sie dazu die aktive ConfigMap in Ihrem Cluster mit dem neuesten Staging-Root-Zertifikat im Upgrade-Bundle:
Legen Sie die Umgebungsvariable
KUBECONFIGfest:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEErsetzen Sie
PATH_TO_KUBECONFIG_FILEdurch den Pfad zurkubeconfig-Datei, die Sie für den Organisationsinfrastrukturcluster (root-infra) erhalten haben.Prüfen Sie, ob ein Upgrade erforderlich ist, indem Sie den aktuellen Trust-Anchor mit dem neuesten Trust-Anchor vergleichen. Die
ConfigMap-Daten unterharbor-system/package-validation-root-certswerden mit dem lokalen Trust-Anchor verglichen:$ 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!
Zertifikat upgraden
Wenn ein Upgrade erforderlich ist, aktualisieren Sie das ConfigMap-Objekt unter harbor-system/package-validation-root-certs im Cluster der Organisationsinfrastruktur (root-infra).
Legen Sie die Umgebungsvariable
KUBECONFIGfest:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEErsetzen Sie
PATH_TO_KUBECONFIG_FILEdurch den Pfad zurkubeconfig-Datei, die Sie für den Organisationsinfrastrukturcluster (root-infra) erhalten haben.Erstellen Sie die folgenden Variablen und weisen Sie ihnen Werte zu:
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-systemErsetzen Sie
USER_NAMEdurch den AA-Nutzernamen.Erstellen Sie den Zielordner, der die Ausgabedateien des Zertifikats-Upgrades enthalten soll:
mkdir -p "${TARGET_FOLDER}"Rufen Sie den aktuellen Trust-Anchor ab und speichern Sie ihn in einer lokalen temporären Datei:
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}"Generieren Sie die aktualisierte Trust-Anchor-Datei:
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}") EOFPrüfen Sie, ob der Trust-Anchor korrekt aktualisiert wurde:
Der Trust-Anchor muss sowohl das aktuelle als auch das neueste Trust-Anchor-Zertifikat enthalten.
$ 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-systemWenden Sie die neue Konfiguration mit
kubectlan:kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}Prüfen Sie, ob die neu angewendete ca.crt in der
ConfigMapvorhanden ist:kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
Dadurch wird ein neues Zertifikat in der package-validation-root-cert aktualisiert.