Neste documento, descrevemos como fazer upgrade da autoridade certificadora raiz (AC) usada para validação de pacotes no dispositivo com isolamento físico do Google Distributed Cloud (GDC).
A validação de pacotes do GDC usa uma autoridade certificadora raiz (CA) para validar certificados de chave de lançamento. Faça upgrade dessa CA raiz se um aviso de lançamento exigir ou se você receber uma mensagem de aviso durante um upgrade do sistema.
Antes de começar
Solicite as permissões necessárias ao administrador do IAM. Aplique o acesso com privilégio mínimo solicitando apenas os papéis necessários para suas tarefas específicas.
Acesso necessário
Para fazer upgrade do certificado de validação de pacote, use uma das
seguintes opções para inspecionar e atualizar o objeto ConfigMap
package-validation-root-certs no cluster de infraestrutura da organização (root-infra):
- Use o arquivo
root-infrakubeconfigdas credenciais de emergência que você salvou durante a configuração do dispositivo. - Peça ao administrador de segurança para seguir o runbook
IAM-R0013
para criar recursos temporários
RoleeRoleBindingpara você no namespaceharbor-system. O recursoRoleprecisa conceder as permissõesget,updateepatchem objetosConfigMapcom o camporesourceNamesdefinido como["package-validation-root-certs"].
Verificar se o upgrade do certificado é obrigatório
Verifique se é necessário fazer upgrade do certificado de validação de pacote antes de realizar a operação. Para isso, compare o ConfigMap ativo no cluster com o certificado raiz de preparo mais recente no pacote de upgrade:
Defina a variável de ambiente
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILESubstitua
PATH_TO_KUBECONFIG_FILEpelo caminho para o arquivokubeconfigque você recebeu para o cluster de infraestrutura da organização (root-infra).Determine se um upgrade é necessário comparando a âncora de confiança atual com a mais recente. Os dados de
ConfigMapemharbor-system/package-validation-root-certssão comparados com a âncora de confiança local:$ 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!
Fazer upgrade do certificado
Se um upgrade for necessário, atualize o objeto ConfigMap localizado em
harbor-system/package-validation-root-certs no cluster de infraestrutura da organização
(root-infra).
Defina a variável de ambiente
KUBECONFIG:$ KUBECONFIG=PATH_TO_KUBECONFIG_FILESubstitua
PATH_TO_KUBECONFIG_FILEpelo caminho para o arquivokubeconfigque você recebeu para o cluster de infraestrutura da organização (root-infra).Crie e atribua valores às seguintes variáveis:
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-systemSubstitua
USER_NAMEpelo nome de usuário de E/S.Crie a pasta de destino que vai conter os arquivos de saída do processo de upgrade do certificado:
mkdir -p "${TARGET_FOLDER}"Consiga a âncora de confiança atual e armazene-a em um arquivo temporário local:
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}"Gere o arquivo de âncora de confiança atualizado:
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}") EOFVerifique se a âncora de confiança foi atualizada corretamente:
A âncora de confiança precisa conter o certificado atual e o mais recente.
$ 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-systemAplique a nova configuração com
kubectl:kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}Verifique se o ca.crt recém-aplicado está presente no
ConfigMap:kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
Isso cuida do upgrade de um novo certificado no package-validation-root-cert.