Questa documentazione riguarda la versione più recente di Knative serving, che utilizza i parchi risorse e Anthos Service Mesh. Scopri di più.

La versione precedente (Cloud Run for Anthos) è stata archiviata, ma la documentazione rimane disponibile per gli utenti esistenti.

Versioni disponibili

Ultimi
Archivia

Questa pagina è stata tradotta dall'API Cloud Translation.

Configurazione dei container

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

Quando Knative Serving avvia un container, esegue il comando entrypoint predefinito e gli argomenti del comando predefiniti dell'immagine. Se vuoi sostituire gli argomenti entrypoint e command predefiniti dell'immagine, puoi utilizzare i campi command e args nella configurazione del container. Il campo command specifica il comando effettivo eseguito dal contenitore. Il campo args specifica gli argomenti passati al comando.

Configurazione della porta del contenitore

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

Il contenitore deve eseguire le operazioni di ascolto sulla porta definita dalla variabile di ambiente PORT anziché su una porta hardcoded specifica. Tuttavia, se non è possibile, puoi configurare su quale porta vengono inviate le richieste al contenitore:

Console

Vai a Erogazione Knative nella console Google Cloud:

Vai a Knative serving
Fai clic su Crea servizio se stai configurando un nuovo servizio di destinazione del deployment. Se stai configurando un servizio esistente, fai clic sul servizio, poi su Modifica ed esegui il deployment di una nuova revisione.
In Impostazioni avanzate, fai clic su Contenitore.
Specifica la porta a cui vuoi che vengano inviate le richieste, se non il valore predefinito 8080. Viene impostata anche la variabile di ambiente PORT.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il funzionamento del trigger per questo servizio, seleziona la connettività che vuoi utilizzare per richiamare il servizio.
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 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 del container, ad esempio gcr.io/cloudrun/hello.
- PORT con la porta a cui vuoi inviare le 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 --format=export flag. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

Scarica la configurazione del servizio in un file denominato service.yaml nello spazio di lavoro locale:
```
gcloud run services describe SERVICE --format export > service.yaml
```
Sostituisci SERVICE con il nome del servizio Knative serving.

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 del container, ad esempio gcr.io/cloudrun/hello.
PORT con la porta a cui vuoi inviare le richieste.

Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Configurazione del comando e degli argomenti dell'entrypoint del contenitore

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

Puoi scegliere di configurare i comandi, gli argomenti o entrambi i punti di contatto. 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 del container.

In Knative Serving, puoi configurare i comandi e gli argomenti dell'entrypoint utilizzando la console Google Cloud, 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 revision:

Console

Vai a Erogazione Knative nella console Google Cloud:

Vai a Knative serving
Fai clic su Crea servizio se stai configurando un nuovo servizio di destinazione del deployment. Se stai configurando un servizio esistente, fai clic sul servizio, poi su Modifica ed esegui il deployment di una nuova revisione.
In Impostazioni avanzate, fai clic su Contenitore.
Specifica il comando e gli argomenti del punto di ingresso che vuoi che il container esegua durante l'avvio.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il funzionamento del trigger per questo servizio, seleziona la connettività che vuoi utilizzare per richiamare il servizio.
Fai clic su Crea per eseguire il deployment dell'immagine in Knative Serving e attendi il completamento del deployment.

Riga di comando

Opzioni del parametro del comando

Per specificare un argomento contenente 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 indicare 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"

Per i servizi esistenti, aggiorna il comando entrypoint eseguendo il comando gcloud run services update 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 da eseguire dal contenuto del contenitore durante l'avvio.
- (Facoltativo) ARG1 con uno o più argomenti per il comando eseguito durante l'avvio. Utilizza un elenco separato da virgole per più argumenti. Come formattare gli argomenti.
Per i nuovi servizi, imposta il comando entrypoint 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 del container, ad esempio gcr.io/cloudrun/hello.
- (Facoltativo) COMMAND con il comando da eseguire dal contenuto del contenitore durante l'avvio.
- (Facoltativo) ARG1 con uno o più argomenti per il comando eseguito durante l'avvio. Utilizza un elenco separato da virgole per più argumenti. Come formattare gli argomenti.

YAML

Scarica la configurazione del servizio in un file denominato service.yaml nello spazio di lavoro locale:
```
gcloud run services describe SERVICE --format export > service.yaml
```
Sostituisci SERVICE con il nome del servizio Knative serving.
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 del container, ad esempio gcr.io/cloudrun/hello.
- (Facoltativo) COMMAND con il comando da eseguire dal contenuto del contenitore 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.
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```