Proxy frontend con Nginx

Console

1. Vai alla pagina Secret Manager della console Google Cloud:

   Vai a Secret Manager

2. Fai clic su Crea secret.

3. Nel campo del modulo name, inserisci nginx_config.

4. Carica il file nginx.conf in multi-container/hello-nginx-sample/nginx.conf come valore del secret.

5. Mantieni i valori predefiniti (Google-managed encryption key, etc).

6. Fai clic su Crea secret.

7. Concedi all'account di servizio Compute del progetto l'accesso a questo nuovo secret. Per farlo, vai alla pagina IAM nella console Google Cloud:

   Vai a IAM

8. Individua l'account di servizio principale con il nome Compute Engine default service account e fai clic su Modifica entità.

9. Fai clic su Aggiungi un altro ruolo e seleziona Accesso ai segreti di Secret Manager.

10. Fai clic su Salva.

gcloud

1. In un terminale, utilizza il seguente comando per creare un nuovo segreto nginx_config in Secret Manager:

   gcloud secrets create nginx_config --replication-policy='automatic' --data-file='./nginx.conf'

2. Concedi all'account di servizio di calcolo del progetto l'accesso a questo nuovo secret utilizzando il comando

   export PROJECT_NUMBER=$(gcloud projects describe $(gcloud config get-value project) --format='value(projectNumber)')
   gcloud secrets add-iam-policy-binding nginx_config --member=serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com --role='roles/secretmanager.secretAccessor'

3. Verifica che il segreto sia stato creato eseguendo gcloud secrets list.

Console

Vai a Eseguire il deployment del servizio per le istruzioni complete della console.

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

   gcloud run services describe SERVICE --format export > service.yaml

2. In service.yaml, aggiungi quanto segue:

   metadata:
     name: "MC_SERVICE_NAME"
     labels:
       cloud.googleapis.com/location: "REGION"
     annotations:
       # Required to use Cloud Run multi-containers (preview feature)
       run.googleapis.com/launch-stage: BETA
       run.googleapis.com/description: sample tutorial service
       # Externally available
       run.googleapis.com/ingress: all

La sezione descrive la revisione del servizio, che include proprietà che potrebbero variare da una revisione all'altra.

Console

Vai a Eseguire il deployment del servizio per le istruzioni complete della console.

YAML

In service.yaml, aggiungi quanto segue:

spec:
  template:
    metadata:
      annotations:
        # Defines container startup order within multi-container service.
        # Below requires hello container to spin up before nginx container,
        # which depends on the hello container.
        # https://cloud.google.com/run/docs/configuring/containers#container-ordering
        run.googleapis.com/container-dependencies: "{nginx: [hello]}"

Nota l'annotazione container-dependencies che indica a Cloud Run di attendere l'avvio del container hello prima di avviare il container nginx. In caso contrario, se il contenitore nginx si avvia per primo, potrebbe tentare di eseguire il proxy di una richiesta web al contenitore dell'app web non pronto, generando risposte di errore web.

Per ogni contenitore può essere facoltativamente definita una proprietà name che può essere utilizzata per fare riferimento al contenitore in altre direttive. Il contenitore di pubblicazione esegue il server proxy denominato nginx. Questo è il contenitore a cui Cloud Run invia le richieste in entrata, pertanto devi specificare la versione di HTTP e la porta del contenitore a cui inviarle.

Console

Vai a Eseguire il deployment del servizio per le istruzioni complete della console.

YAML

Nel file service.yaml, aggiungi quanto segue:

spec:
  containers:
    # A) Serving ingress container "nginx" listening at PORT 8080
    # Main entrypoint of multi-container service.
    # Source is stored in nginx_config secret in Secret Manager.
    # Any pings to this container will proxy over to hello container at PORT 8888.
    # https://cloud.google.com/run/docs/container-contract#port
    - image: nginx
      name: nginx
      ports:
        - name: http1
          containerPort: 8080
      resources:
        limits:
          cpu: 500m
          memory: 256Mi
      # Referencing declared volume below,
      # Declaring volume to mount in current ingress container's filesystem
      # https://cloud.google.com/run/docs/reference/rest/v2/Container#volumemount
      volumeMounts:
        - name: nginx-conf-secret
          readOnly: true
          mountPath: /etc/nginx/conf.d/
      startupProbe:
        timeoutSeconds: 240
        periodSeconds: 240
        failureThreshold: 1
        tcpSocket:
          port: 8080

Il server nginx richiede un file di configurazione nella directory /etc/nginx/conf.d/. Per farlo, monta un volume contenente il file in quella posizione. La sezione volumeMount specifica un volume denominato configuration da posizionare lì. Il volume stesso è definito in una sezione a parte più avanti nel file.

Console

Vai a Eseguire il deployment del servizio per le istruzioni complete della console.

YAML

In service.yaml, aggiungi quanto segue:

- image: us-docker.pkg.dev/cloudrun/container/hello
  name: hello
  env:
    - name: PORT
      value: "8888"
  resources:
    limits:
      cpu: 1000m
      memory: 512Mi
  startupProbe:
    timeoutSeconds: 240
    periodSeconds: 240
    failureThreshold: 1
    tcpSocket:
      port: 8888

Anche l'applicazione hello richiede informazioni di configurazione. Esegue le operazioni di ascolto delle richieste in entrata sulla porta specificata nella variabile di ambiente PORT. Il nome e il valore sono specificati nella sezione env.

Console

Vai a Eseguire il deployment del servizio per le istruzioni complete della console.

YAML

Nel file service.yaml, aggiungi quanto segue:

volumes:
  - name: nginx-conf-secret
    secret:
      secretName: nginx_config
      items:
        - key: latest
          path: default.conf

Specifica la configurazione volume montata nella sezione volumeMount. Contiene un singolo file denominato nginx.conf i cui contenuti sono definiti come valore del secret denominato nginx-conf-secret.

Console

1. Vai alla pagina Cloud Run nella console Google Cloud:

   Vai a Cloud Run

2. Fai clic su Esegui il deployment del container e seleziona Servizio per visualizzare il modulo Crea servizio.

   1. Seleziona Esegui il deployment di una revisione da un'immagine container esistente e inserisci nginx come URL immagine container.
   2. Nel campo Nome servizio, fornisci un nome per il servizio, ad esempio hello-mc.
   3. Nell'elenco Regione, seleziona una località in cui eseguire il deployment, ad esempio us-west1.
   4. In Authentication (Autenticazione), seleziona Allow unauthenticated invocations. Se non disponi delle autorizzazioni (ruolo Amministratore di Cloud Run) per selezionarlo, il servizio verrà dispiegato e richiederà l'autenticazione.

3. Fai clic su Container, volumi, networking, sicurezza per espandere il modulo di configurazione.

   1. Fai clic sulla scheda Volumi.
   2. Fai clic su Aggiungi volume.
   3. Nell'elenco Tipo di volume, seleziona Segreta.
   4. Nel campo Nome volume, inserisci nginx-conf-secret.
   5. Nel campo Secret, inserisci nginx_config.
   6. In Percorsi specificati per le versioni dei secret, specifica default.conf come percorso e latest come versione.
   7. Fai clic su Crea per creare il volume segreto.

4. Fai clic sulla scheda Container per visualizzare il modulo Modifica contenitore.

   1. Fai clic su Impostazioni e poi in Risorse imposta la memoria su 256 MiB e la CPU su 1 CPU.
   2. Fai clic su Montaggi dei volumi.
   3. Fai clic su Monta il volume.
   4. Seleziona nginx-conf-secret dall'elenco dei nomi.
   5. In Percorso di montaggio, inserisci etc/nginx/conf.d.
   6. Fai clic su Fine per completare la configurazione del primo contenitore.

5. Fai clic su Aggiungi contenitore per aggiungere il contenitore sidecar e visualizzare il modulo Nuovo contenitore.

   1. Seleziona l'URL dell'immagine container predefinito us-docker.pkg.dev/cloudrun/container/hello
   2. Fai clic sulla scheda Impostazioni, quindi in Risorse imposta la memoria su 256 MiB e la CPU su 1 CPU.
   3. Fai clic su Variabili e secret.
   4. Fai clic su Aggiungi variabile.
   5. Inserisci PORT come nome della nuova variabile di ambiente e 8888 come valore.
   6. Fai clic su Fine.

6. Vai al modulo Modifica contenitore per il primo contenitore (nginx).

   1. Fai clic sulla scheda Impostazioni.
   2. In Ordine di avvio del contenitore, seleziona nginx dall'elenco Dipende da. Ciò significa che il contenitore nginx si avvia solo dopo l'avvio del contenitore hello.
   3. Fai clic su Crea e attendi il deployment del servizio.

gcloud

Per eseguire il deployment del contenitore del server proxy e del contenitore dell'app web come un unico servizio:

gcloud run services replace service.yaml

gcloud

Per verificare che il deployment sia stato eseguito correttamente, copia l'URL Cloud Run generato e aprilo in un browser oppure utilizza questo comando per inviare una richiesta autenticata:

curl --header "Authorization: Bearer $(gcloud auth print-identity-token)" 

Dovresti visualizzare un proxy nginx che è stato portato correttamente nel contenitore sidecar hello con stato di risposta 200.

gcloud

1. In un terminale, clona il repository dell'app di esempio sulla tua macchina locale:

   git clone https://github.com/GoogleCloudPlatform/cloud-run-samples

2. Passa alla directory che contiene il codice campione di Cloud Run:

   cd cloud-run-samples/multi-container/hello-nginx-sample/