Para diagnosticar y resolver errores comunes de identidades de cargas de trabajo administradas en Google Kubernetes Engine (GKE), inspecciona los eventos de Pods, los grupos de identidades para cargas de trabajo, las configuraciones de emisión de certificados y los recursos de Certificate Authority Service. Estas verificaciones te ayudan a resolver problemas de implementación de Pods, emisión de certificados X.509 y actualización de la autoridad certificadora (CA).
Si el Pod de la carga de trabajo de GKE no se implementó con los certificados activados, usa el siguiente comando para verificar el estado del Pod:
kubectl describe pod POD_NAME -n POD_NAMESPACE
El resultado del comando incluye los eventos de Pod generados por el kubelet y el
gke-spiffe-controller. Revisa estos eventos para ver mensajes de error específicos, que
pueden incluir uno de los siguientes:
PermissionDenied errores
En esta sección, se describen los errores que devuelven un código de error de RPC PermissionDenied.
PRIVATE_CA_AUTHORIZATION_FAILURE
Este error es similar al siguiente:
Permission denied while issuing the certificate: failed to issue the certificate from the GKE Auth: rpc error: code = PermissionDenied desc = Permission 'privateca.caPools.get' denied on resource 'privateca.googleapis.com/projects/CA_POOL_PROJECT_NUMBER/locations/REGION/caPools/CA_POOL_ID' (or it may not exist). Ensure that the CaPool exists and you have authorized the Managed Workload Identity to request certificates from the CaPool.
El error se produjo porque al grupo de identidades para cargas de trabajo le falta el rol CA Service
Workload Certificate Requester
(roles/privateca.workloadCertificateRequester) en el grupo de AC subordinado o
porque el grupo de AC no existe.
Para resolver este error, otorga el rol al grupo:
gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \
--project=CA_POOL_PROJECT_ID \
--location=REGION \
--role=roles/privateca.workloadCertificateRequester \
--member="principal://iam.googleapis.com/projects/WIP_PROJECT_NUMBER/name/locations/global/workloadIdentityPools/TRUST_DOMAIN_NAME"
Reemplaza lo siguiente:
SUBORDINATE_CA_POOL_ID: el ID del grupo de AC subordinadoCA_POOL_PROJECT_ID: Es el ID del proyecto del grupo de AC.REGION: la región de la AC subordinadaWIP_PROJECT_NUMBER: Es el número del proyecto del grupo de identidades para cargas de trabajo.TRUST_DOMAIN_NAME: Es el nombre del dominio de confianza. Según el tipo de grupo, asigna el nombre con el siguiente formato:- Grupo administrado por Google:
PROJECT_ID.svc.id.goog - Grupo autoadministrado:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Grupo administrado por Google:
WORKLOAD_IDENTITY_NOT_FOUND, WORKLOAD_POOL_NOT_FOUND o WORKLOAD_NAMESPACE_NOT_FOUND
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = PermissionDenied desc = Permission denied on resource 'projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_NAME/... (or it may not exist).
Este error se asigna a WORKLOAD_IDENTITY_NOT_FOUND, WORKLOAD_POOL_NOT_FOUND o WORKLOAD_NAMESPACE_NOT_FOUND. Se produce cuando el grupo de identidades para cargas de trabajo,
el espacio de nombres del grupo de identidades para cargas de trabajo o el recurso de identidad administrada no existen,
o cuando están inhabilitados o borrados. Ten en cuenta que este error devuelve
PermissionDenied en lugar de NotFound para evitar que se filtre la inexistencia del recurso.
Para resolver este error, verifica la existencia y el estado de tu grupo de identidades para cargas de trabajo y sus recursos secundarios en IAM. Asegúrate de que estén configurados correctamente y no estén inhabilitados ni borrados.
FailedPrecondition errores
En esta sección, se describen los errores que devuelven un código de error de RPC FailedPrecondition,
que, por lo general, indica que falta una configuración o que es incorrecta.
WORKLOAD_IDENTITY_INVALID_CONFIGURATION
La descripción del Pod puede incluir cualquiera de los siguientes mensajes:
failed to issue the certificate from the GKE Auth: rpc error: code = FailedPrecondition desc = There are no CaPools configured for certificate issuance. Ensure you have added certificate issuance configuration to the workload identity pool 'projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/WI_POOL_NAME', which contains at least one CaPool.
o
failed to issue the certificate from the GKE Auth: rpc error: code = FailedPrecondition desc = Missing Certificate issuance configuration in the Trust Domain. Ensure you have added certificate issuance configuration to the workload identity pool 'projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/WI_POOL_NAME' which contains at least one CaPool.
Este error (WORKLOAD_IDENTITY_INVALID_CONFIGURATION) se produjo porque el
grupo de identidades para cargas de trabajo no se configuró con una configuración de emisión de certificados (CIC) o porque la CIC configurada no contiene al menos un
grupo de AC.
Para resolver este error, crea una CIC que contenga al menos un grupo de AC y úsala para actualizar el grupo de identidades para cargas de trabajo.
CERTIFICATE_AUTHORITY_NOT_FOUND
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = FailedPrecondition desc = Failed to request certificates from the CaPool... There are no enabled CAs in the CaPool. Ensure that there is at least one enabled Certificate Authority to issue a certificate.
Este error (CERTIFICATE_AUTHORITY_NOT_FOUND) indica que no se puede encontrar una autoridad certificadora para la emisión de certificados en el grupo de AC configurado por el cliente.
Para resolver este error, verifica que exista una autoridad certificadora en el grupo de AC configurado y que esté habilitada para la emisión de certificados.
CA_POOL_REGION_MISMATCH
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = FailedPrecondition desc = Unable to find a CaPool in the workload's region. Ensure you have setup a subordinate CaPool in 'WORKLOAD_REGION' and added it to the certificate issuance configuration of the Workload Identity Pool...
Este error (CA_POOL_REGION_MISMATCH) indica que no se configuró ningún grupo de AC
para la región específica de la carga de trabajo.
Para resolver este error, configura un grupo de AC adicional para la región de la carga de trabajo en el grupo de identidades para cargas de trabajo o implementa la carga de trabajo en una región que ya tenga un grupo de AC configurado.
ResourceExhausted errores
En esta sección, se describen los errores que devuelven un código de error de RPC ResourceExhausted.
PRIVATE_CA_QUOTA_EXCEEDED
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = ResourceExhausted desc = Quota exceeded for quota metric 'QUOTA_METRIC' and limit 'QUOTA_LIMIT' of service 'privateca.googleapis.com' for consumer 'project_number:PROJECT_NUMBER'.
Este error (PRIVATE_CA_QUOTA_EXCEEDED) se produce cuando configuras tu grupo de identidades para cargas de trabajo
para que use una CA personalizada y un intento de emitir un certificado
superó una cuota o un límite establecidos relacionados con CA Service.
Este error no se produce si usas la AC predeterminada administrada por Google.
QUOTA_METRICyQUOTA_LIMIT: Son la métrica y el límite de cuota específicos que se excedieron. Por ejemplo,privateca.googleapis.com/enterprise_certificate_issuanceyCertsPerEnterpriseCaPerMinute.
Para resolver este error, revisa tus cuotas y límites de CA Service en la consola de Google Cloud y solicita un aumento de cuota si es necesario.
InvalidArgument errores
En esta sección, se describen los errores que devuelven un código de error de RPC InvalidArgument.
PRIVATE_CA_KEY_ALGORITHM_MISMATCH
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = InvalidArgument desc = Public key algorithm is not permitted by the CaPool's issuance policy. Ensure that the requested keyAlgorithm 'KEY_ALGO_IN_CSR' is permitted by the CAs in the CaPool 'privateca.googleapis.com/projects/PROJECT_NAME/locations/WORKLOAD_REGION/caPools/CA_POOL_NAME'.
Este error (PRIVATE_CA_KEY_ALGORITHM_MISMATCH) indica que el algoritmo de clave
especificado en la solicitud de certificado no es compatible con las
restricciones del grupo de AC configurado. Esto solo sucede cuando configuras un algoritmo de clave personalizado en la configuración de emisión de certificados (CIC) y actualizas el grupo de identidades para cargas de trabajo.
Para resolver este error, verifica que el algoritmo configurado en la CIC del grupo de identidades para cargas de trabajo sea compatible con los algoritmos que admite la política de emisión del grupo de AC.
Unknown errores
En esta sección, se describen los errores que devuelven un código de error de RPC Unknown.
UNKNOWN_PRIVATE_CA_CLIENT_ERROR
Este error es similar al siguiente:
failed to issue the certificate from the GKE Auth: rpc error: code = Unknown desc = Failed to get certificates using the CaPool... PRIVATE_CA_ERROR_MESSAGE
Este error (UNKNOWN_PRIVATE_CA_CLIENT_ERROR) indica que se produjo un error de cliente desconocido, como un argumento no válido proporcionado a la API, cuando se llamó al Servicio de AC.
Para resolver este error, revisa el mensaje de error específico que muestra la API del Servicio de CA para identificar el argumento no válido o el problema de configuración del cliente y corregirlo.
Latencia de propagación del paquete de confianza
Cuando actualizas o rotas una CA autoadministrada, hay una latencia de propagación de aproximadamente 5 minutos antes de que las actualizaciones se apliquen en los "clústeres de GKE". Esto se debe a que gke-spiffe-controller verifica la membresía y recupera los paquetes de confianza cada cinco minutos.
Esta latencia no se produce si usas la AC administrada por Google.
Si actualizas una CA autoadministrada, espera al menos cinco minutos para que se apliquen los cambios.