Questa pagina mostra come utilizzare il flusso di immagini in Google Kubernetes Engine (GKE) per eseguire il pull delle immagini container mediante l'invio in modalità flusso dei dati delle immagini in base alle esigenze delle tue applicazioni.
I nuovi cluster Autopilot che eseguono GKE versione 1.25.5-gke.1000 e successive usano automaticamente il flusso di immagini per estrarre le immagini idonee. Le istruzioni in questa pagina si applicano solo ai cluster standard.
Panoramica
Il flusso di immagini è un metodo per eseguire il pull delle immagini container in cui GKE trasmette i flussi di dati dalle immagini idonee come richiesto dalle tue applicazioni. Puoi utilizzare Flusso di immagini per consentire l'inizializzazione dei carichi di lavoro senza attendere il download dell'intera immagine, il che comporta miglioramenti significativi nei tempi di inizializzazione. Il tempo di pull ridotto offre vantaggi tra cui:
- Scalabilità automatica più rapida
- Latenza ridotta durante il pull di immagini di grandi dimensioni
- Avvio più rapido dei pod
Con il flusso di immagini, GKE utilizza un file system remoto come file system radice per tutti i container che utilizzano immagini container idonee. GKE trasmette i flussi di dati delle immagini dal file system remoto in base alle esigenze dei tuoi carichi di lavoro. Senza il flusso di immagini, GKE scarica l'intera immagine container su ciascun nodo e la utilizza come file system radice per i tuoi carichi di lavoro.
Durante il flusso di dati dell'immagine, GKE scarica l'intera immagine container sul disco locale in background e la memorizza nella cache. GKE gestisce quindi le future richieste di lettura dei dati dall'immagine memorizzata nella cache.
Quando esegui il deployment di carichi di lavoro che devono leggere file specifici nell'immagine container, il backend di flussi di immagini gestisce solo i file richiesti.
Requisiti
Per utilizzare il flusso di immagini nei cluster GKE Autopilot e Standard, devi soddisfare i seguenti requisiti:
Devi abilitare l'API Container File System.
I nuovi cluster Autopilot devono eseguire GKE versione 1.25.5-gke.1000 o successive per abilitare automaticamente il flusso di immagini. Per le istruzioni, consulta Impostare la versione e il canale di rilascio di un nuovo cluster Autopilot.
I cluster GKE Standard nuovi ed esistenti devono eseguire la versione 1.18.6-gke.4801 o successive.
Devi utilizzare Container-Optimized OS con l'immagine nodo containerd. I nodi Autopilot utilizzano sempre questa immagine del nodo.
Le immagini container devono essere archiviate in Artifact Registry.
Se utilizzi cluster privati, devi abilitare l'accesso privato Google sulla subnet per consentire ai nodi di accedere al servizio di flussi di immagini.
Se Controlli di servizio VPC protegge le immagini container e utilizzi flussi di immagini, devi includere anche l'API Image streaming (
containerfilesystem.googleapis.com) nel perimetro di servizio.Se i nodi GKE nel cluster non utilizzano l'account di servizio predefinito, devi assicurarti che l'account di servizio personalizzato abbia il ruolo IAM Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer) nel progetto che ospita l'immagine container.
Limitazioni
- Non puoi utilizzare un secret per eseguire il pull delle immagini container su versioni GKE precedenti alla 1.23.5-gke.1900.
- Le immagini container che utilizzano il file manifest dell'immagine V2, versione 1 dello schema non sono idonee.
- Le immagini container criptate con le chiavi di crittografia gestite dal cliente (CMEK) sono idonee per lo streaming di immagini su GKE versione 1.25.3-gke.1000 o successive. Nelle versioni precedenti, GKE scarica queste immagini senza trasmettere i dati. Puoi comunque utilizzare CMEK per proteggere i dischi permanenti collegati e i dischi di avvio personalizzati nei cluster che utilizzano flussi di immagini.
- Le immagini container con livelli duplicati sono idonee solo per lo streaming di immagini su GKE versione 1.28 o successive. Nelle versioni precedenti, GKE scarica queste immagini senza trasmettere i dati in modalità flusso. Controlla se nell'immagine container sono presenti livelli vuoti o livelli duplicati.
- Il repository Artifact Registry deve trovarsi nella stessa regione dei nodi GKE o in una più regioni che corrisponde a quella in cui sono in esecuzione i nodi. Ad esempio:
- Se i nodi si trovano in
us-east1, il flusso di immagini è disponibile per i repository nella regioneus-east1o inusa più regioni, poiché sia GKE che Artifact Registry sono in esecuzione nelle località dei data center all'interno degli Stati Uniti. - Se i nodi si trovano nella regione
northamerica-northeast1, sono in esecuzione in Canada. In questo caso, il flusso di immagini è disponibile solo per i repository nella stessa regione.
- Se i nodi si trovano in
- Se i tuoi carichi di lavoro leggono molti file in un'immagine durante l'inizializzazione, potresti notare un aumento dei tempi di inizializzazione a causa della latenza aggiunta dalle letture dei file remoti.
- Potresti non notare i vantaggi dello streaming di immagini durante il primo pull di un'immagine idonea. Tuttavia, dopo che il flusso di immagini memorizza nella cache l'immagine, i futuri pull delle immagini su qualsiasi cluster traggono vantaggio dal flusso di immagini.
- I cluster GKE Standard utilizzano la configurazione a livello di cluster per determinare se abilitare il flusso di immagini su nuovi pool di nodi creati utilizzando il provisioning automatico dei nodi. Tuttavia, non puoi utilizzare la separazione dei carichi di lavoro per creare pool di nodi con Flusso di immagini abilitato quando il flusso di immagini è disabilitato a livello di cluster.
- Le funzionalità dei file Linux come
CAP_NET_RAWsono supportate con i flussi di immagini in GKE versione 1.22.6-gke.300 e successive. Per le versioni precedenti di GKE, queste funzionalità non sono disponibili quando viene eseguito lo streaming del file immagine o quando l'immagine viene salvata sul disco locale. Per evitare potenziali interruzioni, non utilizzare flussi di immagini per i container con queste funzionalità nelle versioni GKE precedenti alla 1.22.6-gke.300. Se il container si basa su funzionalità dei file Linux, potrebbe non avviarsi con errori di autorizzazione negata se viene eseguito con il flusso di immagini abilitato.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Se vuoi utilizzare Google Cloud CLI per questa attività, installa e quindi initialize gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo
gcloud components update.
Attiva l'API Container File System.
Abilita flusso di immagini sui cluster
Puoi abilitare il flusso di immagini su cluster standard nuovi o esistenti utilizzando il flag --enable-image-streaming di gcloud CLI oppure la console Google Cloud. Per impostazione predefinita, i pool di nodi nel cluster ereditano l'impostazione relativa ai flussi di immagini a livello di cluster. Puoi modificare questo comportamento abilitando o disabilitando il flusso di immagini sui pool di nodi nel cluster.
Tutti i nuovi cluster Autopilot che eseguono GKE versione 1.25.5-gke.1000 e successive utilizzano il flusso di immagini per eseguire il pull delle immagini idonee. Per le istruzioni, consulta Impostare la versione e il canale di rilascio di un nuovo cluster Autopilot. Le seguenti istruzioni si applicano solo ai cluster GKE Standard.
In un nuovo cluster
Puoi abilitare il flusso di immagini su nuovi cluster utilizzando gcloud CLI o la console Google Cloud.
gcloud
Per creare un nuovo cluster con Flusso di immagini abilitato, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--zone=COMPUTE_ZONE \
--image-type="COS_CONTAINERD" \
--enable-image-streaming
Sostituisci quanto segue:
CLUSTER_NAME: il nome del nuovo cluster.COMPUTE_ZONE: la zona di Compute Engine per il nuovo cluster. Per i cluster a livello di regione, utilizza invece il flag--region=COMPUTE_REGION. Assicurati che la zona o la regione si trovi nella stessa regione o che si trovi all'interno di più regioni del repository Artifact Registry che contiene l'immagine.
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic su add_box Crea.
Nella sezione GKE Standard, fai clic su Configura.
Nel riquadro di navigazione, in Cluster, fai clic su Funzionalità.
Nella sezione Altro, seleziona la casella di controllo Abilita flusso di immagini.
Configura il cluster in base alle tue esigenze, quindi fai clic su Crea.
Su un cluster esistente
Puoi abilitare il flusso di immagini su cluster esistenti che soddisfano i requisiti utilizzando gcloud CLI o la console Google Cloud.
gcloud
Per aggiornare un cluster esistente in modo che utilizzi Flusso di immagini, esegui questo comando utilizzando gcloud CLI:
gcloud container clusters update CLUSTER_NAME \
--enable-image-streaming
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic sul nome del cluster da modificare.
Nella sezione Funzionalità della pagina Cluster, fai clic su edit accanto a Flusso di immagini.
Nella finestra di dialogo Modifica streaming immagine, seleziona la casella di controllo Attiva streaming immagine.
Fai clic su Salva modifiche.
Dopo aver modificato il cluster, GKE abilita automaticamente il flusso di immagini sui pool di nodi esistenti per impostazione predefinita. Se hai abilitato o disabilitato esplicitamente il flusso di immagini su singoli pool di nodi, questi pool di nodi non ereditano le modifiche all'impostazione a livello di cluster.
Verificare che il flusso delle immagini sia abilitato su un cluster
Puoi verificare se il flusso di immagini è abilitato a livello di cluster utilizzando gcloud CLI o la console Google Cloud.
gcloud
Esegui questo comando:
gcloud container clusters describe CLUSTER_NAME \
--flatten "nodePoolDefaults.nodeConfigDefaults"
L'impostazione è abilitata se l'output è simile al seguente:
gcfsConfig:
enabled: true
...
L'impostazione è disabilitata se l'output è simile al seguente:
gcfsConfig: {}
...
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic sul nome del cluster che vuoi controllare.
Nella sezione Funzionalità della pagina Cluster, accanto a Flusso di immagini verrà visualizzato se l'impostazione è abilitata.
Abilita flusso di immagini sui pool di nodi
Per impostazione predefinita, i pool di nodi ereditano l'impostazione Flusso di immagini a livello di cluster. Puoi abilitare o disabilitare il flusso di immagini su pool di nodi specifici utilizzando gcloud CLI.
Su un nuovo pool di nodi
Per creare un nuovo pool di nodi con Flusso di immagini abilitato, esegui questo comando:
gcloud container node-pools create NODE_POOL_NAME \
--cluster=CLUSTER_NAME \
--zone=COMPUTE_ZONE \
--image-type="COS_CONTAINERD" \
--enable-image-streaming
Sostituisci quanto segue:
NODE_POOL_NAME: il nome del nuovo pool di nodi.CLUSTER_NAME: il nome del cluster per il pool di nodi.COMPUTE_ZONE: la zona Compute Engine del tuo cluster. Per i cluster a livello di regione, utilizza invece il flag--region=COMPUTE_REGION.
Su un pool di nodi esistente
Puoi abilitare il flusso di immagini su pool di nodi esistenti che soddisfano i requisiti.
Per aggiornare un pool di nodi esistente in modo che utilizzi il flusso di immagini, esegui questo comando:
gcloud container node-pools update POOL_NAME \
--cluster=CLUSTER_NAME \
--enable-image-streaming
Verifica che il flusso delle immagini sia abilitato su un pool di nodi
Controlla se il flusso di immagini è abilitato per un pool di nodi:
gcloud container node-pools describe POOL_NAME \
--cluster=CLUSTER_NAME \
L'impostazione è abilitata se l'output è simile al seguente:
gcfsConfig:
enabled: true
...
L'impostazione è disabilitata se l'output è simile al seguente:
gcfsConfig: {}
...
Pianifica un carico di lavoro utilizzando il flusso di immagini
Dopo aver abilitato il flusso di immagini sul cluster, GKE utilizza automaticamente il flusso di immagini durante il pull di immagini container idonee da Artifact Registry, senza richiedere ulteriori configurazioni.
GKE aggiunge l'etichetta cloud.google.com/gke-image-streaming: "true" ai nodi nei pool di nodi con il flusso di immagini abilitato. In GKE Standard, se abiliti o disabiliti il flusso di immagini su pool di nodi specifici in modo che il cluster abbia una combinazione di nodi che utilizzano flussi di immagini e nodi che non lo utilizzano, puoi utilizzare selettori di nodi nei deployment per controllare se GKE pianifica i tuoi carichi di lavoro sui nodi che utilizzano flussi di immagini.
Nell'esempio seguente, pianifichi un deployment che utilizza un'immagine container di grandi dimensioni su un cluster in cui è abilitato il flusso di immagini. Se vuoi, puoi quindi confrontare il rendimento con il pull di immagini senza streaming delle immagini attivato.
Crea un nuovo cluster con Flusso di immagini abilitato:
gcloud container clusters create CLUSTER_NAME \ --zone=COMPUTE_ZONE \ --enable-image-streaming \ --image-type="COS_CONTAINERD"Ottieni le credenziali per il cluster:
gcloud container clusters get-credentials CLUSTER_NAME \ --zone=COMPUTE_ZONESalva il seguente manifest come
frontend-deployment.yaml:apiVersion: apps/v1 kind: Deployment metadata: name: frontend spec: replicas: 1 selector: matchLabels: app: guestbook tier: frontend template: metadata: labels: app: guestbook tier: frontend spec: containers: - name: php-redis image: us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5 env: - name: GET_HOSTS_FROM value: "dns" resources: requests: cpu: 100m memory: 100Mi ports: - containerPort: 80L'immagine container
gb-frontendha una dimensione di 327 MB.Applica il manifest al cluster:
kubectl apply -f frontend-deployment.yamlVerifica che GKE abbia creato il deployment:
kubectl get pods -l app=guestbookL'output è simile al seguente:
NAMESPACE NAME READY STATUS RESTARTS AGE default frontend-64bcc69c4b-pgzgm 1/1 Completed 0 3sScarica il log eventi di Kubernetes per vedere gli eventi pull delle immagini:
kubectl get events --all-namespacesL'output è simile al seguente:
NAMESPACE LAST SEEN TYPE REASON OBJECT MESSAGE default 11m Normal Pulling pod/frontend-64bcc69c4b-pgzgm Pulling image "us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5" default 11m Normal Pulled pod/frontend-64bcc69c4b-pgzgm Successfully pulled image "us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5" in 1.536908032s default 11m Normal ImageStreaming node/gke-riptide-cluster-default-pool-f1552ec4-0pjv Image us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5 is backed by image streaming. ...In questo output:
- L'evento
Pulledmostra il tempo impiegato dal flusso di immagini per eseguire il pull dell'immagine. L'evento
ImageStreamingmostra che il nodo utilizza Flusso di immagini per pubblicare l'immagine container.
- L'evento
Confronta il rendimento con le estrazioni di immagini standard
In questo esempio facoltativo, creerai un nuovo cluster con Flusso di immagini disabilitato ed eseguirai il deployment del deployment frontend per confrontare le prestazioni con il flusso di immagini.
Crea un nuovo cluster con Flusso di immagini disabilitato:
gcloud container clusters create CLUSTER2_NAME\ --zone=COMPUTE_ZONE \ --image-type="COS_CONTAINERD"Ottieni le credenziali per il cluster:
gcloud container clusters get-credentials CLUSTER2_NAME \ --zone=COMPUTE_ZONEEsegui il deployment del deployment
frontenddall'esempio precedente:kubectl apply -f frontend-deployment.yamlScarica il log eventi di Kubernetes:
kubectl get events --all-namespacesL'output è simile al seguente:
NAMESPACE LAST SEEN TYPE REASON OBJECT MESSAGE default 87s Normal Pulled pod/frontend-64bcc69c4b-qwmfp Successfully pulled image "us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5" in 23.929723476sNota il tempo impiegato da GKE per eseguire il pull dell'intera immagine. In questo output di esempio, GKE ha richiesto quasi 24 secondi. Con il flusso di immagini abilitato, GKE ha avuto bisogno di solo 1,5 secondi per eseguire il pull dei dati dell'immagine richiesti dal carico di lavoro per avviare.
Esegui la pulizia
Per evitare addebiti, elimina i cluster che hai creato negli esempi precedenti:
gcloud container clusters delete CLUSTER_NAME CLUSTER2_NAME
Disattiva flusso immagine
Se usi GKE Autopilot, non puoi disabilitare il flusso di immagini su singoli cluster. Puoi disabilitare l'API Container File System, che disabilita il flusso di immagini per l'intero progetto.
Se utilizzi cluster GKE Standard, puoi disabilitare il flusso di immagini su singoli cluster o pool di nodi specifici, come descritto nelle sezioni seguenti.
Disabilita flusso di immagini su un cluster GKE Standard
Puoi disabilitare il flusso di immagini su cluster GKE Standard esistenti utilizzando gcloud CLI o la console Google Cloud.
gcloud
Per disabilitare il flusso di immagini in un cluster esistente, esegui questo comando:
gcloud container clusters update CLUSTER_NAME \
--no-enable-image-streaming
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic sul nome del cluster da modificare.
Nella pagina Cluster, in Funzionalità, fai clic su edit accanto a Flusso di immagini.
Nella finestra di dialogo Modifica streaming immagine, deseleziona la casella di controllo Attiva streaming immagine.
Fai clic su Salva modifiche.
Su un nuovo pool di nodi
Per disabilitare il flusso di immagini durante la creazione di un nuovo pool di nodi, specifica il flag --no-enable-image-streaming, ad esempio nel seguente comando:
gcloud container node-pools create NODE_POOL_NAME \
--cluster=CLUSTER_NAME \
--zone=COMPUTE_ZONE \
--no-enable-image-streaming
Su un pool di nodi esistente
Per disabilitare il flusso di immagini su un pool di nodi esistente, esegui questo comando:
gcloud container node-pools update NODE_POOL_NAME \
--cluster=CLUSTER_NAME \
--no-enable-image-streaming
Prenotazione di memoria per il flusso di immagini
GKE prenota risorse di memoria per i flussi di immagini oltre alla memoria riservata all'esecuzione dei componenti del sistema dei nodi. GKE non prenota risorse della CPU aggiuntive per i flussi di immagini. Nei cluster GKE Standard, questa prenotazione modifica le risorse di memoria disponibili per la richiesta nei tuoi pod. In GKE Autopilot, GKE gestisce le allocazioni di sistema, quindi non c'è alcun impatto sulla pianificazione dei carichi di lavoro.
Per maggiori dettagli sulle prenotazioni di memoria effettuate da GKE per i componenti dei nodi, consulta Architettura dei cluster standard.
Nei nodi che utilizzano i flussi di immagini, GKE effettua le seguenti prenotazioni di memoria aggiuntiva per le nuove prenotazioni:
- Nessuna memoria aggiuntiva per le macchine con meno di 1 GiB di memoria
- 1% dei primi 4 GiB di memoria
- 0,8% dei successivi 4 GiB di memoria (fino a 8 GiB)
- 0,4% degli 8 GiB di memoria successivi (fino a 16 GiB)
- 0,24% dei successivi 112 GiB di memoria (fino a 128 GiB)
- 0,08% di memoria superiore a 128 GiB
Risoluzione dei problemi
GKE non utilizza il file system di flussi di immagini
Se nel log eventi di GKE non sono visualizzati gli eventi di flusso di immagini,
l'immagine non è supportata dal file system remoto. Se GKE ha precedentemente eseguito il pull dell'immagine sul nodo, questo è il comportamento previsto perché GKE utilizza la cache locale dell'immagine per i pull successivi invece di utilizzare il flusso di immagini.
Puoi verificarlo cercando Container image IMAGE_NAME already present on machine
nel campo Message per l'evento Pulled del pod.
Se non vedi l'evento Flusso immagine durante il primo pull dell'immagine sul nodo, assicurati di soddisfare i requisiti per il flusso di immagini. Se soddisfi i requisiti, puoi diagnosticare il problema controllando i log del servizio di streaming di immagini (denominato gcfsd):
Vai alla pagina Esplora log nella console Google Cloud:
Nel campo Query specifica la seguente query:
logName="projects/PROJECT_ID/logs/gcfsd" resource.labels.cluster_name="CLUSTER_NAME"Sostituisci quanto segue:
PROJECT_ID: il nome del progetto.CLUSTER_NAME: il nome del tuo cluster.
Fai clic su Esegui query.
Puoi anche controllare i log di gcfsd utilizzando Esplora log:
Vai a Esplora log nella console Google Cloud:
Nel campo Query specifica la seguente query:
logName="projects/PROJECT_ID/logs/gcfsd"Sostituisci
PROJECT_IDcon l'ID del tuo progetto Google Cloud.
PermissionDenied
Se i log gcfsd mostrano un messaggio di errore simile al seguente, il nodo non ha l'ambito API corretto. GKE esegue il pull delle immagini container
per i carichi di lavoro senza usare il flusso di immagini.
level=fatal msg="Failed to create a Container File System client: rpc error:
code = PermissionDenied desc = failed to probe endpoint: rpc error: code = PermissionDenied
desc = Request had insufficient authentication scopes."
Puoi risolvere il problema concedendo al nodo l'ambito corretto per consentire l'utilizzo di flussi di immagini. Aggiungi l'ambito devstorage.read_only al cluster o al pool di nodi, in modo simile al seguente comando:
gcloud container node-pools create NODE_POOL_NAME \
--cluster=CLUSTER_NAME \
--zone=COMPUTE_ZONE \
--image-type="COS_CONTAINERD" \
--enable-image-streaming \
--scope="https://www.googleapis.com/auth/devstorage.read_only"
FailedPrecondition
Se visualizzi un messaggio di errore con code = FailedPrecondition, l'immagine
non è stata importata nel file system remoto Flusso di immagini.
Potresti notare questo errore se provi a utilizzare il flusso di immagini con un pool di nodi esistente. Se un nodo nel pool di nodi ha già l'immagine container su disco, GKE utilizza l'immagine locale anziché utilizzare il flusso di immagini per ottenere l'immagine.
Per risolvere il problema, prova a procedere nel seguente modo:
- Attendi alcuni minuti e riprova a eseguire il deployment del carico di lavoro.
- Aggiungi nuovi nodi o un nuovo pool di nodi e pianifica il carico di lavoro su quei nodi.
InvalidArgument
Se visualizzi un messaggio di errore con code=InvalidArgument, l'immagine container
utilizzata dal carico di lavoro non è idonea per il flusso di immagini. Assicurati che l'immagine soddisfi i requisiti. Se l'immagine non è in Artifact Registry,
prova a eseguire la migrazione ad Artifact Registry.
backend.FileContent failed
Durante la lettura di file contenitore con lo streaming delle immagini abilitato, potrebbe essere visualizzato il seguente errore:
level=error msg="backend.FileContent failed" error="rpc error: code = ResourceExhausted desc = Quota exceeded for quota metric 'Content requests per project per region' and limit 'Content requests per project per region per minute per region' of service 'containerfilesystem.googleapis.com' for consumer 'project_number:PROJECT_NUMBER'." layer_id="sha256:1234567890" module=gcfs_backend offset=0 path=etc/passwd size=4096
Questo errore indica che il progetto ha superato la quota richiesta per leggere i file dal servizio file system del container remoto. Per risolvere questo problema, aumenta le quote seguenti:
- Richieste di contenuti per progetto per regione al minuto per regione
- Richieste di contenuti per progetto per regione
GKE scarica l'immagine senza trasmettere i dati in modalità flusso
Le immagini container che utilizzano le chiavi di crittografia gestite dal cliente (CMEK) sono idonee solo per il flusso di immagini su GKE versione 1.25.3-gke.1000 o successive. Le immagini container con livelli duplicati sono idonee solo per lo streaming di immagini su GKE versione 1.28 o successive. Per ulteriori informazioni, consulta le Limitazioni.
Controllo di livelli vuoti o duplicati in corso...
Per verificare la presenza di livelli vuoti o duplicati nell'immagine container, esegui questo comando:
docker inspect IMAGE_NAME
Sostituisci IMAGE_NAME con il nome dell'immagine container.
Nell'output del comando, controlla le voci sotto "Layers".
Se una delle voci corrisponde esattamente al seguente"sha256" output, l'immagine container ha un livello vuoto e non è idonea per il flusso di immagini.
"Layers": [ ... "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4", ... ]
Se sono presenti voci duplicate come nell'esempio seguente, l'immagine container ha livelli duplicati e non è idonea per il flusso di immagini.
"Layers": [
"sha256:28699c71935fe3ffa56533db44ad93e5a30322639f7be70d5d614e06a1ae6d9b",
...
"sha256:28699c71935fe3ffa56533db44ad93e5a30322639f7be70d5d614e06a1ae6d9b",
...
]
Il comando mv e renameat2 chiamate di sistema hanno esito negativo nei file link simbolici
Per i nodi GKE che eseguono la versione 1.25 e successive, quando il flusso di immagini è abilitato, il comando mv e la chiamata di sistema renameat2 potrebbero avere esito negativo sui file link simbolici nelle immagini container con il messaggio di errore "Dispositivo o indirizzo non trovato". Il problema è causato da una regressione sui kernel Linux recenti.
Queste chiamate di sistema non sono comuni, quindi la maggior parte delle immagini non è interessata da questo problema. Il problema si verifica in genere nelle fasi di inizializzazione del container, durante la preparazione dell'applicazione per l'esecuzione e lo spostamento tra i file. Non è possibile testare l'immagine in locale, per cui GKE consiglia di utilizzare il flusso di immagini negli ambienti di test per individuare il problema prima che l'immagine venga utilizzata in produzione.
La correzione è disponibile nelle seguenti versioni di patch GKE:
- 1,25: 1.25.14-gke.1351000 e versioni successive
- 1,26: 1.26.9-gke.1345000 e versioni successive
- 1.27: 1.27.6-gke.100 e versioni successive
- 1.28: 1.28.1-gke.1157000 e versioni successive
In alternativa, per limitare il problema a eventuali carichi di lavoro interessati, puoi provare a sostituire il codice che genera la chiamata di sistema renameat2. Se non puoi modificare il codice, devi disabilitare Flusso delle immagini sul pool di nodi per mitigare il problema.