このドキュメントでは、Google Distributed Cloud(GDC)エアギャップ アプライアンスでパッケージ検証に使用されるルート認証局(CA)をアップグレードする方法について説明します。
GDC パッケージの検証では、ルート認証局(CA)を使用してリリースキー証明書を検証します。リリース通知で必要な場合、またはシステム アップグレード中に警告メッセージが表示された場合は、このルート CA をアップグレードする必要があります。
始める前に
IAM 管理者に必要な権限をリクエストします。特定のタスクに必要なロールのみをリクエストして、最小権限でのアクセスを適用します。
必要なアクセス権
パッケージ検証証明書をアップグレードするには、次のいずれかのオプションを使用して、組織インフラストラクチャ クラスタ(root-infra)の package-validation-root-certs ConfigMap オブジェクトを検査して更新する必要があります。
- アプライアンスの設定時に保存した緊急認証情報の
root-infrakubeconfigファイルを使用します。 - セキュリティ管理者に、IAM-R0013 ランブックに沿って、
harbor-system名前空間に一時的なRoleリソースとRoleBindingリソースを作成するよう依頼します。Roleリソースは、resourceNamesフィールドが["package-validation-root-certs"]に設定されたConfigMapオブジェクトに対するget、update、patch権限を付与する必要があります。
証明書のアップグレードが必要であることを確認する
オペレーションを実行する前に、クラスタ内のアクティブな ConfigMap とアップグレード バンドルの最新のステージング ルート証明書を比較して、パッケージ検証証明書のアップグレードが必要かどうかを確認します。
KUBECONFIG環境変数を設定します。$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEPATH_TO_KUBECONFIG_FILEは、組織インフラストラクチャ クラスタ(root-infra)用に取得したkubeconfigファイルのパスに置き換えます。現在のトラスト アンカーと最新のトラスト アンカーを比較して、アップグレードが必要かどうかを判断します。
harbor-system/package-validation-root-certsのConfigMapデータがローカル トラスト アンカーと比較されます。$ 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!
証明書をアップグレードする
アップグレードが必要な場合は、組織インフラストラクチャ クラスタ(root-infra)の harbor-system/package-validation-root-certs にある ConfigMap オブジェクトを更新します。
KUBECONFIG環境変数を設定します。$ KUBECONFIG=PATH_TO_KUBECONFIG_FILEPATH_TO_KUBECONFIG_FILEは、組織インフラストラクチャ クラスタ(root-infra)用に取得したkubeconfigファイルのパスに置き換えます。次の変数を作成して値を割り当てます。
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-systemUSER_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-systemkubectlを使用して新しい構成を適用します。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 で新しい証明書がアップグレードされます。