Configurazione dei container

Scopri come configurare la porta del container e il comando pointpoint e gli argomenti container.

Quando Cloud Run for Anthos avvia un container, esegue il comando entrypoint predefinito e gli argomenti comando predefiniti dell'immagine. Se vuoi sostituire gli argomenti punto di ingresso e comando predefiniti 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 al comando.

Configurazione della porta del container

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

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

console

  1. Vai a Cloud Run for Anthos in Google Cloud Console:

    Vai a Cloud Run for Anthos

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

  3. In Impostazioni avanzate, fai clic su Container.

    immagine

  4. Specifica la porta a cui vuoi inviare le richieste, se non è il valore predefinito 8080. Imposta anche la variabile di ambiente PORT.

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

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

  7. Fai clic su Crea per eseguire il deployment dell'immagine in Cloud Run for Anthos e attendere il completamento del deployment.

Riga di comando

  • Per i servizi esistenti, aggiorna un'impostazione di porta eseguendo il comando gcloud run services update 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 comando gcloud run deploy con il parametro --port:

    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/myproject/my-image:latest.
    • PORT con la porta a cui vuoi inviare richieste. La porta predefinita è 8080.

YAML

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

  1. Scarica la configurazione del tuo 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 Cloud Run for Anthos.

  2. Nel tuo 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/myproject/my-image:latest.
    • PORT con la porta a cui vuoi inviare richieste.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud beta run services replace service.yaml

Configurazione del comando itempoint e degli argomenti container

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

Quando Cloud Run for Anthos avvia un container, esegue il comando entrypoint predefinito dell'immagine. Per specificare o sostituire il comando pointpoint esistente e gli argomenti definiti nell'immagine container, puoi configurare le impostazioni command e args nella configurazione container di Cloud Run for Anthos.

Puoi scegliere di configurare comandi, argomenti e/o entrambi i punti di ingresso. Il comando specificato in Cloud Run for Anthos esegue l'override di qualsiasi comando del punto di ingresso definito nell'immagine container. Se scegli di specificare solo gli argomenti, tali argomenti vengono passati ed eseguiti dal comandoentrypoint definito nell'immagine container.

In Cloud Run for Anthos, puoi configurare comandi e argomenti pointpoint utilizzando la console Google Cloud, l'interfaccia a riga di comando di Google Cloud o un file YAML quando esegui il deployment di un nuovo servizio, aggiorna un servizio esistente o esegui il deployment di una revisione:

console

  1. Vai a Cloud Run for Anthos in Google Cloud Console:

    Vai a Cloud Run for Anthos

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

  3. In Impostazioni avanzate, fai clic su Container.

    immagine

  4. Specifica il comando pointpoint e gli argomenti che vuoi che vengano eseguiti dal container durante l'avvio.

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

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

  7. Fai clic su Crea per eseguire il deployment dell'immagine in Cloud Run for Anthos e attendere il completamento del deployment.

Riga di comando

Opzioni dei parametri di comando

  • Per specificare un argomento contenente una virgola (,), devi escape ogni ARG con un delimitatore diverso. Ad esempio, se utilizzi @:
    --args "^@^arg,with,commas@anotherarg@ARG3..."
    
  • Per specificare diversi insiemi di coppie chiave-valore, puoi specificare più parametri per la leggibilità. Esempio:
    [...]
    --args "ARG1" \
    --args "ARG2" \
    --args "ARG3"
    
  • Per utilizzare segni di uguale (=) negli argomenti, devi specificare ciascun argomento utilizzando il seguente formato:
    gcloud run services ...  \
      --args "--repo-allowlist=github.com/example/example_demo" \
      --args "--gh-webhook-secret=XX"
    

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

    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 venga eseguito nel container 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 pointpoint eseguendo il comando gcloud run deploy con il parametro --command:

    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/myproject/my-image:latest.
    • Facoltativo: COMMAND con il comando che vuoi che venga eseguito nel container 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

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

  1. Scarica la configurazione del tuo 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 Cloud Run for Anthos.

  2. Nel tuo 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/myproject/my-image:latest.
    • Facoltativo: COMMAND con il comando che vuoi che venga eseguito nel container 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ù di un argomento.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud beta run services replace service.yaml