En esta página, se enumeran los problemas conocidos de las versiones compatibles del Sincronizador de configuración.
Muchos de los problemas que se enumeran aquí se corrigieron. La columna Versión corregida indica la versión en la que se introdujo la corrección. Para recibir esta corrección, actualiza a la versión que se indica o a una posterior.
Si formas parte del Google Developer Program, guarda esta página para recibir notificaciones cuando se publique una nota de la versión relacionada con ella. Para obtener más información, consulta Páginas guardadas.
Para filtrar los problemas conocidos por una versión del producto o una categoría de problema, selecciona los filtros en los siguientes menús desplegables.
Selecciona tu versión del Sincronizador de configuración:
Selecciona la categoría del problema:
O bien, filtra los problemas conocidos:
| Categoría | Versión identificada | Versión corregida | Problema y solución |
|---|---|---|---|
| Estado de los componentes | 1.24.0 |
Los pods del Sincronizador de configuración se detienen durante la actualización a la versión 1.24.0 en clústeres migrados a HubDespués de actualizar al Sincronizador de configuración 1.24.0, es posible que los campos que se quitaron (como Este problema solo afecta a los clústeres en los que el Sincronizador de configuración se instaló de forma manual con kubectl y, luego, se cambió a la administración de Hub. Esta falla se produce porque el proceso de migración controla la administración de campos de manera diferente a una instalación nueva. En el caso de los clústeres instalados de forma manual o los clústeres que instaló Hub inicialmente, los campos se quitan según lo previsto. Solución: Para resolver este problema, sigue las instrucciones para desinstalar el Sincronizador de configuración y, luego, volver a instalarlo a través de Hub. |
|
| Métricas | 1.5.0 | 1.21.0 |
Se corrigió: Métricas informadas para paquetes borrados
Si borras un objeto
ResourceGroup solo se borra automáticamente si
se habilitó la propagación de eliminación
antes de borrar el objeto RootSync o
RepoSync.
Solución: Borra el objeto
Reemplaza |
| Estado de los componentes | 1.15.0 |
Conciliador no programableLos conciliadores del Sincronizador de configuración requieren diferentes cantidades de recursos, dependiendo de la configuración de RootSync o RepoSync. Algunas configuraciones requieren más recursos que otras. Si un conciliador no es programable, es posible que se deba a que solicita más recursos de los que están disponibles en tus nodos. Si usas clústeres de GKE en modo estándar, las solicitudes de recursos del conciliador se establecen en un valor muy bajo. Esta configuración se eligió en un intento de permitir la programación, incluso si esto generara limitaciones y un rendimiento lento, de modo que el Sincronizador de configuración funcione en clústeres y nodos pequeños. Sin embargo, en los clústeres de GKE Autopilot, las solicitudes del conciliador se establecen en un valor más alto para representar de manera más realista el uso durante la sincronización. Solución: GKE Autopilot o Standard con el aprovisionamiento automático de nodos habilitado deberían poder ver cuántos recursos se solicitan y crear nodos del tamaño adecuado para permitir la programación. Sin embargo, si configuras de forma manual los nodos o los tamaños de las instancias de nodos, es posible que debas ajustar esos parámetros para satisfacer los requisitos de recursos del pod del conciliador. |
|
| Métricas | 1.15.0 |
No se pudo realizar la exportación. Permiso denegadoDe forma predeterminada, cuando el administrador del conciliador detecta las credenciales predeterminadas de la aplicación, el otel-collector se configura para exportar métricas a Prometheus, Cloud Monitoring y Monarch. Solución:
|
|
| Métricas | 1.15.0 |
otel-collector falla con una configuración personalizadaSi intentas modificar o borrar uno de los ConfigMaps predeterminados,
Solución: Para personalizar la configuración de exportación de métricas, crea un ConfigMap llamado
|
|
| Corrección |
El Sincronizador de configuración se enfrenta a sí mismoEs posible que el Sincronizador de configuración parezca estar en una
pelea de controladores.
consigo mismo. Esto ocurre si configuras el valor predeterminado para un
campo opcional de un recurso en el repositorio de Git. Por ejemplo,
configurar Solución: Quita el campo de la declaración de recursos. |
||
| Corrección |
El Sincronizador de configuración se enfrenta a los recursos de Config ConnectorEs posible que el Sincronizador de configuración parezca estar
enfrentando
a Config Connector por un recurso, por ejemplo, un
StorageBucket.
Este problema ocurre si no estableces el valor de un campo opcional de un recurso
Solución:
Para evitar este problema, agrega el campo |
||
| Fuente de información | 1.20.0 | 1.21.3 |
Los bucles de falla del contenedor
|
| Sincronizando | 1.7.0 | 1.21.0 |
Se corrigió: No se respeta la anotación de mutación de ignorarUn error en el conciliador del Sincronizador de configuración hace que aplique cambios de las configuraciones declaradas, incluso cuando está presente la anotación Solución: Puedes dejar de administrar el objeto administrado si agregas la |
| Sincronizando | 1.15.0 |
Gran cantidad de solicitudes
|
|
| Sincronizando | 1.7.0 | 1.21.0 |
Se corrigió: No se pudo escribir el inventario actualizado en el clústerSi el Sincronizador de configuración no puede actualizar el estado de un objeto ResourceGroup, es posible que encuentres un error intermitente en los registros del conciliador que sea similar al siguiente:
KNV2009: task failed (action: "Inventory", name: "inventory-set-0"): failed to write updated inventory to cluster: Operation cannot be fulfilled on resourcegroups.kpt.dev "root-sync": the object has been modified; please apply your changes to the latest version and try again
Este error se debe a una condición de carrera entre el conciliador y el controlador de ResourceGroup. Es posible que el controlador de ResourceGroup actualice el estado de ResourceGroup antes de que el conciliador pueda actualizar la especificación de ResourceGroup, lo que provoca el error Solución: Este problema no tiene solución. El error debería resolverse por sí solo. |
| Terraform | Versión 5.41.0 de Terraform |
El Sincronizador de configuración no se puede instalar ni actualizar con TerraformLa versión 5.41.0 de Terraform introdujo un nuevo campo en el recurso Solución:
|
|
| Google Cloud Consola de |
Faltan errores de datos en el panel del Sincronizador de configuración en la Google Cloud Consola de Google CloudEs posible que veas errores como "faltan datos" o "credenciales de clúster no válidas" para los clústeres del Sincronizador de configuración en los paneles de la Google Cloud Consola de Google Cloud. Este problema puede ocurrir cuando no accedes a tus clústeres de GDC (VMware) o GDC (Bare Metal). Solución: Si ves estos tipos de errores en la Google Cloud consola en tus clústeres de GDC (VMware) o GDC (Bare Metal), asegúrate de haber accedido a tus clústeres con el Servicio de identidad de GKE o la puerta de enlace de conexión. |
||
| Sincronizando | 1.21.0 |
Se corrigió: El Sincronizador de configuración impide las actualizaciones de recursos abandonadosAntes de la versión 1.21.0, un objeto RootSync o RepoSync borrado puede dejar atrás varias etiquetas y anotaciones que usa el Sincronizador de configuración para realizar un seguimiento de estos objetos de recursos. Estas etiquetas y anotaciones pueden causar los siguientes efectos secundarios después de que se borra un objeto RootSync o RepoSync:
|
|
| Herramienta de línea de comandos nomos | 1.17.0 |
La CLI de nomos no admite el complemento de autenticación
|
¿Qué sigue?
Si no encuentras una solución a tu problema en la documentación, consulta Obtener asistencia para obtener más ayuda, como asesoramiento en los siguientes temas:
- Comunicarse con Atención al cliente de Cloud para abrir un caso de asistencia.
- Hacer preguntas en
StackOverflow
para obtener asistencia de la comunidad.
Si usas kpt o Kustomize, usa la etiqueta
kptokustomizepara buscar problemas similares. - Abrir errores o solicitudes de funciones con la herramienta de seguimiento de errores pública en GitHub.