Scopri come configurare la porta del container e il comando del punto di ingresso del container e argomenti.
Quando Knative serving avvia un container, esegue lo stato predefinito
comando del punto di ingresso
e gli argomenti dei comandi predefiniti. Se vuoi sostituire le impostazioni predefinite dell'immagine
punto di ingresso e argomenti del comando, puoi utilizzare i campi command
e args
in
la configurazione del container. Il campo command
specifica il comando effettivo
eseguite dal container. Il campo args
specifica gli argomenti passati
.
Configurazione della porta del container
Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive ricevono automaticamente di questa configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Il container deve eseguire le operazioni di ascolto sulla porta definita dall'ambiente PORT
piuttosto che una porta specifica
con hardcoded.
Tuttavia, se questo non è possibile, puoi configurare su quali richieste di porta vengono
inviati al container:
Console
Vai a Knative serving nella console Google Cloud:
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un'istanza servizio esistente, fai clic sul servizio e poi su Modifica e Esegui il deployment della nuova revisione.
In Impostazioni avanzate, fai clic su Contenitore.
Specifica la porta a cui vuoi inviare le richieste, se non è il valore predefinito di
8080
. Questa operazione imposta anche l'ambientePORT
.Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il modo in cui viene attivato questo servizio, seleziona la connettività da utilizzare per richiamare il servizio.
Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi. per completare il deployment.
Riga di comando
Per i servizi esistenti, aggiorna un'impostazione di porta eseguendo
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 il comando
gcloud run deploy
con--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, per
ad esempio
gcr.io/cloudrun/hello
. - PORT con la porta a cui vuoi inviare le richieste. La
La porta predefinita è
8080
.
YAML
Puoi scaricare la configurazione di un servizio esistente in un
YAML con il comando gcloud run services describe
utilizzando
--format=export
.
Puoi quindi modificare il file YAML ed eseguire il deployment
queste modifiche con il comando gcloud run services replace
.
Assicurarsi di modificare solo gli attributi specificati.
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 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 container, per
ad esempio
gcr.io/cloudrun/hello
. - PORT con la porta a cui vuoi inviare le richieste.
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
gcloud run services replace service.yaml
Configurazione del comando e degli argomenti del punto di ingresso del container
Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive ricevono automaticamente di questa configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Quando Knative serving avvia un container, esegue lo stato predefinito
comando del punto di ingresso.
Per specificare o eseguire l'override del comando e degli argomenti del punto di ingresso esistenti che sono
definita nell'immagine container, puoi configurare command
e args
nella configurazione del container Knative serving.
Puoi scegliere di configurare comandi, argomenti o entrambi per il punto di ingresso. Il comando specificato in Knative serving esegue l'override di qualsiasi punto di ingresso definito nell'immagine container. Se scegli di specificare solo argomenti, vengono passati ed eseguiti dal comando entrypoint definita nell'immagine container.
In Knative serving puoi configurare i comandi del punto di ingresso utilizzando la console Google Cloud, Google Cloud CLI o un file YAML quando esegui il deployment di un nuovo servizio, aggiorna esistente o esegui il deployment di una revisione:
Console
Vai a Knative serving nella console Google Cloud:
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un'istanza servizio esistente, fai clic sul servizio e poi su Modifica e Esegui il deployment della nuova revisione.
In Impostazioni avanzate, fai clic su Contenitore.
Specifica il comando e gli argomenti del punto di ingresso da eseguire durante l'avvio.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il modo in cui viene attivato questo servizio, seleziona la connettività da utilizzare per richiamare il servizio.
Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi. per completare il deployment.
Riga di comando
Opzioni dei parametri del comando
-
Per specificare un argomento che contiene una virgola (
,
), devono essere sottoposti a escape per ogniARG
con un delimitatore diverso. Ad esempio, se utilizzi@
:--args "^@^arg,with,commas@anotherarg@ARG3..."
-
Per specificare diversi insiemi di coppie chiave/valore,
è possibile specificare più parametri per la leggibilità. Esempio:
[...] --args "
ARG
1" \ --args "ARG
2" \ --args "ARG
3" -
Per utilizzare i segni di uguale (
=
) negli argomenti, devi specificare ognuno 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 del punto di ingresso 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 che vuoi che del container da eseguire durante l'avvio.
- Facoltativo: ARG1 con uno o più argomenti per il comando che viene eseguito durante l'avvio. Utilizza un elenco delimitato da virgole per più argomenti. Come formattare gli argomenti.
Per i nuovi servizi, imposta il comando del punto di ingresso eseguendo il comando il comando
gcloud run deploy
con--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, per
ad esempio
gcr.io/cloudrun/hello
. - (Facoltativo) COMMAND con il comando che vuoi che del container da eseguire durante l'avvio.
- Facoltativo: ARG1 con uno o più argomenti per il comando che viene 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
YAML con il comando gcloud run services describe
utilizzando
--format=export
.
Puoi quindi modificare il file YAML ed eseguire il deployment
queste modifiche con il comando gcloud run services replace
.
Assicurarsi di modificare solo gli attributi specificati.
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 Knative serving.
Nel file locale, aggiorna gli attributi
command
eargs
: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, per
ad esempio
gcr.io/cloudrun/hello
. - (Facoltativo) COMMAND con il comando che vuoi che del container da eseguire durante l'avvio.
- Facoltativo: ARG1 con uno o più argomenti per il comando che viene eseguito durante l'avvio. Utilizza un elenco delimitato da virgole per più di un argomento.
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
gcloud run services replace service.yaml