Configurazione dei container

Scopri come configurare la porta del container e il comando e gli argomenti dell'entrypoint del container.

Quando Knative serving avvia un container, esegue il comando entrypoint predefinito dell'immagine e gli argomenti del comando predefiniti. Se vuoi eseguire l'override dell'entrypoint predefinito e degli argomenti del comando dell'immagine, puoi utilizzare i campi command e args nella configurazione del container. Il campo command specifica il comando effettivo eseguito dal container. Il campo args specifica gli argomenti passati a questo comando.

Configurare la porta del container

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Il container deve rimanere in ascolto sulla porta definita dalla variabile di ambiente PORT anziché su una porta hardcoded specifica. Tuttavia, se non è possibile, puoi configurare la porta su cui vengono inviate le richieste al container:

Console

1. Vai a Knative serving nella Google Cloud console:

   Vai a Knative serving

2. Fai clic su Crea servizio se stai configurando un nuovo servizio di cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment di una nuova revisione.

3. In Impostazioni avanzate, fai clic su Container.

4. Specifica la porta a cui vuoi che vengano inviate le richieste, se non è il valore predefinito 8080. In questo modo viene impostata anche la variabile di ambiente PORT.

5. Fai clic su Avanti per continuare alla sezione successiva.

6. Nella sezione Configura il funzionamento del trigger per questo servizio , seleziona la connettività che vuoi utilizzare per richiamare il servizio.

7. Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi il completamento del deployment.

Riga di comando

• Per i servizi esistenti, aggiorna un'impostazione della porta eseguendo il gcloud run services update comando con i seguenti parametri:

  gcloud run services update SERVICE --port PORT

  Sostituisci:

  • SERVICE con il nome del servizio.
  • PORT con la porta a cui inviare le richieste. Tieni presente che la porta predefinita è 8080.

• Per i nuovi servizi, imposta la porta eseguendo il gcloud run deploy comando con il --port parametro:

  gcloud run deploy SERVICE --image=IMAGE_URL --port PORT

  Sostituisci:

  • SERVICE con il nome del servizio.
  • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
  • PORT con la porta a cui vuoi inviare le richieste. La porta predefinita è 8080.

YAML

Attenzione: il deployment delle modifiche alla configurazione utilizzando i file YAML sostituisce la configurazione dei servizi esistenti. Poiché un file YAML sovrascrive completamente tutte le configurazioni, devi evitare di utilizzare più metodi per modificare i servizi. Ad esempio, non utilizzare i file YAML insieme ai Google Cloud comandi della console o di gcloud.

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il gcloud run services describe comando utilizzando il --format=export flag. Puoi quindi modificare il file YAML ed eseguire il deployment delle modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

1. Scarica la configurazione del servizio in un file denominato service.yaml nell'area di lavoro locale:

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

   Sostituisci SERVICE con il nome del tuo servizio Knative serving.

2. Nel file locale, aggiorna l'attributo containerPort::

   apiVersion: serving.knative.dev/v1
   kind: Service
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
           ports:
           - containerPort: PORT
   

   Sostituisci

   • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
   • PORT con la porta a cui vuoi inviare le richieste.

3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente comando:

   gcloud run services replace service.yaml

Configurare il comando e gli argomenti dell'entrypoint del container

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Quando Knative serving avvia un container, esegue il comando default entrypoint predefinito dell'immagine. Per specificare o sostituire il comando e gli argomenti dell'entrypoint esistenti definiti nell'immagine container, puoi configurare le impostazioni command e args nella configurazione del container Knative serving.

Puoi scegliere di configurare i comandi entrypoint, gli argomenti o entrambi. Il comando specificato in Knative serving sostituisce qualsiasi comando entrypoint definito nell'immagine container. Se scegli di specificare solo gli argomenti, questi vengono passati ed eseguiti dal comando entrypoint definito nell'immagine container.

In Knative serving, puoi configurare i comandi e gli argomenti dell'entrypoint utilizzando la Google Cloud console, Google Cloud CLI o un file YAML quando esegui il deployment di un nuovo servizio, aggiorni un servizio esistente o esegui il deployment di una revisione:

Console

1. Vai a Knative serving nella Google Cloud console:

   Vai a Knative serving

2. Fai clic su Crea servizio se stai configurando un nuovo servizio di cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment di una nuova revisione.

3. In Impostazioni avanzate, fai clic su Container.

4. Specifica il comando e gli argomenti dell'entrypoint che vuoi che il container esegua durante l'avvio.

5. Fai clic su Avanti per continuare alla sezione successiva.

6. Nella sezione Configura il funzionamento del trigger per questo servizio , seleziona la connettività che vuoi utilizzare per richiamare il servizio.

7. Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi il completamento del deployment.

Riga di comando

Opzioni dei parametri dei comandi

• Per specificare un argomento che contiene una virgola (,), devi eseguire l'escape di ogni ARG con un delimitatore diverso. Ad esempio, se utilizzi @:

  --args "^@^arg,with,commas@anotherarg@ARG3..."

• Per specificare più insiemi di coppie chiave-valore, puoi specificare più parametri per la leggibilità. Esempio:

  [...]
  --args "ARG1" \
  --args "ARG2" \
  --args "ARG3"

• Per utilizzare i segni di uguale (=) negli argomenti, devi specificare ogni argomento utilizzando il seguente formato:

  gcloud run services ...  \
    --args "--repo-allowlist=github.com/example/example_demo" \
    --args "--gh-webhook-secret=XX"

Ok

• Per i servizi esistenti, aggiorna il comando entrypoint eseguendo il gcloud run services update comando con i seguenti parametri:

  gcloud run services update SERVICE --command COMMAND --args ARG1,ARG2,ARG-N

  Sostituisci:

  • SERVICE con il nome del servizio.
  • (Facoltativo) COMMAND con il comando che vuoi che il container esegua durante l'avvio.
  • (Facoltativo) ARG1 con uno o più argomenti per il comando eseguito durante l'avvio. Utilizza un elenco delimitato da virgole per più argomenti. Come formattare gli argomenti.

• Per i nuovi servizi, imposta il comando entrypoint eseguendo il gcloud run deploy comando con il --command parametro:

  gcloud run deploy SERVICE --image=IMAGE_URL --command COMMAND --args ARG1,ARG2,ARG-N

  Sostituisci:

  • SERVICE con il nome del servizio.
  • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
  • (Facoltativo) COMMAND con il comando che vuoi che il container esegua durante l'avvio.
  • (Facoltativo) ARG1 con uno o più argomenti per il comando eseguito durante l'avvio. Utilizza un elenco delimitato da virgole per più argomenti. Come formattare gli argomenti.

YAML

Attenzione: il deployment delle modifiche alla configurazione utilizzando i file YAML sostituisce la configurazione dei servizi esistenti. Poiché un file YAML sovrascrive completamente tutte le configurazioni, devi evitare di utilizzare più metodi per modificare i servizi. Ad esempio, non utilizzare i file YAML insieme ai Google Cloud comandi della console o di gcloud.

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il gcloud run services describe comando utilizzando il --format=export flag. Puoi quindi modificare il file YAML ed eseguire il deployment delle modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

1. Scarica la configurazione del servizio in un file denominato service.yaml nell'area di lavoro locale:

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

   Sostituisci SERVICE con il nome del tuo servizio Knative serving.

2. Nel file locale, aggiorna gli attributi command e args:

   apiVersion: serving.knative.dev/v1
   kind: Service
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
           command:
           - COMMAND
           args:
           - "ARG1"
           - "ARG-N"
   

   Sostituisci:

   • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
   • (Facoltativo) COMMAND con il comando che vuoi che il container esegua durante l'avvio.
   • (Facoltativo) ARG1 con uno o più argomenti per il comando eseguito durante l'avvio. Utilizza un elenco delimitato da virgole per più argomenti.

3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente comando:

   gcloud run services replace service.yaml