In questa pagina sono elencati i problemi noti relativi alle versioni supportate di Config Sync.
Molti dei problemi elencati qui sono stati risolti. La versione corretta indica la versione in cui è stata introdotta la correzione. Per ricevere questa correzione, eseguire l'upgrade alla versione elencata o a una successiva.
Per filtrare i problemi noti in base a una versione del prodotto o a una categoria di problemi, seleziona i filtri dai seguenti menu a discesa.
Seleziona la versione di Config Sync:
Seleziona la categoria del problema:
In alternativa, filtra i problemi noti:
Categoria | Versione identificata | Versione corretta | Problema e soluzione alternativa |
---|---|---|---|
Integrità componente | 1.15.0 | 1.17.0 |
Risolto: container di ricorsione terminato per OOM su AutoPilotNei cluster Autopilot, i container dei componenti Config Sync hanno limiti di risorse impostati per CPU e memoria. Sotto carico, questi container può essere interrotto dal kubelet o dal kernel per utilizzare troppa memoria. Soluzione: Se non puoi eseguire l'upgrade alla versione 1.17.0 o successiva, specifica un limite di memoria più elevato utilizzando override delle risorse. Nella versione 1.17.0, i limiti di CPU e memoria predefiniti sono stati modificati a consentono di evitare errori di memoria nella maggior parte dei casi d'uso. |
Integrità componente | 1.15.0 |
Riconciliatore non pianificabileI riconciliatori di Config Sync richiedono quantità variabili di risorse, a seconda della configurazione di RootSync o RepoSync. Determinati configurazioni richiedono più risorse di altre. Se un riconciliatore non è pianificabile, potrebbe essere dovuto alla richiesta di maggiori rispetto a quelle disponibili sui nodi. Se utilizzi cluster GKE in modalità standard, la risorsa del riconciliatore è impostato su un valore molto basso. Questa impostazione è stata scelta nel tentativo di consentire la pianificazione, anche se comporterebbe limitazioni e rallentamenti in modo che Config Sync funzioni su cluster di piccole dimensioni nodi. Tuttavia, nei cluster GKE Autopilot, le richieste di riconciliazione sono impostate su un valore più elevato per rappresentare in modo più realistico l'utilizzo durante la sincronizzazione. Soluzione: GKE Autopilot GKE Standard con provisioning automatico dei nodi dovrebbe poter vedere quante risorse sono richieste e creare di nodi di dimensioni adeguate per consentire la pianificazione. Tuttavia, se devi manualmente dei nodi o delle dimensioni delle istanze dei nodi, potresti dover regolare per soddisfare i requisiti delle risorse dei pod del riconciliatore. |
|
Errori KNV | 1.15.0 | Kubernetes versione 1.27 |
Risolto: errore KNV1067 anche se la configurazione è stata applicata correttamenteA causa di un problema con OpenAPI v2, potresti visualizzare Soluzione:
Se il cluster esegue una versione di Kubernetes precedente alla 1.27,
assicurati che il campo |
Errori KNV | 1.15.0 | 1.16.0, Kubernetes versione 1.28 |
Risolto il problema di riconciliazione di Config Sync con errore KNV2002Se Config Sync non riesce a effettuare la riconciliazione con un
KNV2002: API discovery failed: APIServer error: unable to retrieve the complete list of server APIs: external.metrics.k8s.io/v1beta1: received empty response for: external.metrics.k8s.io/v1beta1 |
Metriche | 1.15.0 | 1.17.2 |
Risoluzione: Esportazione non riuscita: Etichette delle metriche non riconosciuteNella versione 1.15.0, Config Sync ha aggiunto |
Metriche | 1.15.0 | 1.16.1 |
Risolto: errori di cardinalità e trasformazione delle metriche elevateNella versione 1.15.0, Config Sync ha aggiunto Nella versione 1.16.1, il campo del tipo è stato rimosso, il filtro è stato corretto. e il campo di commit è stato inoltre filtrato da Cloud Monitoring. In questo modo sono stati corretti gli errori e ridotto la cardinalità delle metriche. |
Metriche | 1.15.0 |
Esportazione non riuscita. Autorizzazione negataPer impostazione predefinita, quando il gestore del riconciliazione rileva Credenziali predefinite dell'applicazione, Otel-collector è configurato per esportare le metriche in Prometheus, Cloud Monitoring e Monarch. Soluzione:
|
|
Metriche | 1.15.0 |
Arresto anomalo di otel-collector con configurazione personalizzataSe provi a modificare o eliminare uno dei ConfigMap predefiniti,
Soluzione: Per personalizzare la configurazione dell'esportazione delle metriche, crea un ConfigMap denominato
|
|
interfaccia a riga di comando nomos | 1.15.0 | 1.17.2 |
Risolto:
|
Azioni |
Conflitto tra Config SyncConfig Sync potrebbe essere
rissa tra controller.
con se stessa. Questo problema si verifica se imposti il valore predefinito per
campo facoltativo di una risorsa nel repository Git. Ad esempio:
impostazione di Soluzione: Rimuovi il campo dalla dichiarazione della risorsa. |
||
Azioni |
Config Sync combatte con le risorse di Config ConnectorPuò sembrare che Config Sync
combattimento
Config Connector su una risorsa, ad esempio un
StorageBucket.
Questo problema si verifica se non imposti il valore di un campo facoltativo di una risorsa
Soluzione:
Puoi evitare questo problema aggiungendo il campo |
||
Fonte di dati | 1.17.3 | 1.18.3 |
Aggiornamento: errore di autenticazione SSH Git con GitHub
Il messaggio di errore di Git è:
Soluzione: Utilizza un altro metodo di autenticazione. |
Fonte attendibile | 1.16.1 | 1.16.2 |
Risolto: periodicamente non è stato possibile valutare il link di origineConfig Sync può riscontrare problemi all'avvio del riconciliatore dal punto in cui si trova
periodicamente non è in grado di valutare il link di origine. Questo problema si verifica perché
Nelle versioni 1.16.2 e successive, questo è un errore temporaneo, quindi registrato ma non segnalato come errore. |
Fonte di dati | 1.15.0 | 1.18.0 |
Risolto il problema: periodicamente credenziali di autenticazione non valide per Cloud Source RepositoriesConfig Sync può generare errori periodicamente quando il token di autenticazione scade per Cloud Source Repositories. Questo problema è causato dall'aggiornamento del token che attende la scadenza prima di aggiornare il token. Nella versione 1.18.0 e successive, il token viene aggiornato alla prima richiesta entro cinque minuti dalla scadenza del token. In questo modo viene evitato l'errore relativo alle credenziali di autenticazione non valide, a meno che le credenziali non siano effettivamente non valide. |
Fonte di dati | 1.15.0 | 1.17.0 |
Risolto: errore di sincronizzazione del repository: scadenza del contesto superataNelle versioni precedenti alla 1.17.0, Config Sync eseguiva il check out dell'intera cronologia del repository Git per impostazione predefinita. Questo potrebbe determinare i tempi della richiesta di recupero su repository di grandi dimensioni con molti commit. Nella versione 1.17.0 e successive,
Il recupero Git viene eseguito con Se il problema persiste dopo l'upgrade, è probabile che la fonte attendibile contiene molti file, il server Git risponde lentamente, o c'è qualche altro problema di rete. |
Sincronizzazione | 1.15.0 |
Numero elevato di richieste
|
|
Sincronizzazione | 1.17.0 | 1.17.3 |
Risolto: Config Sync non riesce a eseguire il pull del commit più recente da un ramoIn Config Sync versioni 1.17.0, 1.17.1 e 1.17.2, potresti
si è verificato un problema per cui Config Sync non riesce a eseguire il pull del commit più recente
dall'HEAD di un ramo specifico quando si fa riferimento allo stesso ramo
più telecomandi e non sono sincronizzati. Ad esempio,
Ramo L'esempio seguente mostra come potrebbe presentarsi questo problema: git ls-remote -q [GIT_REPOSITORY_URL] main main^{} 244999b795d4a7890f237ef3c8035d68ad56515d refs/heads/main # the latest commit be2c0aec052e300028d9c6d919787624290505b6 refs/remotes/upstream/main # the commit Config Sync pulls from Nella versione 1.17.3 e successive, la dipendenza git-sync è stata aggiornata con un meccanismo di recupero diverso. Se non puoi eseguire l'upgrade, puoi impostare la revisione Git
( |
Registro privato | 1.19.0 |
Config Sync non utilizza il registro privato per i deployment dei riconciliatoriConfig Sync deve sostituire le immagini di tutti i deployment quando è configurato un registry privato. Tuttavia, Config Sync non sostituisce nel registro immagini per le immagini nei deployment del riconciliatore. Soluzione: Una soluzione alternativa a questo problema è configurare il specchio del registro di sistema di immagini in containerd. |
|
Sincronizzazione | 1.17.0 | 1.18.3 |
Risolto il problema di arresto anomalo in loop dello strumento di riconciliazione di Config SyncNelle versioni 1.17.0 o successive di Config Sync, potresti riscontrare un problema per cui il riconciliatore non riesce a creare una configurazione rest in alcuni provider Kubernetes. L'esempio seguente mostra come potrebbe presentarsi questo problema nei log dei riconciliatori: Error creating rest config: failed to build rest config: reading local kubeconfig: loading REST config from "/.kube/config": stat /.kube/config: no such file or directory |
Terraform | Terraform versione 5.41.0 |
Il valore predefinito del campo Terraform
|
Passaggi successivi
- Se hai bisogno di ulteriore assistenza, contatta Assistenza clienti Google Cloud.