Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare Flusso di immagini per eseguire il pull delle immagini container

Autopilota Standard

Questa pagina mostra come utilizzare lo streaming di immagini in Google Kubernetes Engine (GKE) per eseguire il pull delle immagini container inviando i flussi di 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 utilizzano automaticamente lo streaming di immagini per estrarre le immagini idonee. Le istruzioni sono disponibili solo in questa pagina si applicano ai cluster Standard.

Panoramica

Il flusso di immagini è un metodo per eseguire il pull delle immagini dei container in cui GKE invia i flussi di dati da immagini idonee come richiesto dalle tue applicazioni. Puoi utilizzare il flusso di immagini per consentire l'inizializzazione dei carichi di lavoro senza attendere il download dell'intera immagine, migliorando in modo significativo i 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 per tutti i container che utilizzano immagini container idonee. GKE invia i 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 del contenitore su ogni nodo e la utilizza come file system principale per i carichi di lavoro.

Durante lo streaming dei dati delle immagini, GKE scarica l'intera immagine del contenitore 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 in streaming devi soddisfare i seguenti requisiti Cluster GKE Autopilot e Standard:

Devi abilitare l'API Container File System.

Attivare l'API Container File System
I nuovi cluster Autopilot devono eseguire GKE versione 1.25.5-gke.1000 o successive per avere il flusso di immagini abilitato automaticamente. 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 l'immagine del nodo Container-Optimized OS con Containerd. I nodi Autopilot utilizzano sempre questa immagine del nodo.
Le immagini container devono essere archiviate in Artifact Registry.
Se utilizzi cluster privati, devi abilita l'accesso privato Google sulla subnet per consentire ai tuoi nodi di accedere al servizio flusso di immagini.
Se Controlli di servizio VPC protegge le immagini container e utilizzi Streaming immagine, 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 il tuo account di servizio personalizzato abbia il ruolo IAM Consumatore di utilizzo del servizio (roles/serviceusage.serviceUsageConsumer) nel progetto che ospita l'immagine del contenitore.

Limitazioni

Non puoi usa un secret per eseguire il pull delle immagini container sulle versioni GKE precedenti alla 1.23.5-gke.1900.
Le immagini dei contenitori che utilizzano il manifesto delle immagini V2, versione dello schema 1 non sono idonee.
Immagini container criptate con chiavi di crittografia gestite dal cliente (CMEK) sono idonei per il flusso di immagini su GKE versione 1.25.3-gke.1000 o in un secondo momento. Nelle versioni precedenti, GKE scarica queste immagini senza trasmettere i dati in streaming. Puoi comunque usare CMEK per proteggere dischi permanenti collegati e dischi di avvio personalizzati che usano flussi di immagini.
Le immagini container con livelli duplicati non sono supportate. GKE scarica queste immagini senza trasmettere i dati in modalità flusso. Controlla il container immagine per livelli vuoti o duplicati.
Il repository Artifact Registry deve trovarsi nello stesso region [regione] come nodi GKE o in un più regioni che corrisponde alla regione in cui sono in esecuzione i nodi. Ad esempio:
- Se i tuoi nodi si trovano in us-east1, lo streaming di immagini è disponibile per i repository nella regione us-east1 o nella regione multipla us, poiché sia GKE che Artifact Registry vengono eseguiti in località dei data center all'interno degli Stati Uniti.
- Se i tuoi nodi si trovano nella regione northamerica-northeast1, vengono eseguiti in Canada. In questo caso, lo streaming di immagini è disponibile solo per i repository nella stessa regione.
Se i 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 legge il file remoto.
Potresti non notare i vantaggi dello streaming di immagini durante il primo recupero di un'immagine idonea. Tuttavia, dopo che Image Streaming ha memorizzato nella cache l'immagine, le immagini future trarranno vantaggio da Image Streaming in qualsiasi cluster.
I cluster GKE Standard utilizzano la configurazione a livello di cluster per determinare se attivare o meno lo streaming di immagini sui 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 lo streaming di immagini abilitato quando lo streaming di immagini è disabilitato a livello di cluster.
Le funzionalità dei file Linux come CAP_NET_RAW sono supportate con il flusso di immagini in GKE versione 1.22.6-gke.300 e successive. Per le versioni precedenti di GKE, queste funzionalità non sono disponibili quando il file immagine viene trasmesso in streaming o quando l'immagine viene salvata sul disco locale. Per evitare potenziali interruzioni, non utilizzare lo streaming di immagini per i container con queste funzionalità nelle versioni GKE precedenti a 1.22.6-gke.300. Se il contenitore si basa sulle funzionalità dei file di Linux, potrebbe non riuscire ad avviarsi con errori di autorizzazione negata quando viene eseguito con lo streaming di immagini abilitato.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti attività:

Attiva l'API Google Kubernetes Engine.

Abilita l'API Google Kubernetes Engine

Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.
Nota: per gcloud CLI esistente di installazione, assicurati di impostare compute/region e compute/zone proprietà. Se imposti località predefinite, puoi evitare errori in gcloud CLI come i seguenti: One of [--zone, --region] must be supplied: Please specify location.

Attiva l'API Container File System.

Attiva API Container File System

Attivare il flusso di immagini sui cluster

Puoi attivare lo streaming di immagini su cluster standard nuovi o esistenti utilizzando il flag --enable-image-streaming della riga di comando gcloud o la console Google Cloud. Per impostazione predefinita, i pool di nodi nel cluster ereditano l'impostazione di streaming di immagini a livello di cluster. Puoi modificare questo comportamento di abilitazione o disabilitazione del 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 lo streaming di immagini per estrarre le immagini idonee. Per le istruzioni, consulta Impostare la versione e il canale di rilascio di un nuovo cluster Autopilot. Le istruzioni riportate di seguito si applicano solo ai cluster GKE standard.

Su un nuovo cluster

Puoi attivare lo streaming di immagini sui nuovi cluster utilizzando la riga di comando gcloud 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 Compute Engine per il nuovo cluster. Per i cluster a livello di regione, utilizza --region=COMPUTE_REGION . Assicurati che la zona o la regione siano nella stessa regione o che si trovino all'interno le regioni multiple del repository Artifact Registry che contiene l'immagine.

Console

Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

Vai a Google Kubernetes Engine
Fai clic su 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 lo streaming di immagini.
Configura il cluster in base alle tue esigenze, quindi fai clic su Crea.

Su un cluster esistente

Puoi attivare lo streaming di immagini sui cluster esistenti che soddisfano i requisiti utilizzando l'interfaccia a riga di comando gcloud o la console Google Cloud.

gcloud

Per aggiornare un cluster esistente per utilizzare 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.

Vai a Google Kubernetes Engine
Fai clic sul nome del cluster da modificare.
Nella sezione Funzionalità della pagina Cluster, fai clic su accanto a Streaming di immagini.
Nella finestra di dialogo Modifica flusso immagine, seleziona la casella di controllo Abilita flusso immagine.
Fai clic su Salva modifiche.

Dopo aver modificato il cluster, GKE abilita il flusso di immagini automaticamente i pool di nodi esistenti. Se hai attivato o disattivato esplicitamente lo streaming 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.

Vai a Google Kubernetes Engine
Fai clic sul nome del cluster da controllare.
Nella sezione Funzionalità della pagina Cluster, accanto a Streaming di immagini indica se l'impostazione è attiva.

Attivare lo streaming di immagini nei pool di nodi

Per impostazione predefinita, i pool di nodi ereditano l'impostazione di streaming di immagini a livello di cluster. Puoi abilitare o disabilitare il flusso di immagini su pool di nodi specifici utilizzando con gcloud CLI.

In un nuovo pool di nodi

Per creare un nuovo pool di nodi con lo streaming di immagini abilitato, esegui il seguente 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 cluster. Per i cluster a livello di regione, utilizza --region=COMPUTE_REGION .

Su un pool di nodi esistente

Puoi attivare lo streaming di immagini nei pool di nodi esistenti che soddisfano i requisiti.

Per aggiornare un pool di nodi esistente in modo che utilizzi lo streaming di immagini, esegui il seguente comando:

gcloud container node-pools update POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-image-streaming

Verificare che lo streaming di immagini sia abilitato in un pool di nodi

Controlla se lo streaming 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: {}
...

Pianificare un carico di lavoro utilizzando il flusso di immagini

Dopo aver attivato lo streaming di immagini sul cluster, GKE lo utilizza automaticamente quando estrae le immagini container idonee da Artifact Registry senza richiedere ulteriore configurazione.

GKE aggiunge l'etichetta cloud.google.com/gke-image-streaming: "true" ai nodi in pool di nodi con il flusso di immagini abilitato. Su GKE Standard, se abiliti o disattivi Flusso di immagini su un nodo specifico in modo che il cluster abbia una combinazione di nodi che utilizzano flussi di immagini e nodi che non lo fanno, puoi usare selettori di nodi nei tuoi deployment per controllare se GKE pianifica carichi di lavoro sui nodi che usano flussi di immagini.

Nell'esempio seguente, pianifichi un deployment che utilizza un'immagine del contenitore di grandi dimensioni su un cluster con lo streaming di immagini abilitato. Successivamente, puoi confrontare il rendimento del pull di un'immagine senza che sia abilitato il flusso delle immagini.

Crea un nuovo cluster con lo streaming di immagini abilitato:

gcloud container clusters create CLUSTER_NAME \
    --zone=COMPUTE_ZONE \
    --enable-image-streaming \
    --image-type="COS_CONTAINERD"

Recupera le credenziali per il cluster:

gcloud container clusters get-credentials CLUSTER_NAME \
    --zone=COMPUTE_ZONE

Salva 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: 80

L'immagine contenitore gb-frontend ha una dimensione di 327 MB.

Applica il manifest al cluster:

kubectl apply -f frontend-deployment.yaml

Verifica che GKE abbia creato il deployment:

kubectl get pods -l app=guestbook

L'output è simile al seguente:

NAMESPACE    NAME                          READY    STATUS       RESTARTS    AGE
default      frontend-64bcc69c4b-pgzgm     1/1      Completed    0           3s

Ottieni il log degli eventi Kubernetes per visualizzare gli eventi di estrazione delle immagini:
```
kubectl get events --all-namespaces
```
L'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 Pulled mostra il tempo necessario per il pull del flusso di immagini dell'immagine.
- L'evento ImageStreaming indica che il nodo utilizza il flusso di immagini per caricare l'immagine del contenitore.
  
  Nota: il campo Reason mostra BackedByGCFS anziché ImageStreaming nei cluster con versioni GKE precedenti a 1.20.9-gke.1000. BackedByGCFS indica anche che l'immagine utilizza flussi di immagini.
  Nota: se esegui un carico di lavoro che utilizza la stessa immagine sullo stesso nodo, GKE usa la cache locale dell'immagine anziché trasmettere in streaming dell'immagine. Vedrai Container image "us-docker.pkg.dev/google-samples/containers/gke/gb-frontend:v5" already present on machine nel campo Message per l'evento Pulled del pod. Per testare di nuovo il rendimento dell'Image Streaming, elimina il nodo e creane uno nuovo.

Confrontare il rendimento con i tiri delle immagini standard

In questo esempio facoltativo, creerai un nuovo cluster con Flusso di immagini disabilitato ed esegui il deployment del deployment frontend per confrontare le prestazioni Flusso immagine.

Crea un nuovo cluster con Flusso di immagini disabilitato:
```
gcloud container clusters create CLUSTER2_NAME\
    --zone=COMPUTE_ZONE \
    --image-type="COS_CONTAINERD"
```
Nota: per impostazione predefinita, GKE crea cluster con flussi di immagini disattivata.

Recupera le credenziali per il cluster:

gcloud container clusters get-credentials CLUSTER2_NAME \
    --zone=COMPUTE_ZONE

Esegui il deployment del deployment frontend dall'esempio precedente:
```
kubectl apply -f frontend-deployment.yaml
```
Scarica il log eventi di Kubernetes:
```
kubectl get events --all-namespaces
```
L'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.929723476s
```
Nota il tempo impiegato da GKE per estrarre l'intera immagine. In questo esempio di output, GKE ha impiegato quasi 24 secondi. Con flusso di immagini abilitato, GKE ha avuto bisogno di solo 1,5 secondi per eseguire il pull dell'immagine necessari per avviare il carico di lavoro.

Esegui la pulizia

Per evitare addebiti, elimina i cluster creati negli esempi precedenti:

gcloud container clusters delete CLUSTER_NAME CLUSTER2_NAME

Disattiva flusso immagine

Se utilizzi GKE Autopilot, non puoi disattivare lo streaming di immagini sui singoli cluster. Puoi disabilitare il file container API di sistema, che disabilita il flusso delle immagini per l'intero progetto.

Se utilizzi i cluster GKE Standard, puoi disattivare lo streaming 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 GKE esistente Cluster standard mediante gcloud CLI o nella 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.

Vai a Google Kubernetes Engine
Fai clic sul nome del cluster da modificare.
Nella pagina Cluster, in Funzionalità, fai clic su . accanto a Streaming di immagini.
Nella finestra di dialogo Modifica flusso immagine, deseleziona la casella di controllo Attiva flusso 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 la --no-enable-image-streaming, come nel seguente comando:

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --zone=COMPUTE_ZONE \
    --no-enable-image-streaming

In un pool di nodi esistente

Per disattivare lo streaming di immagini in un pool di nodi esistente, esegui il seguente 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 a alla memoria riservata all'esecuzione dei componenti del sistema dei nodi. GKE non riserva risorse di CPU aggiuntive Flusso immagine. Nei cluster GKE Standard, modifica le risorse di memoria disponibili per la richiesta nei tuoi pod. In GKE Autopilot, le allocazioni del sistema vengono gestite, pertanto non c'è alcun impatto sulla pianificazione dei carichi di lavoro.

Per informazioni dettagliate sulle prenotazioni di memoria effettuate da GKE per i componenti dei nodi, consulta Architettura del cluster standard.

Nei nodi che utilizzano lo streaming di immagini, GKE effettua le seguenti prenotazioni di memoria aggiuntive per le nuove prenotazioni:

Nessuna memoria aggiuntiva per le macchine con meno di 1 GB di memoria
1% dei primi 4 GB di memoria
0,8% dei successivi 4 GiB di memoria (fino a 8 GiB)
0,4% dei successivi 8 GiB di memoria (fino a 16 GiB)
0,24% dei successivi 112 GiB di memoria (fino a 128 GiB)
0,08% di qualsiasi memoria superiore a 128 GiB

Risoluzione dei problemi

GKE non utilizza il file system di streaming di immagini

Se il log eventi di GKE non mostra gli eventi di flussi di immagini, l'immagine non è supportata dal file system remoto. Se GKE in precedenza ha eseguito il pull dell'immagine sul nodo, questo è un comportamento previsto perché GKE utilizza la cache locale dell'immagine per i pull successivi invece di usare lo streaming delle immagini. Puoi verificare 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 on dell'immagine assicurati di soddisfare i requisiti per il flusso di immagini. Se soddisfare i requisiti, puoi eseguire la diagnosi del problema controllando i log delle Servizio di streaming di immagini (denominato gcfsd):

Vai alla pagina Esplora log nella console Google Cloud:

Vai a Esplora log
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 cluster.
Fai clic su Esegui query.

Puoi anche controllare i log gcfsd utilizzando Esplora log:

Vai a Esplora log nella console Google Cloud:

Vai a Esplora log
Nel campo Query, specifica la seguente query:
```
logName="projects/PROJECT_ID/logs/gcfsd"
```
Sostituisci PROJECT_ID con il tuo progetto Google Cloud ID.

PermissionDenied

Se i log gcfsd visualizzano un messaggio di errore simile al seguente, non dispone dell'ambito API corretto. GKE esegue il pull delle immagini dei container per i carichi di lavoro senza utilizzare 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 consentirne l'utilizzo Flusso immagine. 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 noti un messaggio di errore con code = FailedPrecondition, l'immagine non è stata importata nel file system remoto di streaming di immagini.

Potresti notare questo errore se hai provato a utilizzare Image Streaming con un pool di nodi esistente. Se un nodo nel pool di nodi include già l'immagine container su disco, GKE usa l'immagine locale Flusso di immagini in streaming per ottenere l'immagine.

Per risolvere il problema, prova a procedere nel seguente modo:

Attendi qualche minuto e prova a eseguire nuovamente il deployment del tuo carico di lavoro.
Aggiungi nuovi nodi o un nuovo pool di nodi e pianifica il carico di lavoro su questi nodi.

InvalidArgument

Se noti un messaggio di errore con code=InvalidArgument, l'immagine del contenitore impiegata dal tuo carico di lavoro non è idonea per lo streaming di immagini. Assicurati che l'immagine che soddisfi i requisiti. Se l'immagine non è in Artifact Registry, prova a eseguire la migrazione ad Artifact Registry.

`backend.FileContent failed`

Potrebbe essere visualizzato il seguente errore durante la lettura dei file contenitore con Streaming delle immagini abilitato:

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 del file system del contenitore remoto. Per risolvere il 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 chiavi di crittografia gestite dal cliente (CMEK) sono idonei solo per il flusso di immagini sulla versione GKE 1.25.3-gke.1000 o versioni successive. Le immagini container con livelli duplicati non sono idoneo per lo streaming di immagini. Per ulteriori informazioni, consulta la sezione Limitazioni.

Verificare la presenza di livelli vuoti o duplicati

Per verificare se l'immagine del contenitore contiene livelli vuoti o duplicati, esegui il seguente comando:

docker inspect IMAGE_NAME

Sostituisci IMAGE_NAME con il nome dell'immagine container.

Nell'output del comando, controlla le voci in "Layers".

Se una delle voci corrisponde esattamente al seguente output di "sha256", l'immagine container ha un livello vuoto e non è idonea per lo streaming di immagini.

"Layers": [
  ...
  "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4",
  ...
]

Se sono presenti voci duplicate, come nell'esempio seguente, l'immagine del contenitore ha livelli duplicati e non è idonea per lo streaming di immagini.

"Layers": [
  "sha256:28699c71935fe3ffa56533db44ad93e5a30322639f7be70d5d614e06a1ae6d9b",
  ...
  "sha256:28699c71935fe3ffa56533db44ad93e5a30322639f7be70d5d614e06a1ae6d9b",
  ...
]

I comandi `mv` e le chiamate di sistema `renameat2` non vanno a buon fine sui file symlink

Per i nodi GKE che eseguono la versione 1.25 e successive, quando è attivato lo streaming di immagini, il comando mv e la chiamata di sistema renameat2 potrebbero non riuscire sui file symlink nelle immagini dei container con il messaggio di errore "Nessun dispositivo o indirizzo di questo tipo". Il problema è causato da una regressione sui kernel Linux recenti.

Queste chiamate di sistema non sono comuni, quindi la maggior parte delle immagini non è influenzata questo problema. Il problema si verifica in genere nelle fasi di inizializzazione dei container quando un'applicazione è in fase di preparazione per l'esecuzione e lo spostamento tra i file. Non è possibile testare l'immagine in locale, per cui GKE consiglia di usare Flusso di immagini negli ambienti di test per rilevare il problema prima dell'utilizzo dell'immagine 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 ridurre il problema per i carichi di lavoro interessati, puoi provare a sostituire il codice che porta alla chiamata di sistema renameat2. Se non puoi modificare il codice, deve disabilitare il flusso di immagini sul pool di nodi per mitigare problema.

Utilizzare Flusso di immagini per eseguire il pull delle immagini container

Panoramica

Requisiti

Limitazioni

Prima di iniziare

Attivare il flusso di immagini sui cluster

Su un nuovo cluster

gcloud

Console

Su un cluster esistente

gcloud

Console

Verificare che il flusso delle immagini sia abilitato su un cluster

gcloud

Console

Attivare lo streaming di immagini nei pool di nodi

In un nuovo pool di nodi

Su un pool di nodi esistente

Verificare che lo streaming di immagini sia abilitato in un pool di nodi

Pianificare un carico di lavoro utilizzando il flusso di immagini

Confrontare il rendimento con i tiri delle immagini standard

Esegui la pulizia

Disattiva flusso immagine

Disabilita flusso di immagini su un cluster GKE Standard

gcloud

Console

Su un nuovo pool di nodi

In un pool di nodi esistente

Prenotazione di memoria per il flusso di immagini

Risoluzione dei problemi

GKE non utilizza il file system di streaming di immagini

PermissionDenied

FailedPrecondition

InvalidArgument

backend.FileContent failed

GKE scarica l'immagine senza trasmettere i dati in modalità flusso

Verificare la presenza di livelli vuoti o duplicati

I comandi mv e le chiamate di sistema renameat2 non vanno a buon fine sui file symlink

`backend.FileContent failed`

I comandi `mv` e le chiamate di sistema `renameat2` non vanno a buon fine sui file symlink