Il prodotto descritto in questa documentazione, Anthos Clusters on AWS (generazione precedente), è ora in modalità di manutenzione. Tutte le nuove installazioni devono utilizzare il prodotto di generazione attuale, Anthos clusters on AWS.

Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzo di un registro di immagini private

Questo argomento descrive come utilizzare GKE su AWS con un repository di immagini container privato, ad esempio Container Registry (GCR).

Prima di iniziare

Prima di iniziare a utilizzare GKE su AWS, assicurati di aver eseguito le seguenti operazioni:

Completa i prerequisiti.

Installa un servizio di gestione.
Crea un cluster utente.
Dalla directory anthos-aws, utilizza anthos-gke per passare al contesto del cluster utente.
```
cd anthos-aws
env HTTPS_PROXY=http://localhost:8118 \
  anthos-gke aws clusters get-credentials CLUSTER_NAME
```
Sostituisci CLUSTER_NAME con il nome del cluster utente.
Crea un'immagine Docker ed eseguirne il push su Container Registry. Gli esempi in questo argomento utilizzano il container hello-app, creato con i passaggi descritti in Deployment di un'applicazione containerizzata nella documentazione di GKE su Google Cloud .

Container Registry privati

Un container registry archivia e distribuisce immagini container. Per impostazione predefinita, l'installazione di GKE su AWS può accedere alle immagini pubbliche.

Controllare la presenza di immagini su Container Registry

Per completare il resto di questi passaggi, hai bisogno di un'immagine container. Ottieni il nome delle tue immagini container seguendo questi passaggi:

Configura lo strumento a riga di comando Docker per eseguire l'autenticazione su Container Registry con Google Cloud CLI:
```
gcloud auth configure-docker
```
Google Cloud CLI registra un assistente per le credenziali per tutti i registry Docker supportati da Google.
Verifica che Container Registry includa un'immagine con docker images.
```
docker images
```
Docker si connette a Container Registry e restituisce le immagini disponibili nel repository Container Registry. Ad esempio, la risposta riportata di seguito mostra un'immagine container denominata hello-app nel repository project-id.
```
REPOSITORY                    TAG                 IMAGE ID            CREATED             SIZE
gcr.io/project-id/hello-app   v1                  732f02cea7cb        12 minutes ago      11.5MB
```

Se non hai un'immagine del contenitore pronta, creane una seguendo i passaggi descritti in Deployment di un'applicazione in contenitori.

Crea un service account

I cluster utente vengono autenticati utilizzando un service account Identity and Access Management (IAM).

Per creare un nuovo account di servizio:

Crea un account di servizio IAM con Google Cloud CLI.
```
gcloud iam service-accounts create account-name
```
Sostituisci account-name con il nome del account di servizio account Google Cloud.
Concedi all'account di servizio l'accesso a Container Registry.
```
gcloud projects add-iam-policy-binding project-id \
  --member serviceAccount:account-name@project-id.iam.gserviceaccount.com \
  --role roles/storage.objectViewer
```
Sostituisci quanto segue:
- project-id con il tuo progetto Google Cloud
- account-name con il nome del tuo service account Google Cloud
Scarica la chiave del service account dell'account.
```
gcloud iam service-accounts keys create key.json \
  --iam-account account-name@project-id.iam.gserviceaccount.com
```
Sostituisci quanto segue:
- project-id con il tuo progetto Google Cloud
- account-name con il nome del tuo service account Google Cloud
Nota: la chiave del account di servizio consente l'accesso alle risorse con privilegi. Proteggi il file di chiave dopo averlo scaricato.

Ora puoi configurare il cluster utente per connetterti a Container Registry.

Definisci un secret Kubernetes

Per fornire la chiave per l'autenticazione a Container Registry, salva la chiave dell'account di servizio come secret di Kubernetes eseguendo i seguenti passaggi:

Usa kubectl per creare il secret.

env HTTPS_PROXY=http://localhost:8118 \
  kubectl create secret docker-registry gcr-secret \
  --docker-server=gcr.io \
  --docker-username=_json_key \
  --docker-email=account-name@project-id.iam.gserviceaccount.com \
  --docker-password="$(cat key.json)"

Sostituisci quanto segue:

project-id con il tuo progetto Google Cloud
account-name con il nome del tuo service account Google Cloud

Elimina la copia locale della chiave dell'account di servizio.
```
rm key.json
```

Ora puoi fare riferimento a questo secret nei tuoi carichi di lavoro.

Crea un carico di lavoro con un'immagine privata

Per utilizzare un'immagine da un repository di container privato con un workload, imposta il campo spec.imagePullSecrets sul nome del tuo secret. Questo campo si trova in posizioni diverse per pod e deployment.

Creare un pod

Per creare un pod che possa accedere al registro dei container, imposta il campo spec.imagePullSecrets sul nome del secret.

Crea un pod che specifichi spec.imagePullSecrets.

apiVersion: v1
kind: Pod
metadata:
  name: pod-name
spec:
  containers:
  - name: container-name
    image: gcr.io/project-id/hello-app:v1
  imagePullSecrets:
  - name: secret-name

Sostituisci quanto segue:

pod-name con il nome del pod
container-name con il nome del container all'interno del pod
project-id con il tuo progetto Google Cloud
secret-name con il nome del secret del registro

Ad esempio, per eseguire il pull dell'immagine hello-app, copia il seguente codice YAML in un file denominato hello-pod.yaml.

apiVersion: v1
kind: Pod
metadata:
  name: hello-pod
spec:
  containers:
  - name: hello-container
    image: gcr.io/project-id/hello-app:v1
  imagePullSecrets:
  - name: gcr-secret

Applica la configurazione al cluster con kubectl.

env HTTPS_PROXY=http://localhost:8118 \
  kubectl apply -f hello-pod.yaml

Verifica che il pod sia in esecuzione con kubectl get.

env HTTPS_PROXY=http://localhost:8118 \
  kubectl get pod/hello-pod

La risposta include un pod con lo stato Running.

NAME        READY   STATUS    RESTARTS   AGE
hello-pod   1/1     Running   0          15s

Creazione di un deployment

Per utilizzare un repository privato in un deployment, specifica imagePullSecret all'interno del modello.

Ad esempio, per creare un deployment dell'immagine hello-app, crea un file denominato hello-deployment.yaml con il seguente contenuto:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello-app-deployment
spec:
  selector:
    matchLabels:
      app: products
      department: sales
  replicas: 3
  template:
    metadata:
      labels:
        app: products
        department: sales
    spec:
      containers:
      - name: hello
        image: "gcr.io/project-id/hello-app:v1"
        env:
        - name: "PORT"
          value: "50001"
      imagePullSecrets:
      - name: gcr-secret