CLI IBM Cloud Code Engine

Esegui questi comandi per gestire le entità che compongono IBM Cloud® Code Engine. Per ulteriori informazioni su Code Engine, vedi Introduzione a Code Engine.

Per eseguire i comandi di IBM Cloud Code Engine, utilizzare ibmcloud code-engine o ibmcloud ce.

Prerequisiti

Installa la CLI IBM Cloud.
Installa la CLI di Code Engine eseguendo il seguente comando:
```
ibmcloud plugin install code-engine
```

Comandi di applicazione

Un'applicazione, o app, esegue il codice per servire le richieste di HTTP. Oltre alle richieste tradizionali di HTTP, IBM Cloud® Code Engine supporta anche le applicazioni che utilizzano WebSockets come protocollo di comunicazione. Il numero di istanze in esecuzione di un'applicazione viene scalato automaticamente verso l'alto o verso il basso (fino a zero) in base alle richieste in arrivo e alle impostazioni di configurazione. Un'applicazione contiene una o più revisioni. Una revisione rappresenta una versione immutabile delle proprietà di configurazione dell'applicazione. Ogni aggiornamento di una proprietà di configurazione dell'applicazione crea una nuova revisione dell'applicazione.

Per utilizzare i comandi di application è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sul lavoro con le applicazioni, vedere Distribuzione delle applicazioni.

È possibile utilizzare application o app nei comandi di application. Per visualizzare la guida CLI per i comandi application, eseguire ibmcloud ce app -h.

Per gestire le revisioni delle applicazioni, vedere i comandi ibmcloud ce revision comandi.

`ibmcloud ce application bind`

Legare un'istanza del servizio IBM Cloud a un'applicazione.

ibmcloud ce application bind --name APP_NAME (--service-instance SI_NAME | --service-instance-id SI_ID)  [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome dell'applicazione da associare. Questo campo è obbligatorio.
--no-wait, --nw: Associa l'istanza del servizio senza attendere che l'associazione del servizio sia pronta. Se si specifica l'opzione no-wait, la creazione del binding del servizio viene avviata e il comando esce senza attendere il completamento. Usare il comando app get per verificare lo stato di bind dell'applicazione. Questo valore è facoltativo. Il valore predefinito è false.
--prefix, -p: Un prefisso per le variabili di ambiente create per questo binding del servizio. Deve contenere solo lettere maiuscole, numeri e trattini bassi (_) e non può iniziare con un numero. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--role, -r: Il nome di un ruolo di servizio per le nuove credenziali di servizio create per questo binding di servizio. I valori validi includono Reader, Writer, Manager o un ruolo specifico del servizio. L'impostazione predefinita è " Manager " oppure il primo ruolo fornito dal servizio, qualora " Manager " non fosse supportato. Questa opzione viene ignorata se viene specificato --service-credential. Questo valore è facoltativo.
--service-credential, --sc: Il nome di una credenziale di servizio esistente da utilizzare per questo binding di servizio. Se non si specifica una credenziale dell'istanza di servizio, le nuove credenziali vengono generate durante l'azione di bind. Questo valore è facoltativo.
--service-instance, --si: Il nome di un'istanza del servizio IBM Cloud esistente da associare all'applicazione. Questo valore è facoltativo.
--service-instance-id, --siid: Il GUID di un'istanza di servizio IBM Cloud esistente da associare all'applicazione. Questo valore è facoltativo.
--wait, -w: Associa l'istanza del servizio e attendi che l'associazione del servizio sia pronta. Se si specifica l'opzione --wait, l'application bind attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'application bind venga completato con successo. Se il binding dell'applicazione non viene completato con successo o fallisce entro il periodo specificato da --wait-timeout, il comando fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché il binding del servizio sia pronto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 300.

Esempio

In questo esempio, si lega l'istanza del servizio IBM Cloud Object Storage, chiamata my-object-storage, all'applicazione myapp.

ibmcloud ce application bind --name myapp --service-instance my-object-storage

Output di esempio

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
Waiting for application revision to become ready...
Traffic is not yet migrated to the latest revision.
Ingress has not yet been reconciled.
Waiting for load balancer to be ready
OK

`ibmcloud ce application create`

Crea un'applicazione.

ibmcloud ce application create --name APP_NAME ((--image IMAGE_REF | (--build-source SOURCE [--image IMAGE_REF])) [--argument ARGUMENT] [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-size BUILD_SIZE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--cluster-local] [--command COMMAND] [--concurrency CONCURRENCY] [--concurrency-target CONCURRENCY_TARGET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--max-scale MAX_SCALE] [--memory MEMORY] [--min-scale MIN_SCALE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-cluster-local] [--no-wait] [--output OUTPUT] [--port PORT] [--probe-live PROBE_LIVE] [--probe-ready PROBE_READY] [--quiet] [--registry-secret REGISTRY_SECRET] [--request-timeout REQUEST_TIMEOUT] [--revision-name REVISION_NAME] [--scale-down-delay SCALE_DOWN_DELAY] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--user USER] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

-n, --name

Il nome dell'applicazione. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare con una lettera minuscola.
Il nome deve terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da un massimo di 63 caratteri e può contenere lettere minuscole, numeri e trattini (-).

Questo campo è obbligatorio.

--argument, --arg, -a: Imposta i parametri dell'applicazione. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore sostituisce i valori predefiniti specificati nell'immagine del contenitore. Questo valore è facoltativo.

--build-commit, --commit, --bcm, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. L'opzione build commit è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo.

--build-context-dir, --context-dir, --bcdr, --cdr

La directory nel repository che contiene il file buildpacks o il Dockerfile. L'opzione della directory del contesto di compilazione è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo.

--build-dockerfile, --dockerfile, --bdf, --df

Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. L'opzione build dockerfile è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo. Il valore predefinito è Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Il nome del segreto SSH, contenente le credenziali per accedere al repository privato che contiene il codice sorgente per creare la propria immagine del contenitore. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questa opzione è consentita solo se l'opzione --build-source è impostata sull'opzione URL di un repository Git. Questo valore è facoltativo.

--build-size, --size, --bsz, --sz

La dimensione della build, che determina la quantità di risorse utilizzate. I valori validi sono small, medium, large, xlarge e xxlarge. Per ulteriori informazioni, vedere Determinazione delle dimensioni della build. L'opzione Dimensione di costruzione è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo. Il valore predefinito è medium.

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-strategy, --strategy, --bstr, --str

La strategia da utilizzare per il build dell'immagine. I valori validi sono dockerfile e buildpacks. L'opzione strategia di compilazione è consentita solo se è impostata l'opzione --build-source. Se non è specificato, la strategia di compilazione è determinata da Code Engine se --build-source è specificato e il sorgente è sulla macchina locale. Questo valore è facoltativo. Il valore predefinito è dockerfile.

--build-timeout, --bto

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. L'opzione build timeout è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo. Il valore predefinito è 600.

--cluster-local, --cl

Distribuire l'applicazione con un endpoint per il progetto. L'impostazione di un endpoint limitato al progetto implica che l'app non sia accessibile da Internet pubblico e che l'accesso alla rete sia possibile solo da altri componenti di Code Engine in esecuzione nello stesso progetto. Questo valore è facoltativo. Il valore predefinito è false.

--command, --cmd, -c

Impostare i comandi per l'applicazione. Specificare un comando per ogni opzione --command ; ad esempio, --cmd cmdA --cmd cmdB. Questo valore sostituisce il comando predefinito specificato nell'immagine del contenitore. Questo valore è facoltativo.

--concurrency, --cn

Il numero massimo di richieste che possono essere elaborate contemporaneamente per ogni istanza. Questo valore è facoltativo. Il valore predefinito è 100.

--concurrency-target, --ct

La soglia di richieste contemporanee per istanza alla quale vengono create una o più istanze aggiuntive. Utilizzare questo valore per scalare le istanze in base al numero di richieste contemporanee. Se --concurrency-target non è specificato, questa opzione assume come valore predefinito quello dell'opzione --concurrency. Questo valore è facoltativo. Il valore predefinito è 0.

--cpu

La quantità di CPU assegnata all'istanza dell'applicazione. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 1.

--env, -e

Impostare le variabili d'ambiente nell'applicazione. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova variabile d'ambiente o sostituisce una variabile d'ambiente esistente. Specificare una variabile d'ambiente per ogni opzione --env ; ad esempio, --env envA=A --env envB=B. Questo valore è facoltativo.

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-sec, --env-from-secret: Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--ephemeral-storage, --es: La quantità di archiviazione effimera da impostare per l'istanza dell'applicazione. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo. Il valore predefinito è 400M.

--force, -f

Non verificare l'esistenza dei riferimenti configmap e secret specificati. I riferimenti alle configmap sono specificati con le opzioni --env-from-configmap o --mount-configmap. I riferimenti segreti sono specificati con le opzioni --env-from-secret, --mount-secret o --registry-secret. Questo valore è facoltativo. Il valore predefinito è false.

--image, -i

Il nome dell'immagine utilizzata per questa applicazione. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove REGISTRY e TAG sono facoltativi. Se non viene specificato REGISTRY, il valore predefinito è docker.io. Se non viene specificato TAG, il valore predefinito è latest. L'opzione "image" è obbligatoria se non viene specificata l'opzione " --build-source ". Questo valore è facoltativo.

--max-scale, --max, --maxscale

Il numero massimo di istanze utilizzabili per questa applicazione. Se si imposta questo valore su " 0", l'applicazione si adatta in base alle esigenze. La scalabilità dell'applicazione è limitata solo dalle istanze per la quota di risorse per il progetto dell'applicazione. Vedere Limiti e quote per Code Engine. Questo valore è facoltativo. Il valore predefinito è 10.

--memory, -m

La quantità di memoria impostata per l'istanza dell'applicazione. Utilizza M per i megabyte o G per i gigabyte. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 4G.

--min-scale, --min, --minscale

Il numero minimo di istanze che possono essere utilizzate per questa applicazione. Questa opzione è utile per garantire che non vengano eseguite istanze non necessarie. Questo valore è facoltativo. Il valore predefinito è 0.

--mount-configmap, --mount-cm

Aggiungere il contenuto di una configmap al file system del contenitore dell'applicazione, fornendo una directory di montaggio e il nome di una configmap, con il formato MOUNT_DIRECTORY=CONFIGMAP_NAME. Ogni configmap montata deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nella configmap, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-configmap ; ad esempio, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Questo valore è facoltativo.

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-secret, --mount-sec

Aggiungere il contenuto di un segreto al file system del contenitore dell'applicazione, fornendo una directory di montaggio e il nome di un segreto, con il formato MOUNT_DIRECTORY=SECRET_NAME. Ogni segreto montato deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nel segreto, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-secret ; ad esempio, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Questo valore è facoltativo.

--no-cluster-local, --ncl

Distribuire l'applicazione con un endpoint pubblico. L'applicazione viene implementata in modo tale da poter ricevere richieste provenienti dalla rete Internet pubblica o da componenti all'interno del progetto Code Engine. Questo valore è facoltativo. Il valore predefinito è true.

--no-wait, --nw

Create l'applicazione e non aspettate che sia pronta. Se si specifica l'opzione --no-wait, la creazione dell'applicazione inizia senza attendere. Utilizzate il comando app get per verificare lo stato dell'applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url e project-url. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.

--port, -p

La porta su cui l'applicazione è in ascolto. Il formato è [NAME:]PORT, dove [NAME:] è facoltativo. Se viene specificato [NAME:], i valori validi sono h2c, o http1. Quando [NAME:] non è specificato o è http1, la porta utilizza HTTP/1.1. Quando [NAME:] è h2c, la porta utilizza HTTP/2 non criptato. Per impostazione predefinita, Code Engine assume che le applicazioni ascoltino le connessioni in entrata sulla porta 8080. Se l'applicazione deve ascoltare su una porta diversa da 8080, usare --port per specificare la porta. Questo valore è facoltativo.

--probe-live, --pl

Configurare il probe di attività per questa applicazione in formato NAME=VALUE. Le opzioni valide per NOME sono: type, port, path, interval, initial-delay, timeout, failure-threshold. Questa opzione può essere specificata più volte. La proprietà type è obbligatoria e i valori validi sono tcp e http. Ad esempio, --probe-live type=tcp --probe-live port=8080. Per ulteriori informazioni sull'utilizzo delle sonde, consultare la sezione Configurazione delle sonde per l'applicazione. Questo valore è facoltativo.

--probe-ready, --pr

Configurare il probe di disponibilità per questa applicazione in formato NAME=VALUE. Le opzioni valide per NOME sono: type, port, path, interval, initial-delay, timeout, failure-threshold. Questa opzione può essere specificata più volte. La proprietà type è obbligatoria e i valori validi sono tcp e http. Ad esempio, --probe-ready type=tcp --probe-ready port=8080. Per ulteriori informazioni sull'utilizzo delle sonde, consultare la sezione Configurazione delle sonde per l'applicazione. Questo valore è facoltativo.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

Il nome del segreto di registro. Il segreto del Registro di sistema viene utilizzato per l'autenticazione con un registro privato quando scarichi l'immagine del contenitore. Questo valore è facoltativo.

--request-timeout, --rt, --timeout, -t

Il tempo in secondi che può trascorrere prima che le richieste fatte all'applicazione vadano a buon fine o falliscano. Questo valore è facoltativo. Il valore predefinito è 300.

--rn, --revision-name

Il nome della revisione. Utilizza un nome che sia univoco all'interno dell'applicazione.

Il nome può contenere lettere minuscole, numeri e trattini (-).
Il nome deve terminare con un carattere alfanumerico minuscolo.
Il nome della revisione completamente qualificata deve essere nel formato Name_of_application-Name of revision.
Il nome della revisione completamente qualificata deve essere di 63 caratteri o meno.

Questo valore è facoltativo.

--scale-down-delay, --sdd: La quantità di tempo, in secondi, che deve trascorrere a simultaneità ridotta prima che l'applicazione venga ridimensionata. L'aumento del numero di richieste contemporanee provoca la scalabilità di un'applicazione. Se il numero di richieste diminuisce (concurrency ridotta), la quantità di tempo specificata per questa opzione determina quanto tempo deve persistere la concurrency ridotta, prima che l'applicazione venga ridimensionata. Per impostazione predefinita, l'applicazione viene ridimensionata immediatamente se viene rilevata una riduzione della concorrenza. Questo valore è facoltativo. Il valore predefinito è 0.

--service-account, --sa

Il nome dell'account del servizio. Un account del servizio fornisce un'identità per i processi che vengono eseguiti in un'istanza. Per gli account di servizio integrati, è possibile utilizzare i nomi abbreviati manager, none, reader e writer. È possibile utilizzare anche i nomi completi preceduti dal prefisso Kubernetes Config Context, che può essere determinato con il comando project current. Questo valore è facoltativo.

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo nel contenitore di questa applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--user, -u

L'ID utente (UID) utilizzato per eseguire l'applicazione. Questo valore sostituisce qualsiasi ID utente impostato nel file Docker dell'applicazione. L'ID deve essere conforme ai requisiti del sistema operativo del contenitore. Questo valore è facoltativo. Il valore predefinito è 0.

--visibility, -v

La visibilità per l'applicazione. I valori validi sono public, private e project. L'impostazione di una visibilità di public significa che l'applicazione può ricevere richieste da Internet pubblico o dai componenti del progetto Code Engine. L'impostazione di una visibilità di private significa che l'applicazione non è accessibile da Internet pubblico e l'accesso alla rete è possibile solo da altri IBM Cloud che utilizzano Endpoint privati virtuali (VPE) o componenti di Code Engine in esecuzione nello stesso progetto. La visibilità può essere “ private ” solo se il progetto supporta la visibilità privata dell’applicazione. Impostando la visibilità su “ project ”, l’app non sarà accessibile da Internet pubblico e l’accesso alla rete sarà possibile solo da altri componenti Code Engine in esecuzione nello stesso progetto. Questo valore è facoltativo.

--wait, -w

Creare l'applicazione e attendere che sia pronta. Se si specifica l'opzione --wait, l'applicazione creata attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'applicazione sia pronta. Se l'applicazione non è pronta entro il periodo specificato da wait-timeout, la creazione dell'applicazione fallisce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché l'applicazione sia pronta. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce application create --name myapp --image icr.io/codeengine/hello

Output di esempio

Creating application 'myapp'...
[...]
Run `ibmcloud ce application get -n 'myapp'` to check the application status.
OK
https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

Quando si esegue il comando ibmcloud ce application get -n 'myapp' per verificare lo stato dell'applicazione, viene visualizzata la pagina URL relativa all'applicazione.

`ibmcloud ce application delete`

Eliminare un'applicazione.

ibmcloud ce application delete --name APPLICATION_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome dell'applicazione. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--no-wait, --nw: Eliminare l'applicazione e non attendere che venga eliminata. Se si specifica l'opzione no-wait, l'eliminazione dell'applicazione inizia senza attendere. Utilizzate il comando app get per verificare lo stato dell'applicazione. Questo valore è facoltativo. Il valore predefinito è true.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Elimina l'applicazione e attendi che venga eliminata. Se si specifica l'opzione --wait, l'eliminazione dell'applicazione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'applicazione venga eliminata. Se l'applicazione non viene eliminata entro il periodo specificato da --wait-timeout, l'eliminazione dell'applicazione non riesce. Questo valore è facoltativo. Il valore predefinito è false.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere prima che l'applicazione venga eliminata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce application delete --name myapp -f

Output di esempio

Deleted application 'myapp'

`ibmcloud ce application events`

Visualizzare gli eventi di sistema delle istanze dell'applicazione. Gli eventi di sistema vengono conservati fino a 60 minuti.

ibmcloud ce application events (--instance APP_INSTANCE | --application APP_NAME) [--output OUTPUT] [--quiet]

Opzioni di comando

--application, --app, -a, --name, -n: Visualizza gli eventi di tutte le istanze dell'applicazione specificata. Questo valore è necessario se --instance non è specificato.
--instance, -i: Il nome di un'istanza di applicazione specifica. Usare il comando app get per trovare il nome dell'istanza. Questo valore è necessario se --application non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente visualizza le informazioni sugli eventi di sistema per tutte le istanze di un'applicazione specificata.

ibmcloud ce application events --application myapp

Output di esempio

Getting events for all instances of application 'myapp'...
OK
myapp-atfte-1-deployment-6b49c5fb85-kf4m2:
    Type    Reason     Age  Source                Messages
    Normal  Scheduled  31s  default-scheduler     Successfully assigned 4svg40kna19/myapp-atfte-1-deployment-6b49c5fb85-kf4m2 to 10.240.0.15
    Normal  Pulling    29s  kubelet, 10.240.0.15  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal  Pulled     24s  kubelet, 10.240.0.15  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6" in 4.907426108s
    Normal  Created    24s  kubelet, 10.240.0.15  Created container user-container
    Normal  Started    24s  kubelet, 10.240.0.15  Started container user-container
    Normal  Pulled     24s  kubelet, 10.240.0.15  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.20.0-rc1@sha256:8988bea781130827b3e1006e6e5e7f49094343a5505c1927bb832be3470455f6" already present on machine
    Normal  Created    23s  kubelet, 10.240.0.15  Created container queue-proxy
    Normal  Started    23s  kubelet, 10.240.0.15  Started container queue-proxy

Esempio di informazioni sugli eventi di sistema per un'istanza specifica di un'applicazione

L'esempio seguente visualizza le informazioni sugli eventi di sistema per un'istanza specificata di un'applicazione. Utilizzare il comando app get per visualizzare i dettagli dell'applicazione, comprese le istanze in esecuzione dell'applicazione.

ibmcloud ce application events --instance myapp-li17x-1-deployment-69fd57bcb6-sr9tl

Esempio di output delle informazioni sugli eventi di sistema per l'istanza specificata di un'applicazione

Getting events for application instance 'myapp-li17x-1-deployment-69fd57bcb6-sr9tl'...
OK
myapp-li17x-1-deployment-69fd57bcb6-sr9tl:
    Type     Reason     Age                    Source                Messages
    Normal   Scheduled  6m40s                  default-scheduler     Successfully assigned 4svg40kna19/myapp-li17x-1-deployment-69fd57bcb6-sr9tl to 10.240.64.6
    Normal   Pulling    6m39s                  kubelet, 10.240.64.6  Pulling image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Pulled     6m36s                  kubelet, 10.240.64.6  Successfully pulled image "icr.io/codeengine/hello@sha256:f0dc03250736a7b40a66ee70fee94fc470e08c864197aa2140054fee6ca9f9d6"
    Normal   Created    6m34s                  kubelet, 10.240.64.6  Created container user-container
    Normal   Started    6m33s                  kubelet, 10.240.64.6  Started container user-container
    Normal   Pulled     6m33s                  kubelet, 10.240.64.6  Container image "icr.io/obs/codeengine/knative-serving/queue-39be6f1d08a095bd076a71d288d295b6:v0.19.0-rc3@sha256:9cb525af53896afa6b5210b5ac56a893cf85b6cd013a61cb6503a005e40c5c6f" already present on machine
    Normal   Created    6m33s                  kubelet, 10.240.64.6  Created container queue-proxy
    Normal   Started    6m32s                  kubelet, 10.240.64.6  Started container queue-proxy
    [...]

`ibmcloud ce application get`

Visualizza i dettagli di un'applicazione.

ibmcloud ce application get --name APPLICATION_NAME [--output OUTPUT] [--quiet] [--show-all-revisions]

Opzioni di comando

--name, -n: Il nome dell'applicazione. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url e project-url. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--show-all-revisions, -r: Mostra tutte le revisioni per questa applicazione. Se non viene specificato, vengono mostrate solo le revisioni configurate per ricevere traffico. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce application get --name myapp

Output di esempio

Run 'ibmcloud ce application events -n myapp' to get the system events of the application instances.
Run 'ibmcloud ce application logs -f -n myapp' to follow the logs of the application instances.
OK
Name:          myapp
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:                31m
Created:            2021-09-09T14:01:02-04:00
URL:                https://myapp.abcdabcdabc.us-south.codeengine.appdomain.cloud
Cluster Local URL:  http://myapp.abcdabcdabc.svc.cluster.local
Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
Status Summary:     Application deployed successfully  
Environment Variables:    
  Type     Name             Value  
  Literal  CE_API_BASE_URL  https://api.private.us-south.codeengine.cloud.ibm.com
  Literal  CE_APP           myapp  
  Literal  CE_DOMAIN        us-south.codeengine.appdomain.cloud  
  Literal  CE_PROJECT_ID    abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
  Literal  CE_REGION        us-south  
  Literal  CE_SUBDOMAIN     abcdabcdab  
Image:                  icr.io/codeengine/helloworld  
Resource Allocation:      
  CPU:                1  
  Ephemeral Storage:  400M  
  Memory:             4G  
Revisions:     
  myapp-00001:    
    Age:                42s  
    Latest:             true  
    Traffic:            100%  
    Image:              icr.io/codeengine/helloworld (pinned to 1cee99)  
    Running Instances:  1  
Runtime:       
  Concurrency:       100  
  Maximum Scale:     10  
  Minimum Scale:     0  
  Scale Down Delay:  0  
  Timeout:           300  
Conditions:    
  Type                 OK    Age  Reason  
  ConfigurationsReady  true  25s    
  Ready                true  12s    
  RoutesReady          true  12s    
Events:        
  Type    Reason   Age  Source              Messages  
  Normal  Created  44s  service-controller  Created Configuration "myapp"  
  Normal  Created  43s  service-controller  Created Route "myapp"  
Instances:     
  Name                                    Revision     Running  Status   Restarts  Age  
  myapp-00001-deployment-d59b87654-xkqh7  myapp-00001  3/3      Running  0         43s

`ibmcloud ce application list`

Elenca tutte le applicazioni presenti in un progetto.

ibmcloud ce application list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce app list --sort-by age

Output di esempio

Listing all applications...
OK
Name           Status  URL                                                                    Latest                 Age   Conditions  Reason
myapptestapp2  Ready   https://myapptestapp2.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp2-emy0q-1  52s   3 OK / 3
myapptestapp1  Ready   https://myapptestapp1.4svg40kna19.us-south.codeengine.appdomain.cloud  myapptestapp1-ps4ca-1  104s  3 OK / 3
myapp-e        Ready   https://myapp-e.4svg40kna19.us-south.codeengine.appdomain.cloud        myapp-e-gx6xa-1        12m   3 OK / 3
myappd         Ready   https://myappd.4svg40kna19.us-south.codeengine.appdomain.cloud         myappd-lxjxm-1         13m   3 OK / 3
myappc         Ready   https://myappc.4svg40kna19.us-south.codeengine.appdomain.cloud         myappc-qffan-1         14m   3 OK / 3
myappb         Ready   https://myappb.4svg40kna19.us-south.codeengine.appdomain.cloud         myappb-i3hw3-1         15m   3 OK / 3
myapp          Ready   https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud          myapp-jmxwd-1          17m   3 OK / 3

`ibmcloud ce application logs`

Visualizza i log delle istanze dell'applicazione.

ibmcloud ce application logs (--instance APP_INSTANCE | --application APP_NAME) [--all-containers] [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

Opzioni di comando

--all-containers, --all: Visualizza i registri di tutti i contenitori delle istanze di applicazione specificate. Questo valore è facoltativo. Il valore predefinito è false.
--application, --app, -a, --name, -n: Visualizza i log di tutte le istanze dell'applicazione specificata. Questo valore è necessario se --instance non è specificato.
--follow, -f: Seguire i log delle istanze applicative. Utilizzare questa opzione per trasmettere i log delle istanze dell'applicazione. Se si specifica l'opzione --follow, è necessario immettere Ctrl+C per terminare questo comando di log. Questo valore è facoltativo. Il valore predefinito è false.
--instance, -i: Il nome di un'istanza di applicazione specifica. Usare il comando app get per trovare il nome dell'istanza. Questo valore è necessario se --application non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--raw, -r: Visualizza i registri senza le etichette delle istanze e dei contenitori. Questo valore è facoltativo. Il valore predefinito è false.
--tail, -t: Limita la visualizzazione dei registri dei contenitori delle istanze applicative specificate a un numero massimo di righe recenti per contenitore. Ad esempio, per visualizzare le ultime 3 righe dei log dei contenitori delle istanze applicative specificate, specificare --tail 3. Se questa opzione non viene specificata, vengono visualizzate tutte le righe dei registri dei contenitori delle istanze applicative specificate. Questo valore è facoltativo. Il valore predefinito è -1.
--timestamps, --ts: Includere i timestamp in ogni riga dell'output del log. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente visualizza i registri di un'istanza specifica di un'applicazione. Utilizzare il comando app get per ottenere il nome delle istanze dell'applicazione.

ibmcloud ce application logs --instance myapp-zhk9x-1-deployment-6f955f5cc5-abcde

Output di esempio

Getting logs for application instance 'myapp-zhk9x-1-deployment-6f955f5cc5-abcde'...
OK
myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

Esempio di log di tutte le istanze di un'applicazione

L'esempio seguente visualizza i log di tutte le istanze di un'applicazione.

ibmcloud ce application logs --app myapp

Esempio di output dei log di tutte le istanze di un'applicazione

Getting application 'myapp'...
Getting revisions for application 'myapp'...
Getting instances for application 'myapp'...
Getting logs for all instances of application 'myapp'...
OK
myapp-zhk9x-1-deployment-6f955f5cc5-abcde:
Server running at http://0.0.0.0:8080/

`ibmcloud ce application restart`

Riavviare le istanze dell'applicazione in esecuzione.

ibmcloud ce application restart (--instance APP_INSTANCE | --application APP_NAME) [--quiet]

Opzioni di comando

--application, --app, -a, --name, -n: Riavviare tutte le istanze dell'applicazione specificata in esecuzione. Questo valore è necessario se --instance non è specificato.
--instance, -i: Il nome di un'istanza di applicazione specifica. Usare il comando app get per trovare il nome dell'istanza. Questo valore è necessario se --application non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce application restart --name myapp

Output di esempio

Restarting all running instances of application 'myapp'...
OK

`ibmcloud ce application unbind`

Scollega le istanze del servizio IBM Cloud da un'applicazione.

ibmcloud ce application unbind --name APP_NAME (--binding BINDING_NAME | --all) [--quiet]

Opzioni di comando

--name, -n: Il nome dell'applicazione di cui si desidera annullare l'associazione. Questo campo è obbligatorio.
--all, -A: Rimuove il collegamento di tutte le istanze di servizio relative a questa applicazione. Questo valore è necessario se --binding non è specificato. Il valore predefinito è false.
--binding, -b: Il nome del collegamento da rimuovere. Esegui il comando ibmcloud ce app get -n APP_NAME per visualizzare i nomi dei binding. Questo valore è necessario se --all non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

In questo esempio, rimuovere tutti i binding dall'applicazione chiamata myapp.

ibmcloud ce application unbind --name myapp --all

Output di esempio

Removing service bindings...
OK

`ibmcloud ce application update`

Aggiornare un'applicazione. L'aggiornamento dell'applicazione crea una revisione. Quando vengono effettuate chiamate all'applicazione, il traffico viene indirizzato alla revisione.

ibmcloud ce application update --name APP_NAME [--argument ARGUMENT] [--arguments-clear] [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-size BUILD_SIZE] [--build-source BUILD_SOURCE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--cluster-local] [--command COMMAND] [--commands-clear] [--concurrency CONCURRENCY] [--concurrency-target CONCURRENCY_TARGET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--image IMAGE] [--max-scale MAX_SCALE] [--memory MEMORY] [--min-scale MIN_SCALE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--no-cluster-local] [--no-wait] [--output OUTPUT] [--port PORT] [--probe-live PROBE_LIVE] [--probe-live-clear] [--probe-ready PROBE_READY] [--probe-ready-reset] [--quiet] [--rebuild] [--registry-secret REGISTRY_SECRET] [--registry-secret-clear] [--request-timeout REQUEST_TIMEOUT] [--revision-name REVISION_NAME] [--scale-down-delay SCALE_DOWN_DELAY] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--user USER] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n

Il nome dell'applicazione. Questo campo è obbligatorio.

--argument, --arg, -a

Imposta i parametri dell'applicazione. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore è facoltativo.

--arguments-clear, --ac

Cancella gli argomenti dell'applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--build-clear, --bc

Rimuovere l'associazione di una build da questa applicazione. L'opzione di cancellazione della build è consentita solo se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-commit, --commit, --bcm, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. L'opzione build commit è consentita solo se l'opzione --build-source è impostata su URL di un repository Git su questo comando app update o se l'applicazione ha attualmente una build associata da una fonte di repository Git. Questo valore è facoltativo.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Cancellare il commit, il tag o il ramo nel repository di origine di cui eseguire il pull. L'opzione commit clear è consentita se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-context-dir, --context-dir, --bcdr, --cdr

La directory nel repository che contiene il file buildpacks o il Dockerfile. L'opzione della directory del contesto di compilazione è consentita se l'opzione --build-source è impostata su questo comando app update o se l'applicazione ha attualmente una compilazione associata. Questo valore è facoltativo.

--build-dockerfile, --dockerfile, --bdf, --df

Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. L'opzione build dockerfile è consentita solo se l'opzione --build-source è impostata su questo comando app update o se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Il nome del segreto SSH, contenente le credenziali per accedere al repository privato che contiene il codice sorgente per creare la propria immagine del contenitore. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questa opzione è consentita solo se l'opzione --build-source è impostata su URL di un repository Git su questo comando application update o se l'applicazione ha attualmente una compilazione associata da una fonte di repository Git. Questo valore è facoltativo.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Cancella il segreto SSH. Questa opzione è consentita se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-size, --size, --bsz, --sz

La dimensione della build, che determina la quantità di risorse utilizzate. I valori validi sono small, medium, large, xlarge e xxlarge. Per ulteriori informazioni, vedere Determinazione delle dimensioni della build. L'opzione di dimensione della build è consentita solo se l'opzione --build-source è impostata su questo comando app update o se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è medium.

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-strategy, --strategy, --bstr, --str

La strategia da utilizzare per il build dell'immagine. I valori validi sono dockerfile e buildpacks. L'opzione strategia di compilazione è consentita solo se l'opzione --build-source è impostata su questo comando app update o se l'applicazione ha attualmente una compilazione associata. Se non è specificato, la strategia di compilazione è determinata da Code Engine se --build-source è specificato e il sorgente è sulla macchina locale. Questo valore è facoltativo. Il valore predefinito è dockerfile.

--build-timeout, --bto

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. L'opzione di timeout della compilazione è consentita solo se l'opzione --build-source è impostata su questo comando app update o se l'applicazione ha una compilazione associata. Questo valore è facoltativo. Il valore predefinito è 600.

--cluster-local, --cl

--command, --cmd, -c

--commands-clear, --cc

Cancella i comandi dell'applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--concurrency, --cn

Il numero massimo di richieste che possono essere elaborate contemporaneamente per ogni istanza. Questo valore è facoltativo. Il valore predefinito è 0.

--concurrency-target, --ct

--cpu

La quantità di CPU assegnata all'istanza dell'applicazione. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 0.

--env, -e

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-from-configmap-rm, --env-cm-rm: Rimuove i riferimenti delle variabili d'ambiente alle configmap complete usando il nome della configmap. Per rimuovere i riferimenti a singole chiavi delle configmap, usare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-sec, --env-from-secret

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--env-from-secret-rm, --env-sec-rm: Rimuovere i riferimenti delle variabili d'ambiente ai segreti completi utilizzando il nome del segreto. Per rimuovere i riferimenti a singole chiavi di segreti, utilizzare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-rm

Rimuove i riferimenti di variabile d'ambiente alla chiave di una coppia chiave-valore in una mappa di configurazione o in un segreto. Per rimuovere singoli riferimenti a chiavi e valori letterali, specificare il nome della chiave. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--ephemeral-storage, --es

La quantità di archiviazione effimera da impostare per l'istanza dell'applicazione. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo.

--force, -f

--image, -i

--max-scale, --max, --maxscale

--memory, -m

--min-scale, --min, --minscale

Il numero minimo di istanze che possono essere utilizzate per questa applicazione. Questo valore è facoltativo. Il valore predefinito è 0.

--mount-configmap, --mount-cm

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-rm

Rimuovere il contenuto di una configmap o di un secret dal file system del contenitore dell'applicazione, specificando la directory in cui la configmap o il secret sono montati. Specificare una directory di montaggio per ogni opzione --mount-rm ; ad esempio, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Questo valore è facoltativo.

--mount-secret, --mount-sec

--no-cluster-local, --ncl

--no-wait, --nw

Aggiornate la domanda e non aspettate che sia pronta. Se si specifica l'opzione no-wait, l'aggiornamento dell'applicazione inizia e non attende. Utilizzate il comando app get per verificare lo stato dell'applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--port, -p

--probe-live, --pl

--probe-live-clear, --plr

Rimuovere il probe di attività. Questa opzione è consentita solo se l'applicazione dispone attualmente di una sonda di vivacità. Questo valore è facoltativo. Il valore predefinito è false.

--probe-ready, --pr

--probe-ready-reset, --prr

Reimposta il probe di disponibilità sulla configurazione predefinita. Questo valore è facoltativo. Il valore predefinito è false.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--rebuild

Creare nuovamente l'immagine dall'origine. L'opzione di ricostruzione è consentita se l'applicazione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

--registry-secret-clear, --rsc

Cancella il segreto del registro. Questo valore è facoltativo. Il valore predefinito è false.

--request-timeout, --rt, --timeout, -t

Il tempo in secondi che può trascorrere prima che le richieste fatte all'applicazione vadano a buon fine o falliscano. Questo valore è facoltativo. Il valore predefinito è 0.

--rn, --revision-name

Il nome della revisione. Utilizza un nome che sia univoco all'interno dell'applicazione.

Il nome può contenere lettere minuscole, numeri e trattini (-).
Il nome deve terminare con un carattere alfanumerico minuscolo.
Il nome della revisione completamente qualificata deve essere nel formato Name_of_application-Name of revision.
Il nome della revisione completamente qualificata deve essere di 63 caratteri o meno.

Questo valore è facoltativo.

--scale-down-delay, --sdd: La quantità di tempo, in secondi, che deve trascorrere a simultaneità ridotta prima che l'applicazione venga ridimensionata. L'aumento del numero di richieste contemporanee provoca la scalabilità di un'applicazione. Se il numero di richieste diminuisce (concurrency ridotta), la quantità di tempo specificata per questa opzione determina quanto tempo deve persistere la concurrency ridotta, prima che l'applicazione venga ridimensionata. Per impostazione predefinita, l'applicazione viene ridimensionata immediatamente se viene rilevata una riduzione della concorrenza. Questo valore è facoltativo. Il valore predefinito è 0.

--service-account, --sa

--service-account-clear, --sac

Cancellare l'account di servizio. Questo valore è facoltativo. Il valore predefinito è false.

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo nel contenitore di questa applicazione. Questo valore è facoltativo. Il valore predefinito è false.

--user, -u

--visibility, -v

--wait, -w

Aggiornare l'applicazione e attendere che sia pronta. Se si specifica l'opzione --wait, l'aggiornamento dell'applicazione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'applicazione sia pronta. Se l'applicazione non è pronta entro il periodo specificato da --wait-timeout, la creazione dell'applicazione fallisce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché l'applicazione venga aggiornata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce application update --name myapp --image icr.io/codeengine/hello

Output di esempio

Updating application 'myapp' to latest revision.
[...]
Run 'ibmcloud ce application get -n myapp' to check the application status.
OK
https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

Comando beta

Code Engine i comandi beta non sono generalmente disponibili. Questo gruppo di comando fornisce l'accesso a potenziali funzioni future, che possono essere facilmente esplorate da alcuni utenti selezionati.

Per utilizzare i comandi di beta è necessario trovarsi nel contesto di un progetto.

Per visualizzare la guida CLI per i comandi beta, eseguire ibmcloud ce beta -h.

`ibmcloud ce beta`

Per utilizzare i comandi di beta è necessario trovarsi nel contesto di un progetto.

Per visualizzare la guida CLI per i comandi beta, eseguire ibmcloud ce beta -h.

ibmcloud ce beta COMMAND

Esempio

ibmcloud ce beta help

Output di esempio

NAME:
  ibmcloud code-engine beta - Beta Code Engine commands
USAGE:
  ibmcloud code-engine beta command [arguments...] [command options]
COMMANDS:
  help, h   Show help
Enter 'ibmcloud code-engine beta help [command]' for more information about a command.

Comandi di costruzione

Una compilazione, o compilazione dell'immagine, è un meccanismo che si può usare per creare un'immagine del contenitore dal codice sorgente. Code Engine supporta la compilazione da un file Docker e Cloud Native Buildpacks. Usare i comandi di build per creare, visualizzare i dettagli, aggiornare ed eliminare le configurazioni di build. Dopo aver creato una configurazione di compilazione, è possibile inviare uno o più comandi buildrun in base alla configurazione di compilazione.

Per utilizzare i comandi di build è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le build, vedere Creazione di un'immagine del contenitore.

È possibile utilizzare build o bd nei comandi di build. Per visualizzare la guida CLI per i comandi build, eseguire ibmcloud ce build -h.

`ibmcloud ce build create`

Creare una build.

ibmcloud ce build create --name BUILD_NAME [--build-type BUILD_TYPE] [--commit COMMIT] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--force] [--git-repo-secret GIT_REPO_SECRET] [--image IMAGE] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--source SOURCE] [--strategy STRATEGY] [--timeout TIMEOUT]

Opzioni di comando

-n, --name

Il nome della struttura. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 63 caratteri o meno e può contenere caratteri alfanumerici minuscoli e trattini (-).

Questo campo è obbligatorio.

--build-type, --bt: Il tipo di build. I valori validi sono git e local. Se il tipo di build è local, le opzioni --source, --commit e --git-repo-secret non sono valide. Questo valore è facoltativo. Il valore predefinito è git.

--commit, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. L'opzione commit è consentita se l'opzione --build-type è git e non è consentita se l'opzione --build-type è local. Questo valore è facoltativo.

--context-dir, --cdr

La directory nel repository che contiene il file buildpacks o il Dockerfile. Questo valore è facoltativo.

--dockerfile, --df

Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. Questo valore è facoltativo. Il valore predefinito è Dockerfile.

--force, -f

Non verificare l'esistenza dei riferimenti segreti specificati. I riferimenti segreti sono specificati con le opzioni --get-repo-secret o --registry-secret. Questo valore è facoltativo. Il valore predefinito è false.

--git-repo-secret, --grs, --repo, -r

Il nome del segreto SSH, contenente le credenziali per accedere al repository privato che contiene il codice sorgente per creare la propria immagine del contenitore. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questa opzione è consentita se l'opzione --build-type è git e non è consentita se l'opzione --build-type è local. Questo valore è facoltativo.

--image, -i

L'ubicazione del registro immagini. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove TAG è facoltativo. Se non viene specificato TAG, il valore predefinito è latest. Questo valore è facoltativo.

--output, -o

Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

Il segreto del registro utilizzato per accedere al registro. È possibile aggiungere il segreto di registro eseguendo il comando registry create. Questo valore è facoltativo.

--size, --sz

--source, --src

URL del repository Git che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine. L'opzione sorgente è necessaria se l'opzione --build-type è git e non è consentita se l'opzione --build-type è local. Questo valore è facoltativo.

--strategy, --str

--timeout, --to

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. Questo valore è facoltativo. Il valore predefinito è 600.

Esempio

L'esempio seguente crea un file di configurazione di build chiamato helloworld-build da un file Docker sorgente, che si trova in https://github.com/IBM/CodeEngine all'interno della directory hello nel ramo main, con dockerfile strategia e medium dimensione. Quando questa compilazione viene inviata, l'immagine del contenitore che è stata costruita è memorizzata in un'istanza di Container Registry a us.icr.io/mynamespace/codeengine-helloworld, a cui si accede usando un segreto del registro delle immagini chiamato myregistry.

ibmcloud ce build create --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --strategy dockerfile --size medium --image us.icr.io/mynamespace/codeengine-helloworld --registry-secret myregistry

Output di esempio

Creating build helloworld-build...
OK

`ibmcloud ce build delete`

Cancellare una build.

ibmcloud ce build delete --name BUILD_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome della struttura. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce build delete --name helloworld-build

Output di esempio

Are you sure you want to delete build helloworld-build? [y/N]> y
Deleting build 'helloworld-build'...
OK

`ibmcloud ce build get`

Visualizza i dettagli di una build.

ibmcloud ce build get --name BUILD_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome della struttura. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce build get --name helloworld-build

Output di esempio

Getting build 'helloworld-build'
OK
Name:          helloworld-build
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           15s
Created:       2021-03-14T14:48:19-05:00  
Status:        Succeeded
Reason:        all validations succeeded
Last Build Run:
  Name:     helloworld-build-run
  Age:      39d
  Created:  2021-09-30T15:19:33-04:00
Image:              us.icr.io/mynamespace/codeengine-helloworld
Registry Secret:    myregistry
Build Strategy:     dockerfile-medium
Timeout:            10m0s
Source:             https://github.com/IBM/CodeEngine
Commit:             main
Context Directory:  /hello
Dockerfile:         Dockerfile
Build Runs:
  Name                  Status                              Image                                        Age
  helloworld-build-run  All Steps have completed executing  us.icr.io/mynamespace/codeengine-helloworld  39d

`ibmcloud ce build list`

Elenca tutte le build presenti in un progetto.

ibmcloud ce build list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce build list

Output di esempio

Listing builds...
OK
Name                    Status     Reason                     Image                                               Build Strategy     Age    Last Build Run Name                        Last Build Run Age
myhellobuild           Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-200      dockerfile-medium  160d   myhellobuild-run-4xdnb                    160d
hello-build-5ckgs      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-51       dockerfile-medium  39d    helloapp3-build-5ckgs-run-210803-2129500   39d
hello-build-pmg6v      Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-codeengine-4f       dockerfile-medium  40d    hellooapp2-build-pmg6v-run-210802-2112310  40d
helloworld-build       Succeeded  all validations succeeded  us.icr.io/mynamespace/codeengine-helloworld          dockerfile-medium  39d    helloworld-build-run                       39d

`ibmcloud ce build update`

Aggiornare una build.

ibmcloud ce build update --name BUILD_NAME [--commit COMMIT] [--commit-clear] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--force] [--git-repo-secret GIT_REPO_SECRET] [--git-repo-secret-clear] [--image IMAGE] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--source SOURCE] [--strategy STRATEGY] [--timeout TIMEOUT]

Opzioni di comando

--name, -n: Il nome della struttura. Questo campo è obbligatorio.
--commit, --cm, --revision: Il commit, tag o ramo nel repository di origine di cui eseguire il pull. Questo valore è facoltativo.
--commit-clear, --cmc: Cancellare il commit, il tag o il ramo nel repository di origine di cui eseguire il pull. Questo valore è facoltativo. Il valore predefinito è false.
--context-dir, --cdr: La directory nel repository che contiene il file buildpacks o il Dockerfile. Questo valore è facoltativo.
--dockerfile, --df: Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. Questo valore è facoltativo. Il valore predefinito è Dockerfile.
--force, -f: Non verificare l'esistenza dei riferimenti segreti specificati. I riferimenti segreti sono specificati con le opzioni --get-repo-secret o --registry-secret. Questo valore è facoltativo. Il valore predefinito è false.
--git-repo-secret, --grs, --repo, -r: Il nome del segreto SSH, contenente le credenziali per accedere al repository privato che contiene il codice sorgente per creare la propria immagine del contenitore. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questo valore è facoltativo.
--git-repo-secret-clear, --grsc: Cancella il segreto SSH. Questo valore è facoltativo. Il valore predefinito è false.
--image, -i: L'ubicazione del registro immagini. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove TAG è facoltativo. Se non viene specificato TAG, il valore predefinito è latest. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--registry-secret, --rs: Il nome del segreto di registro. Il segreto del Registro di sistema viene utilizzato per l'autenticazione con un registro privato quando scarichi l'immagine del contenitore. Questo valore è facoltativo.
--size, --sz: La dimensione della build, che determina la quantità di risorse utilizzate. I valori validi sono small, medium, large, xlarge e xxlarge. Per ulteriori informazioni, vedere Determinazione delle dimensioni della build. Questo valore è facoltativo.
--source, --src: URL del repository Git che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine. Questo valore è facoltativo.
--strategy, --str: La strategia da utilizzare per il build dell'immagine. Per le candidature e le offerte di lavoro, i valori validi sono dockerfile e buildpacks. Per le funzioni, i valori validi hanno il formato codebundle-[RUNTIME-ID]. Per esempio, se si vuole costruire un bundle di codice per la propria funzione con l'ID del runtime nodejs-24, usare codebundle-nodejs-24 come strategia di compilazione. È possibile trovare l'ID di qualsiasi runtime di funzioni supportato eseguendo il comando ibmcloud ce fn runtimes. Questo valore è facoltativo.
--timeout, --to: La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. Questo valore è facoltativo. Il valore predefinito è 600.

Esempio

ibmcloud ce build update --name helloworld-build --source https://github.com/IBM/CodeEngine  --context-dir /hello --commit main --timeout 900

Output di esempio

Updating build helloworld-build...
OK

Comandi di esecuzione

Per utilizzare i comandi di buildrun è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le build e le esecuzioni di build, vedere Creazione di un'immagine del contenitore.

È possibile utilizzare buildrun o br nei comandi di buildrun. Per visualizzare la guida CLI per i comandi buildrun, eseguire ibmcloud ce br -h.

`ibmcloud ce buildrun cancel`

Annullare una esecuzione di build.

ibmcloud ce buildrun cancel --name BUILDRUN_NAME [--quiet]

Opzioni di comando

--name, -n: Il nome dell'esecuzione di build. Questo campo è obbligatorio.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce buildrun cancel --name mybuildrun

Output di esempio

Canceling build run 'mybuildrun'...
OK

`ibmcloud ce buildrun delete`

Cancellare un'esecuzione di compilazione.

ibmcloud ce buildrun delete (--name BUILDRUN_NAME | --build BUILD_NAME) [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--build, -b: Usare questa opzione per eliminare tutte le esecuzioni della build specificata. L'opzione --build è necessaria se non si specifica il valore --name. Questo valore è facoltativo.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--name, -n: Il nome dell'esecuzione di build. L'opzione --name è necessaria se non si specifica il valore --build. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce buildrun delete --name mybuildrun

Output di esempio

Are you sure you want to delete build run mybuildrun? [y/N]> y
Deleting build run 'mybuildrun'...
OK

`ibmcloud ce buildrun events`

Visualizzare gli eventi di sistema di una esecuzione di build. Gli eventi di sistema vengono conservati fino a 60 minuti.

ibmcloud ce buildrun events --buildrun BUILDRUN_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--buildrun, -b, --br, --name, -n: Il nome dell'esecuzione di build. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

Questo esempio visualizza le informazioni sugli eventi di sistema per un'esecuzione di build.

ibmcloud ce buildrun events --buildrun mybuildrun

Output di esempio

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting events for build run 'mybuildrun'...
OK
mybuildrun-l4mr2-pod-89z4t:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  33s  default-scheduler       Successfully assigned 4svg40kna19/mybuildrun-l4mr2-pod-89z4t to 10.240.128.97
    Normal  Pulled     31s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    31s  kubelet, 10.240.128.97  Created container working-dir-initializer
    Normal  Started    31s  kubelet, 10.240.128.97  Started container working-dir-initializer
    Normal  Pulled     30s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/entrypoint-bff0a22da108bc2f16c818c97641a296:v0.20.1-rc2@sha256:19ec0672b5e84a4c5939c6ece6fa69efbce0d38479baf35ce894cf1c67f7e435" already present on machine
    Normal  Created    30s  kubelet, 10.240.128.97  Created container place-tools
    Normal  Started    29s  kubelet, 10.240.128.97  Started container place-tools
    Normal  Pulled     28s  kubelet, 10.240.128.97  Container image "gcr.io/distroless/base@sha256:92720b2305d7315b5426aec19f8651e9e04222991f877cae71f40b3141d2f07e" already present on machine
    Normal  Created    28s  kubelet, 10.240.128.97  Created container step-create-dir-image-l7lf2
    Normal  Created    25s  kubelet, 10.240.128.97  Created container step-git-source-source-46fm7
    Normal  Pulled     25s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/git-init-4874978a9786b6625dd8b6ef2a21aa70:v0.20.1-rc2@sha256:5febfb32459a114b7beafdc593770a0f692a09d874ac6b59ce85507844641cdf" already present on machine
    Normal  Started    25s  kubelet, 10.240.128.97  Started container step-create-dir-image-l7lf2
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-git-source-source-46fm7
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/kaniko/executor:v1.3.0-rc1" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-build-and-push
    Normal  Started    24s  kubelet, 10.240.128.97  Started container step-build-and-push
    Normal  Pulled     24s  kubelet, 10.240.128.97  Container image "icr.io/obs/codeengine/tekton-pipeline/imagedigestexporter-6e7c518e6125f31761ebe0b96cc63971:v0.20.1-rc2@sha256:21b3120ce9b930b4eb1359eb20a3109e3a6643e9d2777ef9694efb033367e57c" already present on machine
    Normal  Created    24s  kubelet, 10.240.128.97  Created container step-image-digest-exporter-gnbrp
    Normal  Started    23s  kubelet, 10.240.128.97  Started container step-image-digest-exporter-gnbrp

`ibmcloud ce buildrun get`

Visualizza i dettagli di un'esecuzione di build.

ibmcloud ce buildrun get --name BUILDRUN_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome dell'esecuzione di build. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce buildrun get --name mybuildrun

Output di esempio

Getting build run 'mybuildrun'...
Run 'ibmcloud ce buildrun events -n mybuildrun' to get the system events of the build run.
Run 'ibmcloud ce buildrun logs -f -n mybuildrun' to follow the logs of the build run.
OK
Name:          mybuildrun
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m  
Created:       2021-03-14T14:50:13-05:00  
Summary:       Succeeded  
Status:        Succeeded  
Reason:        All Steps have completed executing  
Source:          
  Commit Branch:  main  
  Commit SHA:     abcdeb88263442e28af6ae26d2082dea1d6abcde  
  Commit Author:  myauthor  
Image Digest:  sha256:522488ca3b54eb65f8c1e609a7b27c08558d08166fe062e7dde6838d4a609d61  
Image:  us.icr.io/mynamespace/test

`ibmcloud ce buildrun list`

Elenca tutte le esecuzioni di build di un progetto.

ibmcloud ce buildrun list [--build BUILD] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--build, -b: Usare questa opzione per visualizzare solo le esecuzioni della build specificata. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce buildrun list

Output di esempio

Listing builds...
OK
Name                                  Status     Build Name        Age
helloworld-build-run                  Succeeded  helloworld-build  5d22h
mybuildrun                            Succeeded  helloworld-build  7m23s
mybuildrun2                           Succeeded  helloworld-build  3m4s

`ibmcloud ce buildrun logs`

Visualizza i log di un'esecuzione di build.

ibmcloud ce buildrun logs --buildrun BUILDRUN_NAME [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

Opzioni di comando

--buildrun, -b, --br, --name, -n: Il nome dell'esecuzione di build. Questo campo è obbligatorio.
--follow, -f: Seguire i log dell'esecuzione della compilazione. Usare questa opzione per trasmettere i log dell'esecuzione della compilazione. Se si specifica l'opzione --follow, è necessario immettere Ctrl+C per terminare questo comando di log. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--raw, -r: Visualizza i registri senza le etichette delle istanze e dei contenitori. Questo valore è facoltativo. Il valore predefinito è false.
--tail, -t: Limita la visualizzazione dei registri dei contenitori dell'esecuzione di compilazione specificata a un numero massimo di righe recenti per contenitore. Ad esempio, per visualizzare le ultime 3 righe dei registri dei contenitori dell'esecuzione di compilazione specificata, specificare --tail 3. Se questa opzione non viene specificata, vengono visualizzate tutte le righe dei registri dei contenitori dell'esecuzione di compilazione specificata. Questo valore è facoltativo. Il valore predefinito è -1.
--timestamps, --ts: Includere i timestamp in ogni riga dell'output del log. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce buildrun logs --name mybuildrun

Output di esempio

Getting build run 'mybuildrun'...
Getting instances of build run 'mybuildrun'...
Getting logs for build run 'mybuildrun'...
OK
mybuildrun-v2mb8-pod-tlzdx/step-git-source-source-g2kbf:
{"level":"info","ts":1614089507.7123275,"caller":"git/git.go:165","msg":"Successfully cloned https://github.com/IBM/CodeEngine @ 433e2b8d6529e4a55f5e0f72d3772a79602a5ee8 (grafted, HEAD, origin/main) in path /workspace/source"}
{"level":"info","ts":1614089509.0128207,"caller":"git/git.go:203","msg":"Successfully initialized and updated submodules in path /workspace/source"}
mybuildrun-v2mb8-pod-tlzdx/step-build-and-push:
INFO[0000] Retrieving image manifest node:12-alpine
INFO[0000] Retrieving image node:12-alpine
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0001] Built cross stage deps: map[]
INFO[0001] Retrieving image manifest node:12-alpine
INFO[0001] Retrieving image node:12-alpine
INFO[0002] Retrieving image manifest node:12-alpine
INFO[0002] Retrieving image node:12-alpine
INFO[0002] Executing 0 build triggers
INFO[0002] Unpacking rootfs as cmd RUN npm install requires it.
INFO[0006] RUN npm install
INFO[0006] Taking snapshot of full filesystem...
INFO[0008] cmd: /bin/sh
INFO[0008] args: [-c npm install]
INFO[0008] Running: [/bin/sh -c npm install]
npm WARN saveError ENOENT: no such file or directory, open '/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/package.json'
npm WARN !invalid#2 No description
npm WARN !invalid#2 No repository field.
npm WARN !invalid#2 No README data
npm WARN !invalid#2 No license field.
up to date in 0.27s
found 0 vulnerabilities
INFO[0010] Taking snapshot of full filesystem...
INFO[0010] COPY server.js .
INFO[0010] Taking snapshot of files...
INFO[0010] EXPOSE 8080
INFO[0010] cmd: EXPOSE
INFO[0010] Adding exposed port: 8080/tcp
INFO[0010] CMD [ "node", "server.js" ]
mybuildrun-v2mb8-pod-tlzdx/step-image-digest-exporter-hcvmf:
2021/02/23 14:11:43 warning: unsuccessful cred copy: ".docker" from "/tekton/creds" to "/tekton/home": unable to open destination: open /tekton/home/.docker/config.json: permission denied
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.65581098Z","caller":"logging/config.go:115","message":"Successfully created the logger.","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"115","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}
{"severity":"INFO","timestamp":"2021-02-23T14:12:05.655937558Z","caller":"logging/config.go:116","message":"Logging level set to: info","logging.googleapis.com/labels":{},"logging.googleapis.com/sourceLocation":{"file":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging/config.go","line":"116","function":"github.com/tektoncd/pipeline/vendor/knative.dev/pkg/logging.newLoggerFromConfig"}}

`ibmcloud ce buildrun submit`

Inviare una sessione di compilazione.

ibmcloud ce buildrun submit (--build BUILD_NAME [--name NAME]) | (--name NAME [--commit COMMIT] [--context-dir CONTEXT_DIR] [--dockerfile DOCKERFILE] [--git-repo-secret GIT_REPO_SECRET] [--registry-secret REGISTRY_SECRET] [--size SIZE] [--strategy STRATEGY]) [--image IMAGE] [--no-wait] [--output OUTPUT] [--quiet] [--service-account SERVICE_ACCOUNT] [--source SOURCE] [--timeout TIMEOUT] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--build, -b, --bd

Il nome della configurazione della build da utilizzare. Questo valore è facoltativo.

--commit, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. L'opzione build commit è consentita se l'opzione --source è impostata su URL di un repository Git e non è consentita se l'opzione --source non è impostata su URL di un repository Git. Questo valore è facoltativo.

--context-dir, --cdr

La directory nel repository che contiene il file buildpacks o il Dockerfile. L'opzione della directory del contesto di compilazione è consentita se l'opzione --build non è impostata e non è consentita se l'opzione --build è impostata. Questo valore è facoltativo.

--dockerfile, --df

Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. L'opzione build dockerfile è consentita se l'opzione --build non è impostata e non è consentita se l'opzione --build è impostata. Questo valore è facoltativo. Il valore predefinito è Dockerfile.

--git-repo-secret, --grs, --repo, -r

--image, -i

-n, --name

Il nome dell'esecuzione di build. Utilizzare un nome univoco all'interno del progetto. Se l'opzione --build è impostata, l'opzione nome è opzionale. Se l'opzione --build non è impostata, l'opzione nome è necessaria.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 63 caratteri o meno e può contenere caratteri alfanumerici minuscoli e trattini (-).

Questo valore è facoltativo.

--no-wait, --nw: Inviare l'esecuzione della compilazione e non attendere il completamento della stessa. Se si specifica l'opzione --no-wait, l'invio dell'esecuzione della compilazione inizia senza attendere. Usare il comando buildrun get per controllare lo stato di esecuzione della compilazione. Questo valore è facoltativo. Il valore predefinito è true.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

Il nome del segreto di registro. Il segreto del Registro di sistema viene utilizzato per l'autenticazione con un registro privato quando scarichi l'immagine del contenitore. L'opzione Segreto di registro è consentita se l'opzione --build non è impostata e non è consentita se l'opzione --build è impostata. Questo valore è facoltativo.

--service-account, --sa

--size, --sz

La dimensione della build, che determina la quantità di risorse utilizzate. I valori validi sono small, medium, large, xlarge e xxlarge. Per ulteriori informazioni, vedere Determinazione delle dimensioni della build. L'opzione build size è consentita se l'opzione --build non è impostata e non è consentita se l'opzione --build è impostata. Questo valore è facoltativo. Il valore predefinito è medium.

--source, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Se l'opzione --build è impostata, l'opzione sorgente è richiesta se l'opzione --build-type della build correlata è local e non è consentita se l'opzione --build-type della build correlata è git. Se l'opzione --build non è impostata, l'opzione sorgente è opzionale. Questo valore è facoltativo. Il valore predefinito è ..

--strategy, --str

La strategia da utilizzare per il build dell'immagine. Per le candidature e le offerte di lavoro, i valori validi sono dockerfile e buildpacks. Per le funzioni, i valori validi hanno il formato codebundle-[RUNTIME-ID]. Per esempio, se si vuole costruire un bundle di codice per la propria funzione con l'ID del runtime nodejs-24, usare codebundle-nodejs-24 come strategia di compilazione. È possibile trovare l'ID di qualsiasi runtime di funzioni supportato eseguendo il comando ibmcloud ce fn runtimes. L'opzione strategia di costruzione è consentita se l'opzione --build non è impostata e non è consentita se l'opzione --build è impostata. Se non è specificato, la strategia di compilazione è determinata da Code Engine se --source è specificato e il sorgente è sulla macchina locale. Questo valore è facoltativo. Il valore predefinito è dockerfile.

--timeout, --to

La quantità di tempo, in secondi, che può trascorrere prima che l'esecuzione della compilazione abbia successo o fallisca. Questo valore è facoltativo. Il valore predefinito è 600.

--wait, -w

Inviare l'esecuzione della compilazione e attendere il completamento della stessa. Se si specifica l'opzione --wait, l'invio dell'esecuzione di compilazione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il completamento dell'esecuzione di compilazione. Se l'esecuzione della build non viene completata entro il periodo specificato da --wait-timeout, l'invio della build fallisce. Questo valore è facoltativo. Il valore predefinito è false.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere per il completamento di questa esecuzione della build. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

Il comando seguente invia un'esecuzione di compilazione chiamata mybuildrun e utilizza il file di configurazione della compilazione chiamato helloworld-build.

ibmcloud ce buildrun submit --name mybuildrun --build helloworld-build

Output di esempio

Submitting build run 'mybuildrun'...
Run 'ibmcloud ce buildrun get -n mybuildrun' to check the build run status.
OK

Comandi della Configmap

Una mappa di configurazione fornisce un metodo per includere informazioni di dati non sensibili nella distribuzione. Utilizzando i valori della tua configmap come variabili d'ambiente, puoi separare determinate informazioni dalla tua distribuzione e garantire la portabilità della tua app, del tuo job o della tua funzione. Una mappa di configurazione contiene informazioni in coppie chiave-valore. Utilizzare i comandi di configmap per creare, visualizzare i dettagli, aggiornare ed eliminare le configmap.

Per utilizzare i comandi di configmap è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le configmap, vedere Lavorare con le configmap.

È possibile utilizzare configmap o cm nei comandi di configmap. Per visualizzare la guida CLI per i comandi configmap, eseguire ibmcloud ce configmap -h.

`ibmcloud ce configmap create`

Creare una mappa di configurazione.

ibmcloud ce configmap create --name CONFIGMAP_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE) [--output OUTPUT] [--quiet]

Opzioni di comando

-n, --name

Il nome della mappa di configurazione. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--from-env-file, -e: Crea una mappa di configurazione da un file che contiene una o più righe che corrispondono al formato KEY=VALUE. È necessario fornire il percorso del file come valore. Ogni riga del file specificato viene aggiunta come coppia chiave-valore. Le righe del file specificato che sono vuote o iniziano con # vengono ignorate. Questo valore è necessario se --from-literal o --from-file non sono specificati.

--from-file, -f

Crea una configmap da un file. È necessario fornire il percorso del file come valore. Questo valore è necessario se --from-literal o --from-env-file non sono specificati.

--from-literal, -l

Crea una mappa di configurazione da una coppia chiave-valore. Deve essere nel formato KEY=VALUE. Questo valore è necessario se --from-file o --from-env-file non sono specificati. Questa opzione può essere specificata più volte.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente crea una configmap denominata configmap-fromliteral con due coppie di valori chiave: color=blue e size=large.

ibmcloud ce configmap create --name configmap-fromliteral --from-literal color=blue --from-literal size=large

Output di esempio

Creating Configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

Esempio di una mappa di configurazione con valori provenienti da più file

L'esempio seguente crea una mappa di configurazione denominata configmap-fromfile con valori provenienti da più file.

ibmcloud ce configmap create --name configmap-fromfile  --from-file ./color.txt --from-file ./size.txt

Esempio di output di una mappa di configurazione con valori da più file

Creating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

`ibmcloud ce configmap delete`

Elimina una mappa di configurazione.

ibmcloud ce configmap delete --name CONFIGMAP_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome della mappa di configurazione. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce configmap delete --name configmap-fromliteral -f

Output di esempio

Deleting Configmap 'configmap-fromliteral'...
OK

`ibmcloud ce configmap get`

Visualizza i dettagli di una ConfigMap.

ibmcloud ce configmap get --name CONFIGMAP_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome della mappa di configurazione. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce configmap get --name configmap-fromliteral

Output di esempio

Getting configmap 'configmap-fromliteral'...
OK
Name:          configmap-fromliteral
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21s
Created:       2021-03-01T13:50:56-05:00
Data:
---
color: blue
size: large

`ibmcloud ce configmap list`

Elenca tutte le mappe di configurazione presenti in un progetto.

ibmcloud ce configmap list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce configmap list

Output di esempio

Listing Configmaps...
Name                    Data   Age
configmap-fromfile      2      19m13s
configmap-fromliteral   2      16m12s

`ibmcloud ce configmap update`

Aggiornare una mappa di configurazione.

ibmcloud ce configmap update --name CONFIGMAP_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE | --rm KEY) [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome della mappa di configurazione. Questo campo è obbligatorio.
--from-env-file, -e: Aggiorna una configmap da un file che contiene una o più righe che corrispondono al formato KEY=VALUE. È necessario fornire il percorso del file come valore. Ogni riga del file specificato viene aggiunta come coppia chiave-valore. Le righe del file specificato che sono vuote o iniziano con # vengono ignorate. Questo valore è necessario se --from-literal o --from-file non sono specificati. Questa opzione può essere specificata più volte.
--from-file, -f: Aggiorna una mappa di configurazione da un file. È necessario fornire il percorso del file come valore. Questo valore è necessario se --from-literal o --from-env-file non sono specificati. Questa opzione può essere specificata più volte.
--from-literal, -l: Aggiorna una mappa di configurazione da una coppia chiave-valore. Deve essere nel formato KEY=VALUE. Questo valore è necessario se --from-file o o --from-env-file non sono specificati. Questa opzione può essere specificata più volte.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--rm: Rimuovere una singola coppia chiave-valore in una configmap, specificando il nome della chiave. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

Esempio

L'esempio seguente aggiorna una configmap denominata configmap-fromliteral con una coppia di valori di nome utente e password.

ibmcloud ce configmap update --name configmap-fromliteral --from-literal username=devuser --from-literal password='A!B99c$D1Def'

Output di esempio

Updating configmap 'configmap-fromliteral'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromliteral' to see more details.

Esempio di una mappa di configurazione con valori da un file

L'esempio seguente aggiorna una configmap denominata configmap-fromfile con i valori di un file.

ibmcloud ce configmap update --name configmap-fromfile  --from-file ./username.txt --from-file ./password.txt

Esempio di output di una mappa di configurazione con i valori di un file

Updating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

Comandi di connettività

La funzione di connettività di IBM Cloud® Code Engine supporta la configurazione di vari aspetti della connettività di rete dei carichi di lavoro nel progetto Code Engine.

Definire gli endpoint raggiungibili specificando gli intervalli di indirizzi IP di destinazione consentiti per le connessioni in uscita
Collegarsi ai servizi VPC Private Path di IBM Cloud.
Definire i riferimenti dei pool di sottoreti VPC, compresi i gruppi di sicurezza, per configurare la collocazione in rete dei lavoratori della flotta Code Engine.

Per utilizzare i comandi di connectivity è necessario trovarsi nel contesto di un progetto.

È possibile utilizzare connectivity o conn nei comandi di connectivity. Per visualizzare la guida CLI per i comandi connectivity, eseguire ibmcloud ce connectivity -h.

`ibmcloud ce connectivity outbound`

La funzione connessioni in uscita di IBM Cloud® Code Engine consente di definire gli endpoint raggiungibili per i progetti Code Engine.

Utilizzare gli intervalli di indirizzi IP di destinazione consentiti per le connessioni in uscita in notazione CIDR.
Collegare il progetto Code Engine con la VPC IBM Cloud Servizi di Sentieri Privati utilizzando la console Code Engine o la CLI.

Per utilizzare i comandi di connectivity outbound è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sull'utilizzo dei comandi di connettività in uscita, vedere Utilizzo della connettività in uscita in Code Engine.

È possibile utilizzare connectivity outbound o conn outbound nei comandi di connectivity outbound. Per visualizzare la guida CLI per i comandi connectivity outbound, eseguire ibmcloud ce connectivity outbound -h.

ibmcloud ce connectivity outbound COMMAND

`ibmcloud ce connectivity outbound create`

Creare una destinazione in uscita consentita.

ibmcloud ce connectivity outbound create --name OUTBOUND_DESTINATION_NAME (--cidr CIDR_IP_ADDRESS | --pps-crn PPS_CRN) [--force] [--format FORMAT] [--pps-isolation-policy PPS_ISOLATION_POLICY] [--quiet]

Opzioni di comando

--n, --cidr-name, --name: Obbligatorio. Nome della destinazione in uscita consentita. Questo campo è obbligatorio.
--cidr, -c: Fornire un intervallo di indirizzi IP valido in formato CIDR (ad esempio 1.2.3.0/24 ). Questo valore è facoltativo.
--force, -f: Forza la creazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--format, --fo: Formato della destinazione in uscita consentita. I valori validi sono [cidr, cidr_block, pps, private_path_gateway_service]. Se non viene specificato, il valore predefinito è cidr. Questo valore è facoltativo. Il valore predefinito è cidr_block.
--pps-crn, --private-path-service-crn: Specificare il CRN del servizio di percorso privato di destinazione al quale connettersi. Questo valore è facoltativo.
--pps-isolation-policy, --pip: La politica di isolamento della connessione al percorso privato. I valori validi sono [dedicated, shared]. Se non specificato, il valore predefinito è shared. Questo valore è facoltativo. Il valore predefinito è shared.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity outbound create --name allow-to-subnet-a --cidr 5.6.7.8/29

Output di esempio

Creating allowed destination IP address range 'allow-to-subnet-a'...
OK

Esempio di creazione di una connessione in uscita con percorso privato

ibmcloud ce connectivity outbound create --name my-pps-connection --format pps --pps-crn crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

Esempio di output per creare una connessione in uscita con percorso privato

Creating allowed outbound destination 'my-pps-connection'...
Successfully created allowed outbound destination 'my-pps-connection'. Current status is 'deploying'
Run 'ibmcloud ce connectivity outbound get --name my-pps-connection' to see more details.
OK

`ibmcloud ce connectivity outbound delete`

Eliminare una destinazione in uscita consentita.

ibmcloud ce connectivity outbound delete --name OUTBOUND_DESTINATION_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--n, --cidr-name, --name: Obbligatorio. Nome della destinazione in uscita consentita. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity outbound delete --name allow-to-subnet-a

Output di esempio

Are you sure you want to delete allowed outbound destination 'allow-to-subnet-a'? [y/N]> y
Deleting allowed outbound destination 'allow-to-subnet-a'...
OK

`ibmcloud ce connectivity outbound get`

Visualizzare i dettagli di una destinazione in uscita consentita.

ibmcloud ce connectivity outbound get --name OUTBOUND_DESTINATION_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--n, --cidr-name, --name: Obbligatorio. Nome della destinazione in uscita consentita. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono "json", "yaml", "jsonpath=JSONPATH_EXPRESSION" e "jsonpath-as-json=JSONPATH_EXPRESSION". Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity outbound get --name allow-to-subnet-a

Output di esempio

Getting allowed outbound destination 'allow-to-subnet-a'...
OK
Project name:  myproj
Name:          allow-to-subnet-a
Format:        cidr_block  
IP address range:  5.6.7.8/29

Esempio per ottenere una connessione in uscita da un percorso privato

ibmcloud ce connectivity outbound get --name my-pps-connection

Esempio di output per ottenere una connessione in uscita da un percorso privato

Getting allowed outbound destination 'my-pps-connection'...
OK
Project name:  myproj
Name:          my-pps-connection
Format:        private_path_service_gateway  
Private path service:    
  CRN:        crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f
  Status:     ready  
  Name:       my-private-path--is-vpc-pps  
  Endpoints:    
    api.ce-1a2b3c4d5e6f.intra  
VPE gateway:             
  Name:          code-engine-prod-eu-de-1234ab
  IP addresses:    
    192.168.12.48
    192.168.24.60
    192.168.36.72

`ibmcloud ce connectivity outbound list`

Elencare tutte le destinazioni in uscita consentite.

ibmcloud ce connectivity outbound list [--format FORMAT] [--output OUTPUT] [--quiet]

Opzioni di comando

--format: Limitare la visualizzazione delle destinazioni in uscita consentite al formato specificato. Indicare uno o più formati in un elenco delimitato da virgole. I valori validi sono [cidr, cidr_block, pps, private_path_gateway_service]. Questo valore è opzionale. Il valore predefinito è cidr_block,private_path_service_gateway.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity outbound list

Output di esempio

Listing allowed outbound destinations...
OK
CIDR ranges:                 
  Name               IP address range  
  allow-to-subnet-a  5.6.7.8/29
  allow-to-subnet-b  11.12.13.0/24
Private path connections:    
  Name               Status  Service endpoints  
  broken-connection  failed    
  my-pps-connection  ready   api.ce-1a2b3c4d5e6f.intra

`ibmcloud ce connectivity outbound update`

Aggiornare una destinazione in uscita consentita.

ibmcloud ce connectivity outbound update --name OUTBOUND_DESTINATION_NAME (--cidr CIDR_IP_ADDRESS | --pps-isolation-policy PPS_ISOLATION_POLICY) [--force] [--quiet]

Opzioni di comando

--n, --cidr-name, --name: Obbligatorio. Nome della destinazione in uscita consentita. Questo campo è obbligatorio.
--cidr, -c: Fornire un intervallo di indirizzi IP valido in formato CIDR (ad esempio 1.2.3.0/24 ). Questo valore è facoltativo.
--force, -f: Forza aggiornamento senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--pps-isolation-policy, --pip: La politica di isolamento della connessione al percorso privato. I valori validi sono [dedicated, shared]. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity outbound update --name allow-to-subnet-a --cidr 5.6.7.0/27

Output di esempio

Updating allowed destination IP address range 'allow-to-subnet-a'...
OK

`ibmcloud ce connectivity subnetpool`

La funzione di connessione ai pool di sottoreti IBM Cloud® Code Engine supporta la gestione dei riferimenti ai pool di sottoreti VPC, compresi i gruppi di sicurezza. Le flotte sono sempre collegate a una VPC e, durante la creazione di una flotta, è possibile fare riferimento a un pool di subnet per specificare in quale zona di rete vengono distribuiti i lavoratori della flotta Code Engine. Si crea un pool di sottoreti per specificare le sottoreti VPC e le zone di disponibilità in cui verrà elaborato il carico di lavoro. Ad esempio, è possibile creare un pool di sottoreti con una singola sottorete nella zona eu-de-1 o un pool di sottoreti con più sottoreti per coprire tutte e 3 le zone in eu-de. Inoltre, è possibile specificare il gruppo di sicurezza a cui il carico di lavoro deve essere collegato.

IBM Cloud® Virtual Private Cloud (VPC) è una rete virtuale collegata al tuo account cliente. Ti fornisce la sicurezza cloud, con la capacità di eseguire il ridimensionamento in modo dinamico, fornendo un controllo dettagliato sulla tua infrastruttura virtuale e sulla tua segmentazione del traffico di rete. Le sottoreti della VPC offrono una connettività privata. Le sottoreti nel tuo VPC possono connettersi all'internet pubblico attraverso un gateway pubblico facoltativo. È possibile garantire la sicurezza della propria VPC e dei propri carichi di lavoro controllando il traffico di rete tramite i gruppi di sicurezza. Per ulteriori informazioni, vedere Informazioni sulla rete e sulla sicurezza nella VPC.

Per utilizzare i comandi di connectivity subnetpool è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sull'utilizzo dei comandi di connettività del subnetpool, vedere Lavorare con la connettività del subnetpool in Code Engine.

È possibile utilizzare connectivity o conn nei comandi di connectivity subnetpool. Per visualizzare la guida CLI per i comandi connectivity subnetpool, eseguire ibmcloud ce connectivity subnetpool -h.

ibmcloud ce connectivity subnetpool COMMAND

`ibmcloud ce connectivity subnetpool create`

Creare un pool di sottoreti.

ibmcloud ce connectivity subnetpool create [--name NAME] [--quiet] [--security-group-crn SECURITY_GROUP_CRN] [--subnet-crn SUBNET_CRN]

Opzioni di comando

--name, -n: Obbligatorio. Nome del pool di sottoreti. Utilizzare un nome univoco all'interno del progetto. Questo campo è obbligatorio.
--subnet-crn, --crn: Specificare un CRN di sottorete valido per il pool. Deve essere in formato S1=crn:v1:example Questo valore è obbligatorio.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--security-group-crn, --sg-crn: Specificare un CRN valido del gruppo di sicurezza per il pool. Questo valore è facoltativo.

Esempio

ibmcloud ce connectivity subnetpool create --name my-other-pool \
  --subnet-crn S1=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f21 \
  --security-group-crn S1=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --subnet-crn IDx=crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f22 \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g \
  --security-group-crn IDx=crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g8h

Output di esempio

OK
Successfully created subnet pool with name 'my-other-pool' and ID 'a23ff1d1-b845-4629-86d1-a4126155ad02'

`ibmcloud ce connectivity subnetpool delete`

Eliminare un pool di sottoreti.

ibmcloud ce connectivity subnetpool delete (--name SUBNET_POOL_NAME || --id SUBNET_POOL_ID) [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--id: ID del pool di sottoreti. Questo valore è facoltativo.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--name, -n: Nome del pool di sottoreti. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity subnetpool delete --name my-subnet-pool

Output di esempio

Are you sure you want to delete subnet pool '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'? [y/N]> y
Deleting subnet pool with name 'my-subnet-pool' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
OK

`ibmcloud ce connectivity subnetpool get`

Visualizzare i dettagli di un pool di sottoreti.

ibmcloud ce connectivity subnetpool get (--id SUBNET_POOL_ID || --name SUBNET_POOL_NAME) [--output OUTPUT] [--quiet]

Opzioni di comando

--id: ID del pool di sottoreti. Questo valore è facoltativo.
--name, -n: Nome del pool di sottoreti. Questo valore è facoltativo.
--output, -o: Formato di output. I valori validi sono "json", "yaml", "jsonpath=JSONPATH_EXPRESSION" e "jsonpath-as-json=JSONPATH_EXPRESSION". Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce connectivity subnetpool get --name my-subnet-pool

Output di esempio

Getting subnet pool 'my-subnet-pool'...
OK
Name:          my-subnet-pool  
ID:            1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           114d  
Network placement:    
  Number of subnets:   1  
                       
  Subnet CRN:          crn:v1:bluemix:public:is:eu-de-3:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
  Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g

`ibmcloud ce connectivity subnetpool list`

Elencare tutti i pool di sottoreti presenti in un progetto.

ibmcloud ce connectivity subnetpool list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Formato di output. I valori validi sono "json", "yaml", "jsonpath=JSONPATH_EXPRESSION" e "jsonpath-as-json=JSONPATH_EXPRESSION". Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono "nome" e "età". Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce connectivity subnetpool list

Output di esempio

Listing all subnet pools in a project...
OK
Name                          ID                                    Subnets  Region  Age  
auto-network-pool-gg55edn1xe  hgfedcba-dcba-abcd-abcd-1a2b3c4d5e6f  1        eu-de   93d  
my-other-pool                 abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  3        eu-de   25h  
my-subnet-pool                1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  1        eu-de   114d

Comandi di mappatura del dominio

Le mappature dei domini forniscono l'URL URL che rimanda alle applicazioni e alle funzioni Code Engine all'interno di un progetto. Con Code Engine, queste mappature vengono create automaticamente, per impostazione predefinita, ogni volta che si distribuisce un'applicazione o si crea una funzione. Tuttavia, è possibile associare un dominio personalizzato a un'applicazione o a una funzione di Code Engine per instradare le richieste provenienti dal proprio URL verso l'applicazione o la funzione tramite Code Engine. Utilizzare i comandi di domainmapping per creare, visualizzare i dettagli, aggiornare ed eliminare le mappature di dominio.

Quando si imposta una mappatura di dominio personalizzata in Code Engine, si definisce una mappatura 1-to-1 tra il proprio nome di dominio completamente qualificato (FQDN) e un'applicazione Code Engine nel progetto. Per configurare e lavorare con le mappature di dominio personalizzate nella CLI, utilizzare i comandi domainmapping.

Per utilizzare i comandi di domainmapping è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sull'utilizzo dei mapping di dominio, vedere Configurazione di mapping di dominio personalizzati per l'applicazione.

È possibile utilizzare domainmapping o dm nei comandi di domainmapping. Per visualizzare la guida CLI per i comandi domainmapping, eseguire ibmcloud ce domainmapping -h.

`ibmcloud ce domainmapping create`

Creare un'associazione dominio personalizzato.

ibmcloud ce domainmapping create --domain-name DOMAIN_NAME [--target-type TARGET_TYPE] --tls-secret SECRET_NAME [--quiet]

Opzioni di comando

--domain-name, --dn, -n, --name: Specificare il nome dell'associazione dominio. Questo nome deve essere un nome dominio completo valido (FQDN). Ad esempio, www.example.com. Questo campo è obbligatorio.
--target, -t: Il nome dell'applicazione o della funzione di destinazione. Questo campo è obbligatorio.
--target-type, --type: Il tipo di destinazione. I valori validi sono application o function. Questo campo è obbligatorio.
--tls-secret, --secret, --tls: Specificare un segreto " TLS " che contenga il certificato, compresi tutti i certificati intermedi, e la chiave privata corrispondente per la mappatura del dominio. Il certificato deve essere firmato da un'autorità di certificazione (CA) pubblica attendibile. I certificati autofirmati non sono supportati. Questo campo è obbligatorio.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente crea una mappatura di dominio personalizzata tra l'applicazione Code Engine myapp e il dominio personalizzato www.example.com e utilizza il segreto TLS mytlssecret.

ibmcloud ce domainmapping create --domain-name www.example.com --target myapp --tls-secret mytlssecret

Output di esempio

OK
Domain mapping successfully created.

`ibmcloud ce domainmapping delete`

Eliminare un'associazione dominio personalizzato.

ibmcloud ce domainmapping delete --domain-name DOMAIN_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--domain-name, --dn, -n, --name: Il nome dell'associazione dominio. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce domainmapping delete --name www.example.com -f

Output di esempio

Deleting domain mapping 'www.example.com'...
OK

`ibmcloud ce domainmapping get`

Visualizzare i dettagli di un'associazione dominio personalizzato.

ibmcloud ce domainmapping get --domain-name DOMAIN_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--domain-name, --dn, -n, --name: Il nome della mappatura del dominio Questo valore è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce domainmapping get --name www.example.com

Output di esempio

Getting domainmapping 'www.example.com'...
OK
Domain Name:  www.example.com  
CNAME:        custom.abcdabcdabc.us-south.codeengine.appdomain.cloud  
Target Name:  myapp  
Target Type:  app  
TLS Secret:   mytlssecret  
Status:       ready

`ibmcloud ce domainmapping list`

Elencare le associazioni dominio in un progetto.

ibmcloud ce domainmapping list [--all] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--all, -a: Visualizzare tutte le associazioni dominio in un progetto, incluse le associazioni di dominio di sistema e personalizzate. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

L'esempio seguente visualizza un elenco di tutte le mappature di dominio personalizzate.

ibmcloud ce domainmapping list

Output di esempio

Listing domain mappings...
OK
Name              CNAME                                                        Target  Target-Type  Status  Secret Name  Age  
www.example.com   custom.abcdabcdabc.us-south.codeengine.appdomain.cloud       myapp   app          ready   mytlssecret  36m

Per visualizzare un elenco di tutte le mappature di dominio per le applicazioni, comprese le mappature di dominio personalizzate e quelle generate automaticamente dal sistema, specificare l'opzione --all con il comando ibmcloud ce domainmapping list con il comando

`ibmcloud ce domainmapping update`

Aggiornare un'associazione dominio personalizzato.

ibmcloud ce domainmapping update --domain-name DOMAIN_NAME --target TARGET_NAME --tls-secret SECRET_NAME [--quiet] [--target-type TARGET_TYPE]

Opzioni di comando

--domain-name, --dn, -n, --name: Il nome dell'associazione dominio. Questo campo è obbligatorio.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--target, -t: Il nome dell'applicazione o della funzione di destinazione. Questo valore è facoltativo.
--target-type, --type: Il tipo di destinazione. I valori validi sono application o function. Questo valore è facoltativo.
--tls-secret, --secret, --tls: Specificare un segreto " TLS " che contenga il certificato, compresi tutti i certificati intermedi, e la chiave privata corrispondente per la mappatura del dominio. Il certificato deve essere firmato da un'autorità di certificazione (CA) pubblica attendibile. I certificati autofirmati non sono supportati. Questo valore è facoltativo.

Esempio

L'esempio seguente aggiorna la mappatura del dominio www.example.com per utilizzare mytlssecret2 invece di mytlssecret.

ibmcloud ce domainmapping update --domain-name www.example.com --tls-secret mytlssecret2

Output di esempio

Updating domainmapping 'www.example.com'...

Comando sperimentale

Code Engine i comandi sperimentali non sono generalmente disponibili. Questo gruppo di comando fornisce l'accesso a potenziali funzioni future, che possono essere facilmente esplorate da alcuni utenti selezionati.

Per utilizzare i comandi di experimental è necessario trovarsi nel contesto di un progetto.

È possibile utilizzare experimental o exp nei comandi di experimental. Per visualizzare la guida CLI per i comandi experimental, eseguire ibmcloud ce exp -h.

`ibmcloud ce experimental`

Per utilizzare i comandi di experimental è necessario trovarsi nel contesto di un progetto.

È possibile utilizzare experimental o exp nei comandi di experimental. Per visualizzare la guida CLI per i comandi experimental, eseguire ibmcloud ce exp -h.

ibmcloud ce experimental COMMAND

Esempio

ibmcloud ce experimental help

Output di esempio

NAME:
  ibmcloud code-engine experimental - Experimental Code Engine commands
USAGE:
  ibmcloud code-engine experimental command [arguments...] [command options]
COMMANDS:
  help, h   Show help
Enter 'ibmcloud code-engine experimental help [command]' for more information about a command.

Comandi della flotta

Gestire le fleet serverless.

`ibmcloud ce fleet cancel`

Annullare una fleet serverless.

ibmcloud ce fleet cancel --id FLEET_ID [--force] [--hard] [--quiet]

Opzioni di comando

--id, --fid, --fleet-id: Obbligatorio. L'ID della fleet serverless. Questo campo è obbligatorio.
--force, -f: Forzare l'annullamento senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--hard: Annulla immediatamente la flotta serverless, comprese le attività in stato " running ". Se non si specifica l'opzione " hard ", l'elaborazione delle attività in stato " running " prosegue fino a quando queste non raggiungono uno stato finale, e solo a quel punto la flotta passa allo stato " canceled ". Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fleet cancel --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Output di esempio

Canceling serverless fleet...
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
OK
Name:            fleet-0123456789
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
Status:          canceled  
Created:         39m  
Project region:  eu-de  
Project name:    myproj  
Tasks status:    
  Failed:      0  
  Canceled:    0  
  Successful:  0  
  Running:     0  
  Pending:     1  
  Total:       1

`ibmcloud ce fleet create`

Avviare una serverless fleet.

ibmcloud ce fleet create --image IMAGE_REF --tasks-state-store TASKS_STATE_STORE (--subnetpool-name SUBNETPOOL_NAME | --subnetpool-id SUBNETPOOL_ID) (--tasks TASKS | --tasks-from-local-file TASKS_FROM_LOCAL_FILE | --tasks-from-cos-object TASKS_FROM_COS_OBJECT | --tasks-from-cos-bucket TASKS_FROM_COS_BUCKET) [--argument ARGUMENT] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--gpu GPU] [--max-scale MAX_SCALE] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mount-data-store MOUNT_DATA_STORE] [--name NAME] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--task-indexes TASK_INDEXES] [--worker-profile WORKER_PROFILE]

Opzioni di comando

--image, -i: Obbligatorio. Il nome dell'immagine contenitore utilizzata per elaborare le attività. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove REGISTRY e TAG sono facoltativi. Se non viene specificato REGISTRY, il valore predefinito è docker.io. Se non viene specificato TAG, il valore predefinito è latest. Questo campo è obbligatorio.
--tasks-state-store, --ts-state: Obbligatorio. Specificare il datastore persistente che memorizza lo stato delle attività della fleet. Questo campo è obbligatorio.
--argument, --arg, -a: Impostare gli argomenti necessari al comando da eseguire nell'attività. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--command, --cmd, -c: Impostare un comando da eseguire nell'attività. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--cpu, --cp: La quantità di CPU da impostare per un'attività. Questo valore è facoltativo. Il valore predefinito è 1.
--env, -e: Impostare le variabili di ambiente da passare all'attività. Deve essere in formato NOME=VALORE. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--env-from-configmap, --env-cm: Imposta le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione. Fornire NAME per fare riferimento alla configmap completa, PREFIX=NAME per fare riferimento alla configmap completa dove a ogni chiave è anteposto come prefisso PREFIX oppure NAME:KEY_A,KEY_B per fare riferimento a singole chiavi. Per specificare un nuovo nome per una chiave di riferimento, utilizzare il formato NAME:NEW_KEY_NAME=KEY_A. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--env-from-secret, --env-sec: Imposta le variabili d'ambiente dalle coppie chiave-valore memorizzate in questo segreto. Fornire NAME per fare riferimento al segreto completo, PREFIX=NAME per fare riferimento al segreto completo dove a ogni chiave è anteposto come prefisso PREFIX oppure NAME:KEY_A,KEY_B per fare riferimento a singole chiavi. Per specificare un nuovo nome per una chiave di riferimento, utilizzare il formato NAME:NEW_KEY_NAME=KEY_A. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--gpu, --gp: Il numero di GPU da allocare alla risorsa. Il formato è GPU_FAMILY:NUMBER_OF_GPUS. Il valore di NUMBER_OF_GPUS avrà come impostazione predefinita 1 e potrà essere una frazione. Ad esempio, h100:0.5 Questo valore è facoltativo.
--max-scale, --maxscale, --max: Numero massimo di istanze di attività da eseguire in parallelo. Questo valore è facoltativo. Il valore predefinito è 1.
--maxexecutiontime, --met: Il tempo massimo di esecuzione, espresso in secondi, per l'esecuzione di un'attività. Questo valore è facoltativo. Il valore predefinito è 0.
--memory, -m: La quantità di memoria da impostare per un'attività. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo. Il valore predefinito è 2G.
--mount-data-store, --mount-ds: Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME: [SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--name, -n: Il nome della fleet. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--registry-secret, --rs: Il nome del segreto di registro. Il segreto del registro viene utilizzato per l'autenticazione con un registro privato quando si scarica l'immagine del contenitore. Eseguire il comando ibmcloud ce registry create per creare un segreto del Registro di sistema. Questo valore è facoltativo.
--retrylimit, -r: Il numero di volte in cui un'attività deve essere rieseguita prima di essere contrassegnata come non riuscita. Questo valore è facoltativo. Il valore predefinito è 3.
--subnetpool-id, --spi: L'ID del pool di sottoreti da utilizzare per il posizionamento della rete della fleet. Questo valore è facoltativo.
--subnetpool-name, --spn: Il nome del pool di sottoreti da utilizzare per il posizionamento della rete della fleet. Questo valore è facoltativo.
--task-indexes, --ti: Specificare gli indici delle attività da elaborare, ad esempio 0,3,6,9, 1-5,7-8,10. Specificare un massimo di 1000 voci di indice. Questa opzione non può essere specificata se è stata specificata l'opzione " --tasks ". Questo valore è facoltativo.
--tasks, --ts: Specificare il numero di attività che devono essere elaborate dalla fleet. Se non viene specificata alcuna opzione relativa alle specifiche dell'attività, questa opzione viene utilizzata con il valore predefinito 1.
--tasks-from-cos-bucket, --ts-bucket: Specificare la posizione dei file all'interno di un bucket COS. Per ogni file, le attività devono essere elaborate dalla fleet. Questo valore è facoltativo.
--tasks-from-cos-object, --ts-cos: Specificare la posizione del file JSONL che si trova in un bucket COS. Il file definisce le attività che devono essere elaborate dalla fleet. Questo valore è facoltativo.
--tasks-from-local-file, --ts-file: Specificare la posizione di un file JSONL locale. Il file definisce le attività che devono essere elaborate dalla fleet. Questo valore è facoltativo.
--worker-profile, --profile, --prof: Specificare una preferenza per il profilo del worker supportato. Questo valore è facoltativo.

Esempio

ibmcloud ce fleet create --image icr.io/codeengine/helloworld --subnetpool-name my-pool --tasks-state-store mytaskstore --tasks 1

Output di esempio

Successfully created fleet with name 'fleet-0123456789' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
Run 'ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of provisioned workers.
Run 'ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of tasks.
OK

`ibmcloud ce fleet delete`

Eliminare una fleet serverless.

ibmcloud ce fleet delete --id FLEET_ID [--force] [--ignore-not-found] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--id, --fid, --fleet-id: Obbligatorio. L'ID della fleet serverless. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Eliminare la fleet serverless e attendere che l'eliminazione sia completata. Questo valore è facoltativo. Il valore predefinito è false.
--wait-timeout, --wto: Il tempo, espresso in secondi, necessario per attendere l'eliminazione della fleet serverless. Questo valore è facoltativo. Il valore predefinito è 180.

Esempio

ibmcloud ce fleet delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Output di esempio

Deleting serverless fleet...
OK

`ibmcloud ce fleet get`

Visualizza i dettagli di una serverless fleet.

ibmcloud ce fleet get --id FLEET_ID [--output OUTPUT] [--quiet]

Opzioni di comando

--id, --fid, --fleet-id: Obbligatorio. L'ID della fleet serverless. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Output di esempio

Getting fleet '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'...
OK
Name:            fleet-0123456789  
ID:              1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Status:          running  
Created:         2025-09-26T10:46:02Z  
Project region:  eu-de  
Project name:    myproj  
Tasks status:             
  Pending:     893  
  Running:     12  
  Failed:      0  
  Canceled:    0  
  Successful:  96  
  Total:       1001  
Code:                     
  Container image reference:  icr.io/codeengine/helloworld  
Tasks specification:      
  Task state store:  mytaskstore  
  Indexes:           0-1000  
Resources and scaling:    
  CPU per instance:         1  
  Memory per instance:      2G  
  Max number of instances:  12  
  Max retries per task:     3  
Network placement:        
  Subnet pools:    
    Name:                my-pool-
    Number of subnets:   1  
                         
    Subnet CRN:          crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f   
    Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
Environment Variables:    
  Type     Name   Value  
  Literal  FOO    bar

`ibmcloud ce fleet list`

Elenca tutti serverless fleet di un progetto.

ibmcloud ce fleet list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name, status e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce fleet list

Output di esempio

Listing fleets...
OK
Name              ID                                    Status      Tasks finished  Tasks total  Instances  Created  
fleet-a123456789  0a0a0a0a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  successful  300             300          0          2025-09-26T12:11:28Z  
fleet-b123456789  1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  running     778             1001         12         2025-09-26T12:43:11Z  
fleet-c123456789  2a2a2a2a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  canceled    1               1            0          2025-09-26T10:46:02Z

`ibmcloud ce fleet task`

Gestire le attività della fleet serverless.

ibmcloud ce fleet task COMMAND [--quiet]

Opzioni di comando

--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

`ibmcloud ce fleet task get`

Visualizza i dettagli di un'attività di serverless fleet.

ibmcloud ce fleet task get --task-id TASK_ID --fleet-id FLEET_ID [--output OUTPUT] [--quiet]

Opzioni di comando

--fleet-id, --fid: Obbligatorio. L'UUID della fleet a cui appartiene l'attività. Questo campo è obbligatorio.
--task-id, --tid, --id: Obbligatorio. L'UUID dell'attività. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fleet task get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --task-id 2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f

Output di esempio

Getting serverless fleet task '2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f'...
OK
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Task index:    226  
Created:       2025-09-26T12:45:58Z  
Finished:      2025-09-26T12:47:03Z  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
State information:    
  Status:       successful  
  Retries:      0  
  Worker name:  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1

`ibmcloud ce fleet task list`

Elencare tutte le attività di una fleet serverless.

ibmcloud ce fleet task list --fleet-id FLEET_ID [--output OUTPUT] [--pagination-token PAGINATION_TOKEN] [--quiet] [--show-all-columns] [--sort-by SORT_BY] [--status STATUS]

Opzioni di comando

--fleet-id, --fid: Obbligatorio. L'UUID della fleet a cui appartengono le attività. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--pagination-token, --pt: Mostrare la pagina successiva delle attività a partire da questo token di impaginazione. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--show-all-columns, --sac: Visualizza colonne aggiuntive su Created e Finished. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, --sb: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono id, index e status. Questo valore è facoltativo. Il valore predefinito è index.
--status, --st: Mostrare le attività con lo stato specificato. I valori validi sono canceled, failed, pending, running e succeeded. Questo valore è facoltativo.

Esempio

ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Output di esempio

Listing serverless fleet tasks...
OK
Task index  ID                                    Status   Result code  Worker name  
0           5b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0
1           4b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
2           3b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  pending
3           2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running                  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1
4           1b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  successful  0            fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0

`ibmcloud ce fleet worker`

Gestire i worker della fleet serverless.

ibmcloud ce fleet worker COMMAND [--quiet]

Opzioni di comando

--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

`ibmcloud ce fleet worker delete`

Eliminare un serverless fleet worker.

ibmcloud ce fleet worker delete --name WORKER_NAME --fleet-id FLEET_ID [--force] [--hard] [--ignore-not-found] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--fleet-id, --fid: Obbligatorio. L'ID della fleet a cui appartiene il worker. Questo campo è obbligatorio.
--name, -n, --worker-name: Obbligatorio. Il nome del worker della flotta serverless. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--hard: Eliminare immediatamente il worker della flotta serverless. Se non si specifica l'opzione "hard", la gestione delle attività "in esecuzione" elaborate da questo worker prosegue fino a quando tali attività non raggiungono uno stato finale; solo a quel punto il worker viene eliminato. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Eliminare il serverless fleet worker e attendere che il worker venga eliminato. Questo valore è facoltativo. Il valore predefinito è false.
--wait-timeout, --wto: Il tempo in secondi di attesa per l'eliminazione del serverless fleet worker. Questo valore è facoltativo. Il valore predefinito è 180.

Esempio

ibmcloud ce fleet worker delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

Output di esempio

Deleting serverless fleet worker...
OK

`ibmcloud ce fleet worker get`

Visualizza i dettagli di un serverless fleet worker.

ibmcloud ce fleet worker get --name WORKER_NAME --fleet-id FLEET_ID [--output OUTPUT] [--quiet]

Opzioni di comando

--fleet-id, --fid: Obbligatorio. L'ID della fleet a cui appartiene il worker. Questo campo è obbligatorio.
--name, -n, --worker-name: Obbligatorio. Il nome del worker della flotta serverless. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fleet worker get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e --worker-name fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42

Output di esempio

Getting serverless fleet worker...
OK
Name:          fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42  
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Created:       2025-09-26T20:05:33Z  
Status:        running  
Version:       v1.0.15  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
Network placement:      
  IP address:    10.242.0.42  
  Network zone:  eu-de-1  
  Subnet CRN:    crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Profile information:    
  Profile:       cx2-2x4  
  vCPUs:         2  
  Memory (GiB):  4

`ibmcloud ce fleet worker list`

Elencare tutti i worker di una fleet serverless.

ibmcloud ce fleet worker list --fleet-id FLEET_ID [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--fleet-id, --fid, --id: Obbligatorio. L'ID della fleet a cui appartiene il worker. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e status. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

Output di esempio

Listing serverless fleet workers...
OK
Name                                          ID                                    Status        Profile   IP           Zone     Version  
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-0  2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  running       cx2-2x4   10.242.0.42  eu-de-1  v1.0.15
fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1  3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  initializing  cx2-8x16  10.242.0.43  eu-de-1  v1.0.15

`ibmcloud ce fleet worker profiles`

Elencare i profili dei worker supportati per le fleet serverless.

ibmcloud ce fleet worker profiles [--output OUTPUT] [--profile-family PROFILE_FAMILY] [--quiet] [--region REGION] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Formato di output. I valori validi sono "json", "yaml", "jsonpath=JSONPATH_EXPRESSION" e "jsonpath-as-json=JSONPATH_EXPRESSION". Questo valore è facoltativo.
--profile-family, --pf: Mostrare i profili appartenenti alla famiglia di profili di worker specificata. I valori validi sono [b, balanced, c, compute, m, memory, g, gpu, f, flex]. Questo valore è opzionale.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--region, -r: Visualizzare i profili dei worker supportati nella regione specificata. Questo valore è facoltativo.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name, cpu, disk e memory. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce fleet worker profiles --profile-family --region br-sao

Output di esempio

Listing fleet worker profiles...
OK
Name                 CPU  Memory  Disk  GPU family  Region  
gx2-8x64x1v100       8    64Gi    0     v100        br-sao  
gx2-32x256x2v100     32   256Gi   0     v100        br-sao  
gx3-48x240x2l40s     48   240Gi   0     l40s        br-sao  
gx3-64x320x4l4       64   320Gi   0     l4          br-sao  
gx3d-160x1792x8h100  160  1792Gi  60Ti  h100        br-sao

Comandi di funzione

Una funzione è uno snippet di codice stateless che esegue compiti quando viene invocato dalle richieste di HTTP. Con le funzioni di IBM Code Engine è possibile eseguire la logica aziendale in modo scalabile e senza server. IBM Code Engine le funzioni di questo tipo forniscono un ambiente di runtime ottimizzato per supportare scenari a bassa latenza e di scale-out rapido. Il codice delle funzioni può essere scritto in un runtime gestito che include versioni specifiche di Node.js o Python.

Per utilizzare i comandi di function è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le funzioni, vedere Lavorare con le funzioni.

`ibmcloud ce function bind`

Associa un'istanza del servizio " IBM Cloud " a una funzione.

ibmcloud ce function bind --name FUNCTION_NAME (--service-instance SI_NAME | --service-instance-id SI_ID) [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome della funzione di cui eseguire il binding. Questo campo è obbligatorio.
--no-wait, --nw: Associa l'istanza del servizio senza attendere che l'associazione del servizio sia pronta. Se si specifica l'opzione no-wait, la creazione del binding del servizio viene avviata e il comando esce senza attendere il completamento. Usare il comando function get per verificare lo stato di bind della funzione. Questo valore è facoltativo. Il valore predefinito è false.
--prefix, -p: Un prefisso per le variabili di ambiente create per questo binding del servizio. Deve contenere solo lettere maiuscole, numeri e trattini bassi (_) e non può iniziare con un numero. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--role, -r: Il nome di un ruolo di servizio per le nuove credenziali di servizio create per questo binding di servizio. I valori validi includono Reader, Writer, Manager o un ruolo specifico del servizio. L'impostazione predefinita è " Manager " oppure il primo ruolo fornito dal servizio, qualora " Manager " non fosse supportato. Questa opzione viene ignorata se viene specificato --service-credential. Questo valore è facoltativo.
--service-credential, --sc: Il nome di una credenziale di servizio esistente da utilizzare per questo binding di servizio. Se non si specifica una credenziale dell'istanza di servizio, le nuove credenziali vengono generate durante l'azione di bind. Questo valore è facoltativo.
--service-instance, --si: Il nome di un'istanza del servizio IBM Cloud esistente da associare alla funzione. Questo valore è facoltativo.
--service-instance-id, --siid: Il GUID di un'istanza di servizio esistente di IBM Cloud da associare alla funzione. Questo valore è facoltativo.
--wait, -w: Associa l'istanza del servizio e attendi che l'associazione del servizio sia pronta. Se si specifica l'opzione --wait, il bind della funzione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché il bind della funzione venga completato con successo. Se il bind della funzione non viene completato con successo o fallisce entro il periodo specificato da --wait-timeout, il comando fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché il binding del servizio sia pronto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 300.

Esempio

ibmcloud ce fn bind --name myfunction --service-instance my-object-storage

Output di esempio

Binding service instance...
Status: Done
OK

`ibmcloud ce function create`

Creare una funzione.

ibmcloud ce function create --name FUNCTION_NAME [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-source BUILD_SOURCE] [--build-timeout BUILD_TIMEOUT] [--code-bundle CODE_BUNDLE] [--code-bundle-secret CODE_BUNDLE_SECRET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--force] [--inline-code INLINE_CODE] [--main MAIN] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--no-wait] [--output OUTPUT] [--quiet] [--runtime RUNTIME] [--scale-down-delay SCALE_DOWN_DELAY] [--trusted-profiles-enabled] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

-n, --name

Il nome della funzione. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare con una lettera minuscola.
Il nome deve terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da un massimo di 63 caratteri e può contenere lettere minuscole, numeri e trattini (-).

Questo campo è obbligatorio.

--runtime, -r: Il tempo di esecuzione da utilizzare per la funzione. Per trovare i tempi di esecuzione supportati per questa regione, eseguire ibmcloud ce function runtimes. Vedere Tempi di esecuzione. Questo campo è obbligatorio.

--build-commit, --commit, --bcm, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. Questo valore è facoltativo.

--build-context-dir, --context-dir, --bcdr, --cdr

La directory nel repository che contiene il codice sorgente per la funzione. Questo valore è facoltativo.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Il nome del segreto SSH, che contiene le credenziali per accedere al repository privato che contiene il codice sorgente per creare l'immagine del bundle di codice. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questa opzione è consentita solo se l'opzione --build-source è impostata sull'opzione URL di un repository Git. Questo valore è facoltativo.

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-timeout, --bto

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. Questo valore è facoltativo. Il valore predefinito è 600.

--code-bundle, --cb

Il nome dell'immagine code-bundle da utilizzare per questa funzione. Quando viene specificato build-source , questo valore rappresenta il percorso dell'immagine di output generata dal push della build. Se non viene specificato build-source, questo valore corrisponde al percorso dell'immagine del pacchetto di codice esistente. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove TAG è facoltativo. Se non viene specificato TAG, il valore predefinito è latest. Questo valore è facoltativo.

--code-bundle-secret, --cs, --cbs

Il nome del segreto di registro utilizzato per l'autenticazione con un registro privato. È possibile aggiungere il segreto di registro eseguendo il comando registry create. Questo valore è facoltativo.

--cpu

La quantità di CPU impostata per l'istanza della funzione. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 1.

--env, -e

Impostare le variabili di ambiente nella funzione. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova variabile d'ambiente o sostituisce una variabile d'ambiente esistente. Specificare una variabile d'ambiente per ogni opzione --env ; ad esempio, --env envA=A --env envB=B. Questo valore è facoltativo.

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi.

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-sec, --env-from-secret: Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi.

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--force, -f: Non verificare l'esistenza dei riferimenti configmap e secret specificati. Questo valore è facoltativo. Il valore predefinito è false.

--inline-code

Specificare il percorso del file contenente il codice sorgente della funzione. Il codice è inserito direttamente all'interno della funzione. Questo valore è facoltativo.

--main, --fn-main

Specificare il nome della funzione principale nel codice sorgente fornito. Questa opzione è necessaria quando il nome non è main. Questo valore è facoltativo. Il valore predefinito è main.

--maxexecutiontime, --met

Il periodo massimo di tempo, in secondi, per il completamento dell'esecuzione di questa funzione. Questo valore è facoltativo. Il valore predefinito è 60.

--memory, -m

La quantità di memoria assegnata alla funzione. Utilizza M per i megabyte o G per i gigabyte. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 4G.

--no-wait, --nw

Non attendere il completamento dell'esecuzione di build. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--scale-down-delay, --sdd

Il periodo di tempo, in secondi, in cui un'istanza è attiva una volta completata una chiamata. Questa opzione può ridurre i tempi di avvio a freddo. Per ulteriori informazioni, consultare la sezione È possibile mantenere in vita l'istanza della funzione più a lungo? Questo valore è facoltativo. Il valore predefinito è 1.

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per l'esecuzione della funzione. Questo valore è facoltativo. Il valore predefinito è false.

--visibility, -v

La visibilità per la funzione. I valori validi sono public, private e project. La visibilità può essere " private " solo se il progetto supporta la visibilità "private" delle funzioni. Questo valore è facoltativo. Il valore predefinito è public.

--wait, -w

Attendere il completamento dell'esecuzione della build. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché la funzione sia pronta. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce fn create --name myfunction --build-source main.js --runtime nodejs

Output di esempio

Preparing function 'myfunction' for build push...
Creating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'private.stg.icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.
https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

Quando si esegue il comando " ibmcloud ce fn get -n 'myfunction' " per verificare lo stato della funzione, viene visualizzata la pagina " URL " relativa alla funzione in questione.

`ibmcloud ce function delete`

Eliminare una funzione.

ibmcloud ce function delete --name FUNCTION_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome della funzione. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fn delete --name myfunction

Output di esempio

Are you sure you want to delete function 'myfunction'? [y/N]> y
Deleting function 'myfunction'...
OK

`ibmcloud ce function get`

Visualizzare i dettagli di una funzione.

ibmcloud ce function get --name FUNCTION_NAME [--output OUTPUT] [--quiet] [--save SAVE]

Opzioni di comando

--name, -n: Il nome della funzione. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--save, -s: Salva il codice sorgente della funzione sul file system locale. Questa opzione è supportata solo per le funzioni create con codice in linea. Questo valore è facoltativo.

Esempio

ibmcloud ce fn get --name myfunction

Output di esempio

Getting function 'myfunction'...
OK
Name:          myfunction  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           6m8s  
Created:       2023-06-22T19:59:51Z
URL:           https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud  
Status:        Ready  
Resources:    
  CPU:                 0.25  
  Memory:              500M  
  Max Execution Time:  60 seconds  
Build Information:    
  Build Run Name:     myfunction-run-111111-12345678
  Build Type:         local  
  Build Strategy:     codebundle-nodejs-22
  Timeout:            600  
  Source:             main.js  
                      
  Build Run Summary:  Succeeded  
  Build Run Status:   Succeeded  
  Build Run Reason:   All Steps have completed executing  
  Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' for details.  
Function Code:    
  Runtime:        nodejs-22 (managed)
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

`ibmcloud ce function list`

Elencare tutte le funzioni in un progetto.

ibmcloud ce function list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce fn delete --name myfunction

Output di esempio

Name           Status     URL                                                                    CPU   Memory  Age  
hellofunction  Ready      https://hellofunction.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction     Ready      https://myfun1.4svg40kna19.us-south.codeengine.appdomain.cloud         0.25  1G      8d   
helloworld     Ready      https://myfunction1.4svg40kna19.us-south.codeengine.appdomain.cloud    0.25  1G      16d  
myfunction1    Ready      https://myfunction111.4svg40kna19.us-south.codeengine.appdomain.cloud  0.25  500M    25h  
myfunction3    Ready      https://myfunction41.4svg40kna19.us-south.codeengine.appdomain.cloud   0.25  500M    25h

`ibmcloud ce function runtimes`

Elencare i runtime di funzione disponibili.

ibmcloud ce function runtimes [--all] [--output OUTPUT] [--quiet]

Opzioni di comando

--all, -A: Visualizzare tutti i runtime, inclusi quelli obsoleti. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fn runtimes

Output di esempio

Name         ID           Family  Default
Python 3.11  python-3.11  python  true
Node.js 22   nodejs-22    nodejs  true
Node.js 24   nodejs-24    nodejs  false
Python 3.13  python-3.13  python  false

`ibmcloud ce function unbind`

Rimuovere il collegamento delle istanze del servizio " IBM Cloud " da una funzione.

ibmcloud ce function unbind --name FUNCTION_NAME (--binding BINDING_NAME | --all) [--quiet]

Opzioni di comando

--name, -n: Il nome della funzione di cui annullare il binding. Questo campo è obbligatorio.
--all, -A: Annullare il binding di tutte le istanza del servizio per questa funzione. Questo valore è necessario se --binding non è specificato. Il valore predefinito è false.
--binding, -b: Il nome del collegamento da rimuovere. Esegui il comando ibmcloud ce function get -n FUNCTION_NAME per visualizzare i nomi dei binding. Questo valore è necessario se --all non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce fn unbind --name myfunction --all

Output di esempio

Removing bindings from 'myfunction'...
OK

`ibmcloud ce function update`

Aggiornare una funzione.

ibmcloud ce function update --name FUNCTION_NAME [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-source BUILD_SOURCE] [--build-timeout BUILD_TIMEOUT] [--code-bundle CODE_BUNDLE] [--code-bundle-secret CODE_BUNDLE_SECRET] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--force] [--inline-code INLINE_CODE] [--main MAIN] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--no-wait] [--output OUTPUT] [--quiet] [--rebuild] [--runtime RUNTIME] [--scale-down-delay SCALE_DOWN_DELAY] [--trusted-profiles-enabled] [--visibility VISIBILITY] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n

Obbligatorio. Il nome della funzione. Questo campo è obbligatorio.

--build-clear, --bc

Rimuovere l'associazione di un build da questa funzione. L'opzione Cancella build è consentita solo se la funzione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-commit, --commit, --bcm, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. Questo valore è facoltativo.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Cancellare il commit, il tag o il ramo nel repository di origine di cui eseguire il pull. L'opzione commit clear è consentita solo se la funzione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-context-dir, --context-dir, --bcdr, --cdr

La directory nel repository che contiene il codice sorgente per la funzione. Questa opzione è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Il nome della chiave segreta SSH che contiene le credenziali per accedere al repository privato contenente il codice sorgente necessario per creare l'immagine. Questo valore è facoltativo.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Cancella il segreto SSH. Questa opzione è consentita solo se la funzione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-timeout, --bto

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. Questo valore è facoltativo. Il valore predefinito è 600.

--code-bundle, --cb

--code-bundle-secret, --cs, --cbs

--cpu

La quantità di CPU impostata per l'istanza della funzione. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 1.

--env, -e

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-from-configmap-rm, --env-cm-rm: Rimuove i riferimenti delle variabili d'ambiente alle configmap complete usando il nome della configmap. Per rimuovere i riferimenti a singole chiavi delle configmap, usare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-sec, --env-from-secret

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--env-from-secret-rm, --env-sec-rm: Rimuovere i riferimenti delle variabili d'ambiente ai segreti completi utilizzando il nome del segreto. Per rimuovere i riferimenti a singole chiavi di segreti, utilizzare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-rm

--force, -f

--inline-code

Specificare il percorso di un file contenente il codice sorgente per la funzione. Il codice è inserito direttamente all'interno della funzione. Questo valore è facoltativo.

--main, --fn-main

Specificare il nome della funzione principale nel codice sorgente fornito. Questa opzione è necessaria quando il nome non è main. Questo valore è facoltativo. Il valore predefinito è main.

--maxexecutiontime, --met

Il tempo massimo di esecuzione, espresso in secondi, necessario affinché questa funzione completi il proprio ciclo. Questo valore è facoltativo. Il valore predefinito è 60.

--memory, -m

--no-wait, --nw

Inviare l'esecuzione della compilazione e non attendere il completamento della stessa. Se si specifica l'opzione --no-wait, l'invio dell'esecuzione della compilazione inizia senza attendere. Usare il comando buildrun get per controllare lo stato di esecuzione della compilazione. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--rebuild

Ricompilare l'immagine partendo dal codice sorgente. L'opzione di ricostruzione è consentita solo se la funzione ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--runtime, -r

Il tempo di esecuzione da utilizzare per la funzione. Per trovare i tempi di esecuzione supportati per questa regione, eseguire ibmcloud ce function runtimes. Vedere Tempi di esecuzione. Questo valore è facoltativo.

--scale-down-delay, --sdd

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per l'esecuzione della funzione. Questo valore è facoltativo. Il valore predefinito è false.

--visibility, -v

--wait, -w

Attendere il completamento dell'esecuzione della build. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Esempio

ibmcloud ce fn update --name myfunction --runtime nodejs-22 --build-source main.js

Output di esempio

Preparing function 'myfunction' for build push...
Updating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK                                                
Run 'ibmcloud ce function get -n myfunction' to see more details.
https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud

Quando si esegue il comando " ibmcloud ce fn get -n 'myfunction' " per verificare lo stato della funzione, viene visualizzata la pagina " URL " relativa alla funzione in questione.

Comando di aiuto

Il comando Code Engine help fornisce informazioni sui comandi disponibili per ogni gruppo di comandi.

`ibmcloud ce help`

Il comando Code Engine help fornisce informazioni sui comandi disponibili per ogni gruppo di comandi.

ibmcloud ce help COMMAND

Esempio

ibmcloud ce help

Output di esempio

NAME:
  code-engine, ce - Manage Code Engine components
USAGE:
  ibmcloud ce command [arguments...] [options...]
COMMANDS:
  application, app     Manage applications.
  binding              Manage bindings.
  build, bd, b         Manage configurations for generating images from source code.
  buildrun, br         Generate images from a build.
  configmap, cm        Manage configmaps.
  domainmapping, dm    Manage domain mappings.
  experimental, exp    Experimental Code Engine commands
  function, fn         Manage functions.
  help, h              Show help.
  job                  Manage jobs to configure tasks.
  jobrun, jr           Manage instances of a job.
  connectivity, conn   Manage connectivity commands
  project, proj        Manage Code Engine projects.
  reclamation, recl    Manage Code Engine project reclamations.
  registry             Manage image registry access secrets.
  repo                 Manage Git repository access secrets.
  revision, rev        Manage application revisions.
  secret               Manage secrets.
  serviceaccess        Manage service access secrets.
  subscription, sub    Manage event subscriptions.
  version, v           Display the 'code-engine' command-line interface version.
Enter 'ibmcloud ce help command' for more information about a command.

Comandi di lavoro

Un lavoro esegue in parallelo una o più istanze del codice eseguibile. A differenza delle applicazioni, che gestiscono le richieste di HTTP, i lavori sono progettati per essere eseguiti una sola volta e poi terminati. Quando si crea un lavoro, è possibile specificare le informazioni di configurazione del carico di lavoro che vengono utilizzate ogni volta che il lavoro viene eseguito. Usare i comandi di job per creare una configurazione per il lavoro.

Per utilizzare i comandi di job è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con i lavori, vedere Esecuzione di lavori.

Per visualizzare la guida CLI per i comandi job, eseguire ibmcloud ce job -h.

`ibmcloud ce job bind`

Legare un'istanza del servizio IBM Cloud a un lavoro.

ibmcloud ce job bind --name JOB_NAME (--service-instance SI_NAME | --service-instance-id SI_ID) [--no-wait] [--prefix PREFIX] [--quiet] [--role ROLE] [--service-credential SERVICE_CREDENTIAL] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome del processo da associare. Questo campo è obbligatorio.
--no-wait, --nw: Associa l'istanza del servizio senza attendere che l'associazione del servizio sia pronta. Se si specifica l'opzione --no-wait, la creazione del binding del servizio viene avviata e il comando esce senza attendere il completamento. Usare il comando job get per controllare lo stato del job bind. Questo valore è facoltativo. Il valore predefinito è false.
--prefix, -p: Un prefisso per le variabili di ambiente create per questo binding del servizio. Deve contenere solo lettere maiuscole, numeri e trattini bassi (_) e non può iniziare con un numero. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--role, -r: Il nome di un ruolo di servizio per le nuove credenziali di servizio create per questo binding di servizio. I valori validi includono Reader, Writer, Manager o un ruolo specifico del servizio. L'impostazione predefinita è " Manager " oppure il primo ruolo fornito dal servizio, qualora " Manager " non fosse supportato. Questa opzione viene ignorata se viene specificato --service-credential. Questo valore è facoltativo.
--service-credential, --sc: Il nome di una credenziale di servizio esistente da utilizzare per questo binding di servizio. Se non si specifica una credenziale dell'istanza di servizio, le nuove credenziali vengono generate durante l'azione di bind. Questo valore è facoltativo.
--service-instance, --si: Il nome di un'istanza del servizio IBM Cloud esistente da associare al lavoro. Questo valore è facoltativo.
--service-instance-id, --siid: Il GUID di un'istanza del servizio IBM Cloud esistente da associare al lavoro. Questo valore è facoltativo.
--wait, -w: Associa l'istanza del servizio e attendi che l'associazione del servizio sia pronta. Se si specifica l'opzione --wait, il job bind attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché il job bind venga completato con successo. Se il job bind non viene completato con successo o fallisce entro il periodo specificato da --wait-timeout, il comando fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché il binding del servizio sia pronto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 300.

Esempio

In questo esempio, si lega l'istanza del servizio chiamato my-object-storage al lavoro chiamato hello.

ibmcloud ce job bind --name hello --service-instance my-object-storage

Output di esempio

Binding service instance...
Waiting for service binding to become ready...
Status: Pending (Processing Resource)
Status: Pending (Processing Resource)
Status: Creating service binding
Status: Creating service binding
Status: Ready
OK

`ibmcloud ce job create`

Creare un lavoro.

ibmcloud ce job create --name JOB_NAME ((--image IMAGE_REF | (--build-source SOURCE [--image IMAGE_REF])) [--argument ARGUMENT] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--build-commit BUILD_COMMIT] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-size BUILD_SIZE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

-n, --name

Il nome del lavoro. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da un massimo di 63 caratteri e può contenere lettere minuscole, numeri e trattini (-).

Questo campo è obbligatorio.

--argument, --arg, -a: Imposta gli argomenti per l'esecuzione del lavoro. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore è facoltativo.

--array-indexes, --array-indices, --ai

Specifica gli indici dell'array utilizzati per le esecuzioni del processo, ad esempio 0,3,6,9, 1-5,7-8,10. L'insieme dei risultati degli indici è limitato a 1000 voci. Questa opzione può essere specificata solo se non è stata specificata l'opzione " array-size ". Questo valore è facoltativo. Il valore predefinito è 0.

--array-size, --as, --instances, --is

Specifica il numero di istanze utilizzate per le esecuzioni del lavoro. Quando si utilizza questa opzione, il sistema converte i valori in indici di array. Ad esempio, se si specifica l'indirizzo instances, che corrisponde a 5, il sistema lo converte in array-indexes, che corrisponde a 0 - 4. Questa opzione può essere specificata solo se non è stata specificata l'opzione " --array-indexes ". Questo valore è facoltativo. Il valore predefinito è 1.

--build-commit, --commit, --bcm, --cm, --revision

--build-context-dir, --context-dir, --bcdr, --cdr

--build-dockerfile, --dockerfile, --bdf, --df

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

--build-size, --size, --bsz, --sz

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-strategy, --strategy, --bstr, --str

--build-timeout, --bto

--command, --cmd, -c

Impostare i comandi per l'esecuzione del lavoro. Specificare un comando per ogni opzione --command ; ad esempio, --cmd cmdA --cmd cmdB. Questo valore sostituisce il comando predefinito specificato nell'immagine del contenitore. Questo valore è facoltativo.

--cpu

La quantità di CPU da impostare per l'esecuzione del lavoro. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 1.

--env, -e

Impostare le variabili d'ambiente per l'esecuzione del lavoro. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova variabile d'ambiente o sostituisce una variabile d'ambiente esistente. Specificare una variabile d'ambiente per ogni opzione --env ; ad esempio, --env envA=A --env envB=B. Questo valore è facoltativo.

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-sec, --env-from-secret: Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--ephemeral-storage, --es: La quantità di memoria temporanea da impostare per le esecuzioni del processo. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo. Il valore predefinito è 400M.

--force, -f

Non verificare l'esistenza dei riferimenti configmap e secret specificati. I riferimenti alle configmap sono specificati con l'opzione --env-from-configmap. I riferimenti segreti sono specificati con le opzioni --env-from-secret o --registry-secret. Questo valore è facoltativo. Il valore predefinito è false.

--image, -i

Il nome dell'immagine utilizzata per l'esecuzione del lavoro. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove REGISTRY e TAG sono facoltativi. Se non viene specificato REGISTRY, il valore predefinito è docker.io. Se non viene specificato TAG, il valore predefinito è latest. L'opzione "image" è obbligatoria se non viene specificata l'opzione " --build-source ". Questo valore è facoltativo.

--maxexecutiontime, --met

Il tempo massimo di esecuzione in secondi per le esecuzioni del lavoro. Questa opzione può essere specificata solo se mode è task. Questo valore è facoltativo. Il valore predefinito è 7200.

--memory, -m

La quantità di memoria impostata per l'esecuzione del lavoro. Utilizza M per i megabyte o G per i gigabyte. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 4G.

--mode

La modalità per le esecuzioni del lavoro. I valori validi sono task e daemon. Nella modalità " task ", si applicano le opzioni " maxexecutiontime " e " retrylimit ". Nella mod daemon, poiché non è previsto alcun timeout e le istanze che presentano errori vengono riavviate all’infinito, le opzioni --maxexecutiontime e --retrylimit non sono consentite. Questo valore è facoltativo. Il valore predefinito è task.

--mount-configmap, --mount-cm

Aggiungere il contenuto di una configmap al file system delle esecuzioni del lavoro fornendo una directory di montaggio e il nome di una configmap, con il formato MOUNT_DIRECTORY=CONFIGMAP_NAME. Ogni configmap montata deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nella configmap, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-configmap ; ad esempio, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Questo valore è facoltativo.

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-secret, --mount-sec

Aggiungere il contenuto di un segreto al file system delle esecuzioni del lavoro fornendo una directory di montaggio e il nome di un segreto, con il formato MOUNT_DIRECTORY=SECRET_NAME. Ogni segreto montato deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nel segreto, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-secret ; ad esempio, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Questo valore è facoltativo.

--no-wait, --nw

Non attendere il completamento dell'esecuzione di build. Se si specifica l'opzione --no-wait, l'esecuzione della compilazione inizia senza aspettare. Usare il comando buildrun get per controllare lo stato di esecuzione della compilazione. L'opzione no-wait è consentita solo se è impostata l'opzione --build-source. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

--retrylimit, -r

Il numero di volte per cui rieseguire un'istanza del lavoro prima che il lavoro sia contrassegnato come non riuscito. Un indice di matrice di un lavoro viene rieseguito quando fornisce un codice di uscita diverso da zero. Questa opzione può essere specificata solo se mode è task. Questo valore è facoltativo. Il valore predefinito è 3.

--service-account, --sa

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per l'esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--wait, -w

Attendere il completamento dell'esecuzione della build. Se si specifica l'opzione --wait, l'esecuzione della compilazione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il completamento della compilazione. Se l'esecuzione della compilazione non viene completata entro il periodo specificato da --wait-timeout, l'esecuzione della compilazione fallisce. L'opzione wait è consentita solo se l'opzione --build-source è impostata. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

L'intervallo di tempo in secondi di attesa per il completamento dell'esecuzione della build. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. L'opzione wait-timeout è consentita solo se è impostata l'opzione --build-source. Il valore predefinito è 600.

Esempio

L'esempio seguente utilizza l'immagine del contenitore icr.io/codeengine/firstjob e assegna al contenitore 2G MB di memoria e 1 CPU. Per ulteriori informazioni sulla selezione di valori validi di memoria e CPU, vedere Combinazioni di memoria e CPU supportate.

ibmcloud ce job create --image icr.io/codeengine/firstjob --name hellojob --memory 2G --cpu 1

Output di esempio

Creating job 'hellojob'...
OK

`ibmcloud ce job delete`

Eliminare un lavoro e le relative esecuzioni.

ibmcloud ce job delete --name JOB_NAME [--force] [--ignore-not-found] [--orphan-job-runs] [--quiet]

Opzioni di comando

--name, -n: Il nome del lavoro. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--orphan-job-runs, -o: Specificare per mantenere qualsiasi esecuzione di lavoro associata a questa configurazione di lavoro. Questi lavori orfani devono essere eliminati separatamente. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce job delete --name hello

Output di esempio

Are you sure you want to delete job hello? [y/N]> y
Deleting job 'hello'...
OK

Quando si esegue il ibmcloud ce job delete per eliminare un lavoro, vengono eliminate anche tutte le esecuzioni del lavoro inviate che fanno riferimento a tale lavoro.

`ibmcloud ce job get`

Visualizza i dettagli di un lavoro.

ibmcloud ce job get --name JOB_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome del lavoro. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce job get --name hellojob

Output di esempio

Getting job 'hellojob'...
OK
Name:          hellojob
ID:            abcdabcd-abcd-abcd-abcd-abcdabcd1111
Project Name:  myproj
Project ID:    01234567-abcd-abcd-abcd-abcdabcd2222
Age:           59s
Created:       2021-03-01T15:33:30-05:00
Last Job Run:
  Name:     hellojob-jobrun-abcde
  Age:      32d
  Created:  2021-06-06T13:52:42-04:00
Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:     1
    Memory:  4G
Runtime:
    Mode:                  task
    Array Indices:         0
    Array Size:            1
    Max Execution Time:    7200
    Retry Limit:           3

`ibmcloud ce job list`

Elenca tutte le attività di un progetto.

ibmcloud ce job list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce job list

Output di esempio

Name           Age   Last Job Run Name      Last Job Run Age
demo           110d  demo-jobrun-hkkmx      108d
myjob-envvar   107d
hellojob       7s
myjob          60d   myjob-977v7            58d
testjob        88d   testjob-jobrun-kzxlp   72d

`ibmcloud ce job unbind`

Disaccoppia le istanze del servizio IBM Cloud da un lavoro per rimuovere i collegamenti esistenti.

ibmcloud ce job unbind --name JOB_NAME (--binding BINDING_NAME | --all) [--quiet]

Opzioni di comando

--name, -n: Il nome del processo da scollegare. Questo campo è obbligatorio.
--all, -A: Rimuove il collegamento di tutte le istanze di servizio relative a questo processo. Questo valore è necessario se --binding non è specificato. Il valore predefinito è false.
--binding, -b: Il nome del collegamento da rimuovere. Esegui il comando ibmcloud ce job get -n JOB_NAME per visualizzare i nomi dei binding. Questo valore è necessario se --all non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

In questo esempio, si rimuovono tutti i binding dal lavoro chiamato hello.

ibmcloud ce job unbind --name hello --all

Output di esempio

Removing service bindings...
OK

`ibmcloud ce job update`

Aggiornare un lavoro.

ibmcloud ce job update --name JOB_NAME [--argument ARGUMENT] [--arguments-clear] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--build-clear] [--build-commit BUILD_COMMIT] [--build-commit-clear] [--build-context-dir BUILD_CONTEXT_DIR] [--build-dockerfile BUILD_DOCKERFILE] [--build-git-repo-secret BUILD_GIT_REPO_SECRET] [--build-git-repo-secret-clear] [--build-size BUILD_SIZE] [--build-source BUILD_SOURCE] [--build-strategy BUILD_STRATEGY] [--build-timeout BUILD_TIMEOUT] [--command COMMAND] [--commands-clear] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--image IMAGE] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--rebuild] [--registry-secret REGISTRY_SECRET] [--registry-secret-clear] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n

Il nome del lavoro. Questo campo è obbligatorio.

--argument, --arg, -a

Imposta gli argomenti per l'esecuzione del lavoro. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore è facoltativo.

--arguments-clear, --ac

Cancellare gli argomenti del lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--array-indexes, --array-indices, --ai

--array-size, --as, --instances, --is

--build-clear, --bc

Rimuovere l'associazione di una build da questo lavoro. L'opzione Cancella build è consentita solo se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-commit, --commit, --bcm, --cm, --revision

Il commit, tag o ramo nel repository di origine di cui eseguire il pull. L'opzione build commit è consentita solo se l'opzione --build-source è impostata su URL di un repository Git su questo comando job update, oppure se il lavoro ha attualmente una build associata da un repository Git. Questo valore è facoltativo.

--build-commit-clear, --commit-clear, --bcmc, --cmc

Cancellare il commit, il tag o il ramo nel repository di origine di cui eseguire il pull. L'opzione di cancellazione del commit è consentita solo se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-context-dir, --context-dir, --bcdr, --cdr

La directory nel repository che contiene il file buildpacks o il Dockerfile. L'opzione della directory del contesto di compilazione è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una compilazione associata. Questo valore è facoltativo.

--build-dockerfile, --dockerfile, --bdf, --df

Il percorso al Dockerfile. Specificare questa opzione solo se il nome è diverso da Dockerfile. L'opzione build dockerfile è consentita se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è Dockerfile.

--build-git-repo-secret, --git-repo-secret, --bgrs, --grs, --repo

Il nome del segreto SSH, contenente le credenziali per accedere al repository privato che contiene il codice sorgente per creare la propria immagine del contenitore. Per creare questo segreto SSH, utilizzare il comando secret create --format SSH. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Questa opzione è consentita solo se l'opzione --build-source è impostata su URL di un repository Git su questo comando job update o se il lavoro ha attualmente una compilazione associata da una fonte di repository Git. Questo valore è facoltativo.

--build-git-repo-secret-clear, --git-repo-secret-clear, --bgrsc, --grsc

Cancella il segreto SSH. Questa opzione è consentita se il lavoro ha attualmente una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--build-size, --size, --bsz, --sz

La dimensione della build, che determina la quantità di risorse utilizzate. I valori validi sono small, medium, large, xlarge e xxlarge. Per ulteriori informazioni, vedere Determinazione delle dimensioni della build. L'opzione di dimensione della build è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è medium.

--build-source, --source, --bsrc, --src

URL del repository Git o il percorso del sorgente locale che contiene il codice sorgente; ad esempio https://github.com/IBM/CodeEngine o .. Questo valore è facoltativo.

--build-strategy, --strategy, --bstr, --str

La strategia da utilizzare per il build dell'immagine. I valori validi sono dockerfile e buildpacks. L'opzione strategia di compilazione è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una compilazione associata. Se non è specificato, la strategia di compilazione è determinata da Code Engine se --build-source è specificato e il sorgente è sulla macchina locale. Questo valore è facoltativo. Il valore predefinito è dockerfile.

--build-timeout, --bto

La quantità di tempo, in secondi, che può trascorrere prima che la costruzione abbia successo o fallisca. L'opzione di timeout della compilazione è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una compilazione associata. Questo valore è facoltativo. Il valore predefinito è 600.

--command, --cmd, -c

--commands-clear, --cc

Cancella i comandi di lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--cpu

La quantità di CPU da impostare per l'esecuzione del lavoro. Questo valore aggiorna qualsiasi valore di --cpu assegnato nel lavoro. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 0.

--env, -e

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-from-configmap-rm, --env-cm-rm: Rimuove i riferimenti delle variabili d'ambiente alle configmap complete usando il nome della configmap. Per rimuovere i riferimenti a singole chiavi delle configmap, usare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-sec, --env-from-secret

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--env-from-secret-rm, --env-sec-rm: Rimuovere i riferimenti delle variabili d'ambiente ai segreti completi utilizzando il nome del segreto. Per rimuovere i riferimenti a singole chiavi di segreti, utilizzare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-rm

--ephemeral-storage, --es

La quantità di memoria temporanea da impostare per le esecuzioni del processo. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo.

--force, -f

--image, -i

--maxexecutiontime, --met

--memory, -m

--mode

--mount-configmap, --mount-cm

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-rm

Rimuove il contenuto di una configmap o di un secret dal file system delle esecuzioni del lavoro, specificando la directory in cui è montata la configmap o il secret. Specificare una directory di montaggio per ogni opzione --mount-rm ; ad esempio, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Questo valore è facoltativo.

--mount-secret, --mount-sec

--no-wait, --nw

Non attendere il completamento dell'esecuzione di build. Se si specifica l'opzione --no-wait, l'esecuzione della compilazione inizia senza aspettare. Usare il comando buildrun get per controllare lo stato di esecuzione della compilazione. L'opzione no-wait è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--rebuild

Creare nuovamente l'immagine dall'origine. L'opzione di ricostruzione è consentita se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

--registry-secret-clear, --rsc

Cancella il segreto del registro. Questo valore è facoltativo. Il valore predefinito è false.

--retrylimit, -r

--service-account, --sa

--service-account-clear, --sac

Cancellare l'account di servizio. Questo valore è facoltativo. Il valore predefinito è false.

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per l'esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--wait, -w

Attendere il completamento dell'esecuzione della build. Se si specifica l'opzione --wait, l'esecuzione della compilazione attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il completamento della compilazione. Se l'esecuzione della compilazione non viene completata entro il periodo specificato da --wait-timeout, l'esecuzione della compilazione fallisce. L'opzione wait è consentita solo se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una build associata. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

L'intervallo di tempo in secondi di attesa per il completamento dell'esecuzione della build. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. L'opzione wait-timeout è consentita se l'opzione --build-source è impostata su questo comando job update o se il lavoro ha una build associata. Il valore predefinito è 600.

Esempio

ibmcloud ce job update --name hellojob --cpu 2

Output di esempio

Updating job 'hellojob'...
OK

Comandi Jobrun

Un lavoro esegue in parallelo una o più istanze del codice eseguibile. A differenza delle applicazioni, che gestiscono le richieste di HTTP, i lavori sono progettati per essere eseguiti una sola volta e poi terminati. Quando si crea un lavoro, è possibile specificare le informazioni di configurazione del carico di lavoro che vengono utilizzate ogni volta che il lavoro viene eseguito. Utilizzate i comandi di jobrun per eseguire le istanze del vostro lavoro.

Per utilizzare i comandi di jobrun è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con i lavori e le esecuzioni, vedere Esecuzione dei lavori.

Per visualizzare la guida CLI per i comandi jobrun, eseguire ibmcloud ce jobrun -h.

`ibmcloud ce jobrun delete`

Cancellare un'esecuzione di lavoro.

ibmcloud ce jobrun delete (--name JOBRUN_NAME | --job JOB_NAME) [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--job, -j: Utilizzare questa opzione per eliminare tutte le esecuzioni del lavoro specificato. L'opzione --job è necessaria se non si specifica il valore --name. Questo valore è facoltativo.
--name, -n: Il nome dell'esecuzione del lavoro da eliminare. L'opzione --name è necessaria se non si specifica il valore --job. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce jobrun delete --name myjobrun -f

Output di esempio

Deleting job run 'myjobrun'...
OK

`ibmcloud ce jobrun events`

Visualizzare gli eventi di sistema delle istanze di esecuzione lavoro. Gli eventi di sistema vengono conservati fino a 60 minuti.

ibmcloud ce jobrun events (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--output OUTPUT] [--quiet]

Opzioni di comando

--instance, -i: Il nome di una specifica istanza di esecuzione del lavoro. Usare il comando jobrun get per trovare il nome dell'istanza. Questo valore è necessario se --jobrun non è specificato.
--jobrun, -j, --name, -n: Visualizza gli eventi di tutte le istanze dell'esecuzione del lavoro specificato. Questo valore è necessario se --instance non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente visualizza le informazioni sugli eventi di sistema per tutte le istanze di un'esecuzione di lavoro specificata.

ibmcloud ce jobrun events --jobrun myjobrun

Output di esempio

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events for all instances of job run 'myjobrun'...
OK
myjobrun-1-0:
    Type     Reason                  Age  Source                  Messages
    Normal   Scheduled               49s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-1-0 to 10.240.64.136
    [...]
    Normal   Pulling                 34s  kubelet, 10.240.64.136  Pulling image "icr.io/codeengine/testjob"
myjobrun-2-0:
    Type    Reason     Age  Source                  Messages
    Normal  Scheduled  50s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    48s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"

Esempio di informazioni sugli eventi di sistema per un'istanza specifica di un lavoro eseguito

È inoltre possibile visualizzare le informazioni sugli eventi di sistema per un'istanza specifica di un lavoro eseguito utilizzando l'opzione --instance con il comando ibmcloud ce jobrun events del comando. Utilizzare il comando jobrun get per visualizzare i dettagli dell'esecuzione del lavoro, comprese le istanze in esecuzione dell'esecuzione del lavoro.

ibmcloud ce jobrun events --instance myjobrun-2-0

Esempio di output delle informazioni sugli eventi di sistema per l'istanza specificata di un'esecuzione di lavoro

Getting events for job run instance 'myjobrun-2-0'...
OK
myjobrun-2-0:
    Type    Reason     Age    Source                  Messages
    Normal  Scheduled  3m39s  default-scheduler       Successfully assigned 4svg40kna19/myjobrun-2-0 to 10.240.64.131
    Normal  Pulling    3m37s  kubelet, 10.240.64.131  Pulling image "icr.io/codeengine/testjob"
    Normal  Pulled     2m42s  kubelet, 10.240.64.131  Successfully pulled image "icr.io/codeengine/testjob"
    Normal  Created    2m42s  kubelet, 10.240.64.131  Created container myjobrun
    Normal  Started    2m41s  kubelet, 10.240.64.131  Started container myjobrun

`ibmcloud ce jobrun get`

Visualizza i dettagli dell'esecuzione di un lavoro.

ibmcloud ce jobrun get --name JOBRUN_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome dell'esecuzione del processo. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce jobrun get --name myjobrun

Output di esempio

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Getting events of jobrun 'myjobrun'...
Run 'ibmcloud ce jobrun events -n myjobrun' to get the system events of the job run instances.
Run 'ibmcloud ce jobrun logs -f -n myjobrun' to follow the logs of the job run instances.
OK
Name:          myjobrun
[...]
Created:       2021-03-02T10:31:13-05:00
Image:                icr.io/codeengine/firstjob
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Runtime:
    Mode:                  task
    Array Indices:         1-5
    Array Size:            5
    JOP_ARRAY_SIZE Value:  5
    Max Execution Time:    7200
    Retry Limit:           3
Status:
    Completed:          2m58s
    Instance Statuses:
        Succeeded:  5
    Conditions:
        Type      Status  Last Probe  Last Transition
    Pending   True    3m55s       3m55s
    Running   True    3m51s       3m51s
    Complete  True    2m58s       2m58s
Events:
    Type     Reason         Age                     Source                Messages
    [...]
    Normal   Updated        3m38s (x23 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"
    Normal   Updated        3m38s (x22 over 3m56s)  batch-job-controller  Updated JobRun "myjobrun"
Instances:
    Name           Running  Status     Restarts  Age
    myjobrun-1-0  0/1      Succeeded  0         3m58s
    myjobrun-2-0  0/1      Succeeded  0         3m58s
    myjobrun-3-0  0/1      Succeeded  0         3m57s
    myjobrun-4-0  0/1      Succeeded  0         3m58s
    myjobrun-5-0  0/1      Succeeded  0         3m58s

`ibmcloud ce jobrun list`

Elencare tutte le esecuzioni del lavoro in un progetto.

ibmcloud ce jobrun list [--job JOB] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--job, -j: Utilizzare questa opzione per visualizzare solo le esecuzioni del lavoro specificato. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce jobrun list

Output di esempio

Listing job runs...
OK
Name                         Failed  Pending  Requested  Running  Succeeded  Unknown  Age
firstjob-jobrun-shnj5        0       0        0          0        1          0        11d
myjob-jobrun-fji48           0       0        0          0        5          0        11d
myjob-jobrun-xeqc8           0       0        0          0        5          0        12d
myjobrun                     0       0        0          0        5          0        7m47s
mytestjob-jobrun-el0o8       0       0        0          0        1          0        11d
testjobrun                   0       0        0          0        5          0        11d

Il nome dell'esecuzione del processo indicato riporta il nome dell'esecuzione stessa e la revisione corrente della stessa.

`ibmcloud ce jobrun logs`

Visualizza i log delle istanze di esecuzione dei lavori.

ibmcloud ce jobrun logs (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--follow] [--output OUTPUT] [--quiet] [--raw] [--tail TAIL] [--timestamps]

Opzioni di comando

--follow, -f: Seguire i registri delle istanze di esecuzione dei lavori. Utilizzare questa opzione per trasmettere i log delle istanze di esecuzione dei lavori. Se si specifica l'opzione --follow, è necessario immettere Ctrl+C per terminare questo comando di log. Questo valore è facoltativo. Il valore predefinito è false.
--instance, -i: Il nome di una specifica istanza di esecuzione del lavoro. Usare il comando jobrun get per trovare il nome dell'istanza. Questo valore è necessario se --jobrun non è specificato.
--jobrun, -j, --name, -n: Visualizza i registri di tutte le istanze dell'esecuzione del lavoro specificato. Questo valore è necessario se --instance non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--raw, -r: Visualizza i registri senza le etichette delle istanze e dei contenitori. Questo valore è facoltativo. Il valore predefinito è false.
--tail, -t: Limita la visualizzazione dei log delle istanze di esecuzione del lavoro specificate a un numero massimo di righe recenti. Ad esempio, per visualizzare le ultime 3 righe dei log delle istanze di esecuzione del lavoro specificate, specificare --tail 3. Se questa opzione non viene specificata, vengono visualizzate tutte le righe dei registri delle istanze di esecuzione del lavoro specificate. Questo valore è facoltativo. Il valore predefinito è -1.
--timestamps, --ts: Includere i timestamp in ogni riga dell'output del log. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

L'esempio seguente visualizza i registri di un'istanza specifica di un lavoro eseguito. Utilizzare il comando jobrun get per ottenere il nome delle istanze di esecuzione del lavoro.

ibmcloud ce jobrun logs --instance myjobrun-3-0

Output di esempio

Getting logs for job run instance 'myjobrun-3-0'...
OK
myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3

Esempio di registri di tutte le istanze di un lavoro eseguito

L'esempio seguente visualizza i registri di tutte le istanze di un lavoro eseguito.

ibmcloud ce jobrun logs --jobrun myjobrun

Esempio di output dei log di tutte le istanze di un lavoro eseguito

Getting logs for all instances of job run 'myjobrun'...
Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
OK
myjobrun-1-0/myjobrun:
Hi from a batch job! My index is: 1
myjobrun-2-0/myjobrun:
Hi from a batch job! My index is: 2
myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3
myjobrun-4-0/myjobrun:
Hi from a batch job! My index is: 4
myjobrun-5-0/myjobrun:
Hi from a batch job! My index is: 5

`ibmcloud ce jobrun restart`

Riavviare le istanze dell'esecuzione lavoro in esecuzione.

ibmcloud ce jobrun restart (--instance JOBRUN_INSTANCE | --jobrun JOBRUN_NAME) [--quiet]

Opzioni di comando

--instance, -i: Il nome di una specifica istanza di esecuzione del lavoro. Usare il comando jobrun get per trovare il nome dell'istanza. Questo valore è necessario se --jobrun non è specificato.
--jobrun, -j, --name, -n: Riavviare tutte le istanze dell'esecuzione lavoro specificata in esecuzione. Questo valore è necessario se --instance non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce jobrun restart --name myjobrun

Output di esempio

Getting jobrun 'myjobrun'...
Getting instances of jobrun 'myjobrun'...
Restarting all running instances of job run 'myjobrun'...
OK

`ibmcloud ce jobrun resubmit`

Ripresenta un'esecuzione di lavoro in base alla configurazione di un'esecuzione precedente.

ibmcloud ce jobrun resubmit --jobrun REFERENCED_JOBRUN_NAME [--argument ARGUMENT] [--arguments-clear] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--array-size-var-override ARRAY_SIZE_VAR_OVERRIDE] [--command COMMAND] [--commands-clear] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-configmap-rm ENV_FROM_CONFIGMAP_RM] [--env-from-secret ENV_FROM_SECRET] [--env-from-secret-rm ENV_FROM_SECRET_RM] [--env-rm ENV_RM] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-rm MOUNT_RM] [--mount-secret MOUNT_SECRET] [--name NAME] [--no-wait] [--output OUTPUT] [--quiet] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--service-account-clear] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--jobrun, -j

Il nome del lavoro precedente su cui si basa questo lavoro. Questo campo è obbligatorio.

--argument, --arg, -a

Imposta gli argomenti per l'esecuzione del lavoro. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore è facoltativo.

--arguments-clear, --ac

Cancella gli argomenti dell'esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--array-indexes, --array-indices, --ai

Specifica gli indici delle istanze utilizzate per l'esecuzione di questo processo, ad esempio 0,3,6,9, 1-5,7-8,10. L'insieme dei risultati degli indici è limitato a 1000 voci. Questa opzione può essere specificata solo se non è stata specificata l'opzione " array-size ". Questo valore è facoltativo.

--array-size, --as, --instances, --is

Specifica il numero di istanze utilizzate per l'esecuzione di questo lavoro. Quando si utilizza questa opzione, il sistema converte i valori in indici di array. Ad esempio, se si specifica l'indirizzo instances, che corrisponde a 5, il sistema lo converte in array-indexes, che corrisponde a 0 - 4. Questa opzione può essere specificata solo se non è stata specificata l'opzione " --array-indexes ". Questo valore è facoltativo. Il valore predefinito è 0.

--array-size-var-override, --array-size-variable-override, --asvo

Specifica un valore personalizzato per la variabile d'ambiente JOB_ARRAY_SIZE . Per impostazione predefinita, la variabile d'ambiente JOB_ARRAY_SIZE è impostata sul valore array-size oppure sul numero di indici specificato tramite array-indexes``. Il valore della variabile d'ambiente JOB_ARRAY_SIZE non influisce sulla dimensione dell'array configurato. Usare questa opzione per imporre un valore costante di dimensione dell'array per gli scenari di ripetizione dei lavori, in cui solo alcune istanze di lavoro vengono inviate o ripresentate. Questo valore è facoltativo.

--command, --cmd, -c

Imposta i comandi per l'esecuzione di questo lavoro. Specificare un comando per ogni opzione --command ; ad esempio, --cmd cmdA --cmd cmdB. Questo valore sostituisce il comando predefinito specificato nell'immagine del contenitore. Questo valore è facoltativo.

--commands-clear, --cc

Cancella i comandi di esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--cpu

La quantità di CPU impostata per ciascun indice di array per questa esecuzione del lavoro. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo. Il valore predefinito è 0.

--env, -e

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-from-configmap-rm, --env-cm-rm: Rimuove i riferimenti delle variabili d'ambiente alle configmap complete usando il nome della configmap. Per rimuovere i riferimenti a singole chiavi delle configmap, usare l'opzione --env-rm. Questo valore è facoltativo.

--env-sec, --env-from-secret

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--env-from-secret-rm, --env-sec-rm: Rimuovere i riferimenti delle variabili d'ambiente ai segreti completi utilizzando il nome del segreto. Per rimuovere i riferimenti a singole chiavi di segreti, utilizzare l'opzione --env-rm. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--env-rm

--ephemeral-storage, --es

La quantità di memoria effimera per questa esecuzione del lavoro. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo.

--force, -f

Non verificare l'esistenza dei riferimenti configmap e secret specificati. I riferimenti alle configmap sono specificati con l'opzione --env-from-configmap. I riferimenti segreti sono specificati con l'opzione --env-from-secret. Questo valore è facoltativo. Il valore predefinito è false.

--maxexecutiontime, --met

Il tempo massimo di esecuzione, in secondi, per questa esecuzione del lavoro. Questa opzione può essere specificata solo se mode è task. Questo valore è facoltativo. Il valore predefinito è 7200.

--memory, -m

La quantità di memoria da assegnare a questa esecuzione del lavoro. Utilizza M per i megabyte o G per i gigabyte. Per i valori validi, vedere Combinazioni di memoria e CPU supportate. Questo valore è facoltativo.

--mode

La modalità dell'esecuzione del lavoro. I valori validi sono task e daemon. Nella modalità " task ", si applicano le opzioni " maxexecutiontime " e " retrylimit ". Nella mod daemon, poiché non è previsto alcun timeout e le istanze che presentano errori vengono riavviate all’infinito, le opzioni maxexecutiontime e retrylimit non sono consentite. Questo valore è facoltativo.

--mount-configmap, --mount-cm

Aggiungere il contenuto di una configmap al file system di questo lavoro, fornendo una directory di montaggio e il nome di una configmap, con il formato MOUNT_DIRECTORY=CONFIGMAP_NAME. Ogni configmap montata deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nella configmap, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-configmap ; ad esempio, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b. Questo valore è facoltativo.

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-rm

Rimuove il contenuto di una configmap o di un secret dal file system di questa esecuzione del lavoro, specificando la directory in cui è montata la configmap o il secret. Specificare una directory di montaggio per ogni opzione --mount-rm ; ad esempio, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b. Questo valore è facoltativo.

--mount-secret, --mount-sec

Aggiungere il contenuto di un segreto al file system di questa esecuzione del lavoro fornendo una directory di montaggio e il nome di un segreto, con il formato MOUNT_DIRECTORY=SECRET_NAME. Ogni segreto montato deve utilizzare una directory di montaggio unica. Per ogni coppia chiave-valore nel segreto, viene aggiunto un file alla directory di montaggio specificata, dove il nome del file è la chiave e il contenuto del file è il valore della coppia chiave-valore. Specificare una configurazione di montaggio per ogni opzione --mount-secret ; ad esempio, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b. Questo valore è facoltativo.

-n, --name

Il nome dell'esecuzione del lavoro. Questo valore è necessario se il lavoro di riferimento non ha una configurazione di lavoro correlata. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da un massimo di 53 caratteri e può contenere lettere minuscole, numeri e trattini (-).

Questo valore è facoltativo.

--no-wait, --nw: Ripresentare l'esecuzione del lavoro e non attendere il completamento delle istanze di questa esecuzione del lavoro. Se si specifica l'opzione --no-wait, l'esecuzione del lavoro di ripresentazione inizia senza attendere. Utilizzare il comando jobrun get per verificare lo stato di esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è true.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--retrylimit, -r

Il numero di volte per cui rieseguire un'istanza di questo lavoro prima che il lavoro sia contrassegnato come non riuscito. Un indice di matrice di un lavoro eseguito viene rieseguito quando fornisce un codice di uscita diverso da zero. Questa opzione può essere specificata solo se mode è task. Questo valore è facoltativo. Il valore predefinito è 3.

--service-account, --sa

--service-account-clear, --sac

Cancellare l'account di servizio. Questo valore è facoltativo. Il valore predefinito è false.

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per le istanze di questo lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--wait, -w

Ripresentare l'esecuzione del lavoro e attendere il completamento delle istanze di questa esecuzione del lavoro. Se si specifica l'opzione --wait, l'esecuzione del lavoro ripresentato attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il completamento dell'esecuzione del lavoro. Se l'esecuzione del lavoro non viene completata entro il periodo specificato da --wait-timeout, la ripresentazione del lavoro fallisce. Questo valore è facoltativo. Il valore predefinito è false.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché le istanze di questa esecuzione del processo vengano completate. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

L'esempio seguente esegue nuovamente il lavoro myjobrun per le istanze 4-5. Il nome dell'esecuzione del lavoro ripresentato è myjobresubmit.

ibmcloud ce jobrun resubmit --name myjobresubmit --jobrun myjobrun --array-indices 4-5

Output di esempio

Getting job run 'myjobrun'...
Rerunning job run 'myjobresubmit'...
Run 'ibmcloud ce jobrun get -n myjobresubmit' to check the job run status.
OK

`ibmcloud ce jobrun submit`

Invia un'esecuzione basata su un lavoro.

ibmcloud ce jobrun submit ((--name JOBRUN_NAME --image IMAGE) | (--job JOB_NAME [--name JOBRUN_NAME])) [--argument ARGUMENT] [--array-indexes ARRAY_INDEXES] [--array-size ARRAY_SIZE] [--array-size-var-override ARRAY_SIZE_VAR_OVERRIDE] [--command COMMAND] [--cpu CPU] [--env ENV] [--env-from-configmap ENV_FROM_CONFIGMAP] [--env-from-secret ENV_FROM_SECRET] [--ephemeral-storage EPHEMERAL_STORAGE] [--force] [--maxexecutiontime MAXEXECUTIONTIME] [--memory MEMORY] [--mode MODE] [--mount-configmap MOUNT_CONFIGMAP] [--mount-data-store MOUNT_DATA_STORE] [--mount-secret MOUNT_SECRET] [--no-wait] [--output OUTPUT] [--quiet] [--registry-secret REGISTRY_SECRET] [--retrylimit RETRYLIMIT] [--service-account SERVICE_ACCOUNT] [--trusted-profiles-enabled] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--argument, --arg, -a

Imposta gli argomenti per l'esecuzione del lavoro. Specificare un argomento per ogni opzione --argument ; ad esempio, -a argA -a argB. Questo valore è facoltativo.

--array-indexes, --array-indices, --ai

--array-size, --as, --instances, --is

--array-size-var-override, --array-size-variable-override, --asvo

--command, --cmd, -c

--cpu

--env, -e

--env-cm, --env-from-configmap

Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in questa mappa di configurazione utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di una mappa di configurazione denominata configmapName, usare il valore configmapName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento alla mappa di configurazione. Per specificare un prefisso, utilizzare il valore PREFIX=CONFIGMAP_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nella configmap configmapName su CUSTOM_, utilizzare il valore CUSTOM_=configmapName. Se la configmap configmapName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Per esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in una configmap che si chiama configmapName, usare il valore configmapName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in una configmap denominata configmapName, utilizzare il valore configmapName:myKey=key1.

Questo valore è facoltativo.

--env-sec, --env-from-secret: Impostare le variabili d'ambiente dalle coppie chiave-valore memorizzate in un segreto utilizzando uno dei seguenti modi:

Per aggiungere variabili d'ambiente per tutte le chiavi di un segreto che si chiama secretName, usare il valore secretName. È possibile modificare i nomi delle variabili d'ambiente specificando un prefisso quando si fa riferimento al segreto. Per specificare un prefisso, utilizzare il valore PREFIX=SECRET_NAME. Ogni variabile d'ambiente risultante ha il formato <PREFIX><NAME_OF_KEY_IN_SECRET>. Ad esempio, per impostare il prefisso per tutti i nomi delle variabili delle chiavi nel segreto secretName su CUSTOM_, utilizzare il valore CUSTOM_=secretName. Se il segreto secretName contiene KEY_A, il nome della variabile d'ambiente è CUSTOM_KEY_A.
Per aggiungere variabili d'ambiente per singole chiavi, utilizzare il formato NAME:KEY_A,KEY_B. Ad esempio, per aggiungere una variabile d'ambiente per una singola chiave key1 in un segreto che si chiama secretName, utilizzare il valore secretName:key1. Per assegnare un nome diverso a un tasto di riferimento, utilizzare il formato NAME:NEW_NAME=KEY_A. Ad esempio, per aggiungere una variabile d'ambiente denominata myKey per una singola chiave key1 in un segreto denominato secretName, utilizzare il valore secretName:myKey=key1.

Questo valore è facoltativo.

--ephemeral-storage, --es: La quantità di memoria effimera per questa esecuzione del lavoro. Utilizza M per i megabyte o G per i gigabyte. Questo valore è facoltativo. Il valore predefinito è 400M.

--force, -f

--image, -i

Il nome dell'immagine utilizzata per l'esecuzione di questo processo. Il formato è REGISTRY/NAMESPACE/REPOSITORY:TAG, dove REGISTRY e TAG sono facoltativi. Se non viene specificato REGISTRY, il valore predefinito è docker.io. Se non viene specificato TAG, il valore predefinito è latest. Se non si specifica l'opzione --job, sono necessari i valori --name e --image. Questo valore è facoltativo.

--job, -j

Il nome della configurazione del lavoro. Visualizzare le configurazioni dei lavori con il comando job list. Se si specifica il valore --job, è possibile specificare facoltativamente il valore --name. Se non si specifica il valore --job, è necessario specificare i valori --name e --image. Questo valore è facoltativo.

--maxexecutiontime, --met

--memory, -m

--mode

--mount-configmap, --mount-cm

--mount-data-store, --mount-ds

Montare un datastore persistente. Il formato è MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. Il SUBPATH è facoltativo. Questa opzione può essere specificata più volte. Questo valore è facoltativo.

--mount-secret, --mount-sec

-n, --name

Il nome dell'esecuzione del lavoro. Se non si specifica il valore --job, sono necessari i valori --name e --image. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da un massimo di 53 caratteri e può contenere lettere minuscole, numeri e trattini (-).

Questo valore è facoltativo.

--no-wait, --nw: Inviare l'esecuzione del lavoro e non attendere il completamento delle istanze di questa esecuzione del lavoro. Se si specifica l'opzione --no-wait, l'invio dell'esecuzione del lavoro inizia senza attendere. Utilizzare il comando jobrun get per verificare lo stato di esecuzione del lavoro. Questo valore è facoltativo. Il valore predefinito è true.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--registry-secret, --rs

--retrylimit, -r

--service-account, --sa

--trusted-profiles-enabled, --trusted, --tpe

Abilita il montaggio di un token di risorsa di calcolo per le istanze di questo lavoro. Questo valore è facoltativo. Il valore predefinito è false.

--wait, -w

Inviare l'esecuzione del lavoro e attendere il completamento delle istanze di questa esecuzione del lavoro. Se si specifica l'opzione --wait, l'invio dell'esecuzione del lavoro attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il completamento dell'esecuzione del lavoro. Se l'esecuzione del lavoro non viene completata entro il periodo specificato da --wait-timeout, l'invio del lavoro fallisce. Questo valore è facoltativo. Il valore predefinito è false.

--wait-timeout, --wto

Esempio

ibmcloud ce jobrun submit --name myjobrun --image icr.io/codeengine/firstjob --array-indices 1-5

Output di esempio

Submitting job run 'myjobrun'...
Run 'ibmcloud ce jobrun get -n myjobrun' to check the job run status.
OK

Comandi di Persistentdatastore

Gestire i datastore persistenti.

`ibmcloud ce persistentdatastore create`

Creare un datastore persistente.

ibmcloud ce persistentdatastore create --name NAME --cos-access-secret SECRET_NAME --cos-bucket-name BUCKET_NAME [--cos-bucket-location BUCKET_LOCATION] [--quiet]

Opzioni di comando

--cos-access-secret, --cos-sec: Obbligatorio. Il nome del secret che contiene le credenziali per accedere all'istanza COS. Questo campo è obbligatorio.
--cos-bucket-name, --cos-bucket: Obbligatorio. Il nome del bucket COS. Questo campo è obbligatorio.
--name, -n: Obbligatorio. Il nome del datastore persistente. Utilizzare un nome univoco all'interno del progetto. Questo campo è obbligatorio.
--cos-bucket-location, --cos-loc: La posizione del bucket COS. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce persistentdatastore create --name my-pds-2 --cos-bucket-name my-test-bucket-2 --cos-access-secret my-hmac-secret-2

Output di esempio

Successfully created persistent data store named 'my-pds-2'.
OK

`ibmcloud ce persistentdatastore delete`

Eliminare un datastore persistente.

ibmcloud ce persistentdatastore delete --name PERSISTENT_DATA_STORE_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Obbligatorio. Nome del datastore persistente. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce persistentdatastore delete --name my-pds-3 -f

Output di esempio

Deleting persistent data store 'my-pds-3'...
OK

`ibmcloud ce persistentdatastore get`

Visualizzare i dettagli di un datastore persistente.

ibmcloud ce persistentdatastore get --name NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Obbligatorio. Il nome del datastore persistente. Questo campo è obbligatorio.
--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce persistentdatastore get --name my-pds-2

Output di esempio

Getting persistent data store 'my-pds-2'...
OK
Name:          my-pds-2  
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  
Type:          object_storage  
Created:       Fri, 11 Jul 2025 13:52:30 +0200  
Age:           103s  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Data:    
  COS bucket:     my-test-bucket-2  
  Access secret:  my-hmac-secret-2  
  Bucket region:  eu-de

`ibmcloud ce persistentdatastore list`

Elencare tutti i datastore persistenti presenti in un progetto.

ibmcloud ce persistentdatastore list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Formato di output. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

Questo comando elenca tutti gli archivi di dati persistenti in un progetto.

ibmcloud ce persistentdatastore list

Output di esempio

Listing persistent data stores...
OK
Name                       COS bucket          Access secret     Bucket region  Age  
my-pds-1                   my-test-bucket-1    my-hmac-secret-1  eu-gb          36d  
my-pds-2                   my-test-bucket-2    my-hmac-secret-2  eu-de          86s  
my-pds-3                   my-test-bucket-3    my-hmac-secret-3  us-south       6m30s

Comandi del progetto

Utilizzate i comandi di project per creare, elencare, eliminare e selezionare un progetto come contesto corrente.

Un progetto è un insieme di entità di Code Engine, quali applicazioni, funzioni, processi, flotte e build. Un progetto è basato su uno spazio dei nomi Kubernetes. Il nome del progetto deve essere univoco all'interno del gruppo di risorse, dell'account utente e della regione di IBM Cloud®. I progetti servono a gestire le risorse e a fornire accesso alle relative entità.

Un progetto offre le seguenti funzionalità:

Uno spazio dei nomi univoco per i nomi delle entità.
Gestione degli accessi in entrata alle risorse del progetto.
Gestione degli accessi in uscita ai servizi di supporto, ai registri e agli archivi.
Un certificato generato automaticamente per il servizio a livello di trasporto ( TLS ).

Per ulteriori informazioni sul lavoro con i progetti, vedere Gestione dei progetti.

È possibile utilizzare project o proj nei comandi di project. Per visualizzare la guida CLI per i comandi project, eseguire ibmcloud ce proj -h.

`ibmcloud ce project create`

Crea un progetto.

ibmcloud ce project create --name PROJECT_NAME [--endpoint ENDPOINT] [--no-select] [--no-wait] [--output OUTPUT] [--quiet] [--tag TAG] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

-n, --name

Il nome del progetto. Utilizzate un nome unico per la vostra regione. Il nome deve essere composto da un massimo di 128 caratteri e può contenere:

Qualsiasi carattere Unicode o alfanumerico.
Solo questi caratteri speciali: spazi ( ), punti (.), due punti (:), trattini bassi (_) e trattini (-).

Questo campo è obbligatorio.

--endpoint, -e: Il punto finale del progetto. I valori validi sono public e private. Se l'opzione --endpoint non è specificata esplicitamente, il comportamento è determinato dal sistema. Se la CLI IBM Cloud è collegata a private.cloud.ibm.com, il progetto Code Engine si comporta come se --endpoint fosse private. Se la CLI IBM Cloud è collegata a cloud.ibm.com, il progetto Code Engine si comporta come se --endpoint fosse public. Questo valore è facoltativo.

--no-select, --ns

Non selezionare il progetto come contesto corrente dopo la creazione di questo progetto. Se non si seleziona questa opzione, il progetto viene selezionato automaticamente. Questo valore è facoltativo. Il valore predefinito è false.

--no-wait, --nw

Creare il progetto e non attendere che venga creato. Se si specifica l'opzione no-wait, la creazione del progetto inizia senza aspettare. Usate il comando project get per controllare lo stato del progetto. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--tag, -t

Un'etichetta da assegnare al progetto. L'etichetta deve essere composta da un massimo di 128 caratteri e può contenere lettere, numeri, spazi ( ), punti (.), due punti (:), caratteri di sottolineatura (_) e trattini (-). Specificare un'etichetta per ogni opzione --tag ; ad esempio, --tag tagA --tag tagB. Questo valore è facoltativo.

--wait, -w

Creare il progetto e attendere che venga creato. Se si specifica l'opzione --wait, la creazione del progetto attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per la creazione del progetto. Se il progetto non viene creato entro il periodo specificato da --wait-timeout, la creazione del progetto fallisce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere per la creazione del progetto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce project create --name myproject

Output di esempio

Creating project 'myproject'...
OK

`ibmcloud ce project current`

Visualizza i dettagli del progetto attualmente in corso.

ibmcloud ce project current [--output OUTPUT] [--quiet]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce project current

Output di esempio

Getting the current project context...
OK
Name:       myproject
ID:         01234567-abcd-abcd-abcd-abcdabcd1111
Subdomain:  aabon2dfwa0
Domain:     us-south.codeengine.appdomain.cloud
Region:     us-south
Kubectl Context:  4svg40kna19
Kubernetes Config:
Context:             aabon2dfwa0
Environment Variable: export KUBECONFIG=/user/myusername/.bluemix/plugins/code-engine/myproject-01234567-abcd-abcd-abcd-abcdabcd1111.yaml

`ibmcloud ce project delete`

Elimina un progetto.

ibmcloud ce project delete (--name PROJECT_NAME | --id PROJECT_ID) [--force] [--hard] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--hard: Cancellare immediatamente il progetto. Se non si specifica l'opzione --hard, il progetto può essere ripristinato entro 7 giorni usando il comando project restore o reclamation restore. Questo valore è facoltativo. Il valore predefinito è false.
--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--no-wait, --nw: Eliminare il progetto e non attendere che venga eliminato. Se si specifica l'opzione no-wait, l'eliminazione del progetto inizia senza aspettare. Usate il comando project get per controllare lo stato del progetto. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Elimina il progetto e attendi che venga eliminato. Se si specifica l'opzione --wait, l'eliminazione del progetto attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché il progetto venga eliminato. Se il progetto non viene eliminato entro il periodo specificato da --wait-timeout, l'eliminazione del progetto fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere prima che il progetto venga eliminato. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

ibmcloud ce project delete --name myproject -f

Output di esempio

Deleting project 'myproject'...
OK

`ibmcloud ce project get`

Visualizza i dettagli di un singolo progetto.

ibmcloud ce project get (--name PROJECT_NAME | --id PROJECT_ID) [--output OUTPUT] [--quiet]

Opzioni di comando

--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce project get --name myproject

Output di esempio

Getting project 'myproject'...
OK
Name:                                      myproject
ID:                                        abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
CRN:                                       crn:v1:bluemix:public:codeengine:au-syd:a/1a2b3c4d5e6f7g1a2b3c4d5e6f7g1234:abcdabcd-abcd-abcd-abcd-f1de4aab5d5d::
Status:                                    active
Enabled:                                   true
Application Private Visibility Supported:  true
Selected:                                  true
Tags:                                      tag1, tag2
Region:                                    us-south
Resource Group:                            default
Service Binding Service ID:                ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                                       52d
Created:                                   Mon, 30 Jun 2025 18:16:12 +0200
Updated:                                   Mon, 30 Jun 2025 18:16:58 +0200
Connectivity:    
  Outbound - Source IP addresses:                             
    Public internet  
    159.23.99.151  
    130.198.13.241  
    135.90.137.31  
    
    IBM Cloud private network  
    10.223.236.11  
    10.223.242.142  
    10.12.3.244  
  Inbound - Context-based restrictions for the data plane:    
    Enforcement status:         none  
    Public internet:            allowed  
    IBM Cloud private network:  allowed  
    Last applied:               Wed, 20 May 2026 15:52:02 +0200  
Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Custom domain mappings                    4          80
    Ephemeral storage                         5415750Ki  256G
    Functions                                 2          20
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Persistent data stores                    2          10
    Private path connections                  1          3
    Secrets                                   21         100
    Serverless fleets                         42         1000
    Subnet pools                              3          20
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

`ibmcloud ce project list`

Elencare tutti i progetti.

ibmcloud ce project list [--all-resource-groups] [--output OUTPUT] [--quiet] [--regions REGIONS] [--sort-by SORT_BY]

Opzioni di comando

--all-resource-groups, --all: Visualizza i progetti di tutti i gruppi di risorse. Per impostazione predefinita, i progetti vengono visualizzati solo dal gruppo di risorse corrente. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--regions, -r: Limita la visualizzazione dei progetti alle regioni specificate. Indicare il nome di una o più regioni; ad esempio, us-south,eu-de. Questo valore è facoltativo.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce project list

Output di esempio

Getting projects...
OK
Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      09768af4-abcd-abcd-abcd-24674ba90db0  active  false           eu-de     default         27d
myproject        cd09cfe1-abcd-abcd-abcd-0f8a8a1d0ddf  active  true            us-south  default         52d

`ibmcloud ce project restore`

Ripristinare un progetto.

ibmcloud ce project restore (--name PROJECT_NAME | --id PROJECT_ID) [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--no-wait, --nw: Ripristinare il progetto e non attendere il ripristino del progetto. Se si specifica l'opzione no-wait, il ripristino del progetto inizia senza aspettare. Usate il comando project get per controllare lo stato del progetto. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Ripristinare il progetto e attendere che venga ripristinato. Se si specifica l'opzione --wait, il ripristino del progetto attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il ripristino del progetto. Se il progetto non viene ripristinato entro il periodo specificato da --wait-timeout, il ripristino del progetto non riesce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché il progetto venga ripristinato. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

Questo esempio riporta allo stato attivo il progetto myproject che si trova nello stato soft deleted. Utilizzare il comando project list per visualizzare un elenco di tutti i progetti con il loro stato.

ibmcloud ce project restore --name myproject

Output di esempio

Restoring project 'myproject'...
OK

`ibmcloud ce project select`

Selezionare un progetto come contesto corrente. Il progetto deve essere in stato active prima di poter essere selezionato.

ibmcloud ce project select (--name PROJECT_NAME | --id PROJECT_ID) [--endpoint ENDPOINT] [--kubecfg] [--quiet]

Opzioni di comando

--endpoint, -e: Il punto finale del progetto. I valori validi sono public e private. Se l'opzione --endpoint non è specificata esplicitamente, il comportamento è determinato dal sistema. Se la CLI IBM Cloud è collegata a private.cloud.ibm.com, il progetto Code Engine si comporta come se --endpoint fosse private. Se la CLI IBM Cloud è collegata a cloud.ibm.com, il progetto Code Engine si comporta come se --endpoint fosse public. Questo valore è facoltativo.
--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--kubecfg, -k: Accodare il progetto al file di configurazione Kubernetes. È possibile sovrascrivere il file di configurazione predefinito Kubernetes impostando la variabile d'ambiente KUBECONFIG. Questo valore è facoltativo. Il valore predefinito è false.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce project select --name myproject

Output di esempio

Selecting project 'myproject'...
OK

`ibmcloud ce project tag`

Gestisce i tag di un singolo progetto.

ibmcloud ce project tag (--name PROJECT_NAME | --id PROJECT_ID) [--quiet] [--tag TAG] [--tag-rm TAG_RM]

Opzioni di comando

--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--tag, -t: Un'etichetta da assegnare al progetto. L'etichetta deve essere composta da un massimo di 128 caratteri e può contenere lettere, numeri, spazi ( ), punti (.), due punti (:), caratteri di sottolineatura (_) e trattini (-). Specificare un'etichetta per ogni opzione --tag ; ad esempio, --tag tagA --tag tagB. Questo valore è facoltativo.
--tag-rm, --trm: Rimuovere un'etichetta assegnata al progetto. Specificare un'etichetta per ogni opzione --tag-rm ; ad esempio, --tag-rm tagA --tag-rm tagB. Questo valore è facoltativo.

Esempio

ibmcloud ce project tag --name myproject --tag tag1 --tag tag2

Output di esempio

Getting project 'myproject'...
OK

`ibmcloud ce project update`

Aggiornare il progetto selezionato.

ibmcloud ce project update (--binding-service-id SERVICE_ID_ID | --binding-resource-group RESOURCE_GROUP_NAME | --binding-resource-group-id RESOURCE_GROUP_ID) [--quiet]

Opzioni di comando

--binding-resource-group, --brg: Il nome di un gruppo di risorse da utilizzare per l'autenticazione dei binding di servizio di questo progetto. Viene creato un ID servizio con i ruoli “ Operator ” e “ Manager ” per tutti i servizi presenti in questo gruppo di risorse. Usare "*" per specificare tutti i gruppi di risorse di questo account. Questo valore è facoltativo.
--binding-resource-group-id, --brgid: L'ID di un gruppo di risorse da utilizzare per l'autenticazione per i binding del servizio di questo progetto. Viene creato un ID servizio con i ruoli “ Operator ” e “ Manager ” per tutti i servizi presenti in questo gruppo di risorse. Questo valore è facoltativo.
--binding-service-id, --bsid: L'ID del servizio da utilizzare per l'autenticazione nei collegamenti di servizio di questo progetto. Questo ID servizio deve avere il ruolo Operator e un ruolo di servizio appropriato per una o più istanze di servizio, tipi di servizio o gruppi di risorse. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce project update --binding-service-id ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f

Output di esempio

Configuring your project for service bindings...
Creating service binding API key 'my-project-api-key' for service ID 'my-custom-service-id'...
OK

Comandi di bonifica

Gestire le bonifiche del progetto Code Engine. I progetti eliminati in modo soft possono essere ripristinati entro 7 giorni con il comando reclamation restore.

`ibmcloud ce reclamation delete`

Cancellare un progetto di bonifica.

ibmcloud ce reclamation delete (--name PROJECT_NAME | --id PROJECT_ID) [--force] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--no-wait, --nw: Cancellare la bonifica del progetto e non attendere che venga cancellata. Se si specifica l'opzione no-wait, l'eliminazione del progetto inizia senza aspettare. Utilizzare il comando reclamation get per verificare lo stato di bonifica del progetto. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Cancellare la bonifica del progetto e attendere che venga cancellata. Se si specifica l'opzione --wait, l'eliminazione del progetto attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per l'eliminazione del progetto. Se la bonifica del progetto non viene cancellata entro il periodo specificato da --wait-timeout, la cancellazione della bonifica del progetto fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere prima che la bonifica del progetto venga eliminata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

Questo esempio elimina definitivamente il progetto myproject che si trova nello stato soft deleted. Utilizzando l'opzione --force con questo comando, la cancellazione viene forzata senza conferma. È possibile utilizzare il comando reclamation list per visualizzare un elenco di tutti i progetti che si trovano nello stato soft deleted.

ibmcloud ce reclamation delete --name myproject --f

Output di esempio

Hard deleting project 'myproject'...
OK

`ibmcloud ce reclamation get`

Visualizza i dettagli della bonifica di un singolo progetto.

ibmcloud ce reclamation get (--name PROJECT_NAME | --id PROJECT_ID) [--output OUTPUT] [--quiet]

Opzioni di comando

--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce reclamation get --name myproject

Output di esempio

Getting project reclamation
OK
Name:                   myproject
Reclamation ID:         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
Status:                 soft deleted
Region:                 us-south
Resource Group:         default
Age:                    27m
Created:                Thu, 09 Sep 2021 13:24:15 -0400
Updated:                Thu, 09 Sep 2021 13:33:45 -0400
Time to Hard Deletion:  6d23h

`ibmcloud ce reclamation list`

Elencare tutte le bonifiche del progetto.

ibmcloud ce reclamation list [--all-resource-groups] [--output OUTPUT] [--quiet] [--regions REGIONS] [--sort-by SORT_BY]

Opzioni di comando

--all-resource-groups, --all: Visualizza le richieste di progetto di tutti i gruppi di risorse. Per impostazione predefinita, le bonifiche del progetto vengono visualizzate solo dal gruppo di risorse corrente. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--regions, -r: Limita la visualizzazione delle bonifiche dei progetti alle regioni specificate. Indicare il nome di una o più regioni; ad esempio, us-south,eu-de. Questo valore è facoltativo.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce reclamation list

Output di esempio

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

`ibmcloud ce reclamation restore`

Ripristino di un progetto di bonifica. I progetti eliminati in modo soft possono essere ripristinati entro 7 giorni con il comando reclamation restore.

ibmcloud ce reclamation restore (--name PROJECT_NAME | --id PROJECT_ID) [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--id, --guid: L'ID del progetto. Questo valore è necessario se --name non è specificato.
--name, -n: Il nome del progetto. Questo valore è necessario se --id non è specificato.
--no-wait, --nw: Ripristinare la bonifica del progetto e non attendere il ripristino della bonifica del progetto. Se si specifica l'opzione no-wait, il ripristino del progetto inizia senza aspettare. Utilizzare il comando reclamation get per verificare lo stato di bonifica del progetto. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Ripristinare la bonifica del progetto e attendere il ripristino della bonifica del progetto. Se si specifica l'opzione --wait, il ripristino della bonifica del progetto attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, per il ripristino della bonifica del progetto. Se la bonifica del progetto non viene ripristinata entro il periodo specificato da --wait-timeout, il ripristino della bonifica del progetto fallisce. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché il recupero del progetto venga ripristinato. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 600.

Esempio

Questo esempio riporta allo stato attivo il progetto myproject che si trova nello stato soft deleted. Utilizzare il comando reclamation list per visualizzare un elenco di tutti i progetti che si trovano nello stato soft deleted.

ibmcloud ce reclamation restore --name myproject

Output di esempio

Restoring project 'myproject'...
OK

comandi registro

Un registro dei container, o registro, è un servizio che memorizza le immagini dei container. Ad esempio, IBM Cloud Container Registry e Docker Hub sono registri di contenitori. Il registro dei container può essere pubblico o privato. Un registro di container pubblico non richiede credenziali di accesso. L'accesso a un registro privato richiede invece delle credenziali.

Per utilizzare i comandi di registry è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sull'accesso ai registri, vedere Aggiunta dell'accesso a un registro di contenitori privati.

Per visualizzare la guida CLI per i comandi registry, eseguire ibmcloud ce registry -h.

A partire dalla versione 1.42.0, la definizione e l'utilizzo dei segreti nella CLI sono unificati nel gruppo di comandi secret del gruppo di comandi. Vedere ibmcloud ce secret comandi. Utilizzare l'opzione --format per specificare la categoria del segreto, ad esempio basic_auth, generic, hmac, ssh, tls, o registry. Sebbene sia possibile continuare a utilizzare il gruppo di comando registry gruppo di comando, è possibile sfruttare il gruppo di comando unificato secret gruppo di comando unificato. Per creare un segreto per accedere al registro di un contenitore, usare il comando ibmcloud ce secret create --format registry il comando. Per saperne di più su come lavorare con i segreti in Code Engine, vedere Lavorare con i segreti.

`ibmcloud ce registry create`

Creare un segreto di accesso al registro immagini.

ibmcloud ce registry create --name NAME (--password PASSWORD | --password-from-file PASSWORD_FILE | --password-from-json-file) [--email EMAIL] [--output OUTPUT] [--quiet] [--server SERVER] [--username USERNAME]

Opzioni di comando

-n, --name

Il nome della chiave di accesso al registro delle immagini. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--email, -e: L'indirizzo e-mail per accedere al server di registro. Questo valore è facoltativo.

--output, -o

--password, -p

La password per accedere al server di registro. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. Questo valore è facoltativo.

--password-from-file, --pf

Il percorso di un file contenente la password di accesso al server di registro. La prima riga del file viene utilizzata per la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. Questo valore è facoltativo.

--password-from-json-file, --pfj

Il percorso di un file JSON contenente la password di accesso al server del registro. Il campo " apikey " serve per inserire la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. Questo valore è facoltativo.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--server, -s

L'URL del server di registro. Questo valore è facoltativo. Il valore predefinito è us.icr.io.

--username, -u

Il nome utente per accedere al server di registro. Questo valore è facoltativo. Il valore predefinito è iamapikey.

Esempio

L'esempio seguente crea un accesso al registro immagini chiamato myregistry a un'istanza Container Registry che si trova all'indirizzo us.icr.io e utilizza un nome utente iamapikey e la chiave API IAM come password.

ibmcloud ce registry create --name myregistry --server us.icr.io --username iamapikey --password API_KEY

Output di esempio

Creating image registry access secret myregistry...
OK

`ibmcloud ce registry delete`

Eliminare un segreto di accesso al registro immagini.

ibmcloud ce registry delete --name NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome della chiave di accesso al registro delle immagini. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce registry delete --name myregistry -f

Output di esempio

Deleting image registry access secret myregistry...
OK

`ibmcloud ce registry get`

Visualizza i dettagli di un segreto di accesso al registro immagini.

ibmcloud ce registry get --name NAME [--decode] [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome della chiave di accesso al registro delle immagini. Questo campo è obbligatorio.
--decode, -d: Mostra l'output di Data come decodificato nei dettagli. Se questa opzione non viene specificata, i dettagli di Data sono base64-encoded. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce registry get --name myregistry

Output di esempio

Getting image registry access secret myregistry...
OK
Name:        myregistry
Project:     myproject
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Created:     2021-02-23T09:10:01-05:00
Data:
---
.dockerconfigjson: abcdabcdabcdabcdabcdnVzZXJuYW1lIjoiaWFtYXBpa2V5IiwicGFzc3dvcmQiOiJoQllTSTc5Uk8yQUIxSDV3RUs2UzhScV9uNzE4NkQ1eWt1M1FOUk85aFpfaCIsImVtYWlsIjoiYUBiLmMiLCabcdabcdabcdabcdabcdT21oQ1dWTkpOemxTVHpKQlFqRklOWGRGU3paVE9GSnhYMjQzTVRnMlJEVjabcdabcdabcdabcdabcdbG9XbDlvIn19fQ==

`ibmcloud ce registry list`

Elenca tutti i codici di accesso al registro delle immagini presenti in un progetto.

ibmcloud ce registry list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce registry list

Output di esempio

Listing image registry access secrets...
OK
Name        Age
myregistry  19m22s

`ibmcloud ce registry update`

Aggiornare un segreto di accesso al registro delle immagini.

ibmcloud ce registry update --name NAME [--email EMAIL] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--quiet] [--server SERVER] [--username USERNAME]

Opzioni di comando

--name, -n: Il nome della chiave di accesso al registro delle immagini. Questo campo è obbligatorio.
--email, -e: L'indirizzo e-mail per accedere al server di registro. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--password, -p: La password per accedere al server di registro. Questo valore è facoltativo.
--password-from-file, --pf: Il percorso di un file contenente la password di accesso al server di registro. La prima riga del file viene utilizzata per la password. Questo valore è facoltativo.
--password-from-json-file, --pfj: Il percorso di un file JSON contenente la password di accesso al server del registro. Il campo " apikey " serve per inserire la password. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--server, -s: L'URL del server di registro. Questo valore è facoltativo.
--username, -u: Il nome utente per accedere al server di registro. Questo valore è facoltativo.

Esempio

L'esempio seguente aggiorna una password per l'accesso al registro delle immagini che si chiama myregistry.

ibmcloud ce registry update --name myregistry --password NEW_API_KEY

Output di esempio

Getting image registry access secret 'myregistry'...
Updating image registry access secret 'myregistry'...
OK

Comandi di Repo

Un repository di codice, come GitHub o GitLab,, memorizza il codice sorgente. Con Code Engine è possibile aggiungere l'accesso a un repository di codice privato e quindi fare riferimento a tale repository dalla propria build.

Per utilizzare i comandi di repo è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sull'accesso ai repository, vedere Accesso ai repository di codice privato.

Per visualizzare la guida CLI per i comandi repo, eseguire ibmcloud ce repo -h.

A partire dalla versione 1.42.0, la definizione e l'utilizzo dei segreti nella CLI sono unificati nel gruppo di comandi secret del gruppo di comandi. Vedere ibmcloud ce secret comandi. Utilizzare l'opzione --format per specificare la categoria del segreto, ad esempio basic_auth, generic, hmac, ssh, tls, o registry. Sebbene sia possibile continuare a utilizzare il gruppo di comando repo gruppo di comando, è possibile sfruttare il gruppo di comando unificato secret gruppo di comando unificato. Per creare un segreto per accedere a un servizio con una chiave SSH, ad esempio per autenticarsi a un repository Git come GitHub o GitLab,, usare il comando ibmcloud ce secret create --format ssh il comando. Un segreto SSH viene usato anche come segreto di accesso al repository Git. Per saperne di più su come lavorare con i segreti in Code Engine, vedere Lavorare con i segreti.

`ibmcloud ce repo create`

Creare un segreto di accesso al repository Git.

ibmcloud ce repo create --name SECRET_NAME --key-path SSH_KEY_PATH --host HOST_ADDRESS [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

Opzioni di comando

--host, --ho

L'indirizzo dell'host; ad esempio github.com. Questo campo è obbligatorio.

--key-path, --kp

Il percorso del file della chiave privata SSH non crittografata. Se si utilizza la propria chiave SSH privata, questo file si trova solitamente in $HOME/.ssh/id_rsa ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\id_rsa (Windows). Questo campo è obbligatorio.

-n, --name

Il nome del segreto di accesso al repository " Git ". Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--known-hosts-path, --khp: Il percorso del file hosts conosciuto. Questo valore è una funzione di sicurezza per garantire che la chiave privata sia usata solo per autenticarsi presso gli host a cui si è acceduto in precedenza, in particolare gli host GitHub o GitLab. Questo file si trova solitamente in $HOME/.ssh/known_hosts ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\known_hosts (Windows). Questo valore è facoltativo.

--output, -o

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

Il comando seguente crea un segreto di accesso Git chiamato github per l'host github.com e si autentica con una chiave SSH situata all'indirizzo /<filepath>/.ssh/id_rsa, dove <filepath> è il percorso sul sistema.

ibmcloud ce repo create -n github --key-path /<filepath>/.ssh/id_rsa --host github.com

Output di esempio

Creating Git access secret github...
OK

`ibmcloud ce repo delete`

Eliminare un segreto di accesso al repository Git.

ibmcloud ce repo delete --name NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome del segreto di accesso al repository " Git ". Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce repo delete --name github

Output di esempio

Are you sure you want to delete the Git access secret github? [y/N]> y
Deleting Git access secret github...
OK

`ibmcloud ce repo get`

Visualizza i dettagli di un segreto di accesso al repository Git.

ibmcloud ce repo get --name NAME [--decode] [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome del segreto di accesso al repository " Git ". Questo campo è obbligatorio.
--decode, -d: Mostra l'output di Data come decodificato nei dettagli. Se questa opzione non viene specificata, i dettagli di Data sono base64-encoded. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce repo get -n github

Output di esempio

Getting Git access secret github...
OK
Name:        github  
Project:     myproject  
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Age:         30s  
Created:     2021-03-14T14:05:56-05:00  
Host:        github.com
Data:          
---
ssh-privatekey:
ABCDABCDABCDABCDABCDU1NIIFBSSVZBVEUgS0VZLS0tLS0KYjABCDABCDABCDABCDhrdGRqRUFBQUFBQ21GbGN6STFOaABCDABCDABCDABCDABCDABCDE
...

`ibmcloud ce repo list`

Elenca tutti i segreti di accesso ai repository di Git presenti in un progetto.

ibmcloud ce repo list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce repo list

Output di esempio

Listing Git access secrets...
OK
Name    Age  
github  13m0s

`ibmcloud ce repo update`

Aggiornare il segreto di accesso di un repository Git.

ibmcloud ce repo update --name SECRET_NAME [--host HOST] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome del segreto di accesso al repository " Git ". Questo campo è obbligatorio.
--host, --ho: L'indirizzo dell'host; ad esempio github.com. Questo valore è facoltativo.
--key-path, --kp: Il percorso del file della chiave privata SSH non crittografata. Se si utilizza la propria chiave SSH privata, questo file si trova solitamente in $HOME/.ssh/id_rsa ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\id_rsa (Windows). Questo valore è facoltativo.
--known-hosts-path, --khp: Il percorso del file hosts conosciuto. Questo valore è una funzione di sicurezza per garantire che la chiave privata sia usata solo per autenticarsi presso gli host a cui si è acceduto in precedenza, in particolare gli host GitHub o GitLab. Questo file si trova solitamente in $HOME/.ssh/known_hosts ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\known_hosts (Windows). Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

Il comando seguente aggiorna un segreto di accesso Git chiamato github per utilizzare un nuovo host.

ibmcloud ce repo update  -n github --host NEW_HOST

Output di esempio

Getting Git access secret 'github'...
Updating Git access secret 'github'...
OK

Comandi di revisione

Un'applicazione, o app, esegue il codice per servire le richieste di HTTP. Oltre alle richieste tradizionali di HTTP, IBM Cloud® Code Engine supporta anche le applicazioni che utilizzano WebSockets come protocollo di comunicazione. Un'applicazione contiene una o più revisioni. Una revisione rappresenta una versione immutabile delle proprietà di configurazione dell'applicazione. Ogni aggiornamento di una proprietà di configurazione dell'applicazione crea una nuova revisione dell'applicazione.

Utilizzate i comandi di revision per gestire le revisioni delle applicazioni.

Per utilizzare i comandi di revision è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le revisioni delle applicazioni, vedere Distribuzione delle applicazioni.

È possibile utilizzare revision o rev nei comandi di revision. Per visualizzare la guida CLI per i comandi revision, eseguire ibmcloud ce revision -h.

`ibmcloud ce revision delete`

Cancellare una revisione dell'applicazione.

ibmcloud ce revision delete --name REVISION_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome della revisione dell'applicazione. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce revision delete -n newapp-mytest-00004 -f

Output di esempio

Deleting application revision 'newapp-mytest-00004'...
OK

`ibmcloud ce revision events`

Visualizzare gli eventi di sistema delle istanze di revisione dell'applicazione. Gli eventi di sistema vengono conservati fino a 60 minuti.

ibmcloud ce revision events (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--output OUTPUT] [--quiet]

Opzioni di comando

--instance, -i: Il nome di un'istanza di applicazione specifica. Usare il comando rev get per trovare il nome dell'istanza. Questo valore è necessario se --revision non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--revision, --rev, -r, --name, -n: Visualizza gli eventi di tutte le istanze della revisione dell'applicazione specificata. Questo valore è necessario se --instance non è specificato.

Esempio

ibmcloud ce revision events -n myapp-00001

Output di esempio

Code Engine conserva solo l'ultima revisione inattiva dell'applicazione, oltre a quella attiva. Le revisioni più vecchie non vengono conservate.

Getting application revision 'newapp-mytest-00002'...
Getting events for all instances of application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp:
Type     Reason     Age                Source                Messages
Normal   Scheduled  65s                default-scheduler     Successfully assigned bz8i2yh012p/newapp-mytest-00002-deployment-7c87cfbf66-xnwkp to 10.243.0.60
Normal   Pulling    63s                kubelet, 10.243.0.60  Pulling image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123"
Normal   Created    60s                kubelet, 10.243.0.60  Created container queue-proxy
Normal   Created    60s                kubelet, 10.243.0.60  Created container user-container
Normal   Started    60s                kubelet, 10.243.0.60  Started container user-container
Normal   Pulled     60s                kubelet, 10.243.0.60  Container image "icr.io/obs/codeengine/knative-serving/knative.dev/serving/cmd/queue:v0.20.0-rc11@sha256:3fedfa9d9cdd74e85d11d4167043f13902074946caf415d16ff537620f04931a" already present on machine
Normal   Pulled     60s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123" in 2.67237432s
Normal   Started    60s                kubelet, 10.243.0.60  Started container queue-proxy
Normal   Pulling    60s                kubelet, 10.243.0.60  Pulling image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7"
Normal   Pulled     59s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7" in 666.211288ms
Normal   Created    59s                kubelet, 10.243.0.60  Created container istio-proxy
Normal   Started    59s                kubelet, 10.243.0.60  Started container istio-proxy

`ibmcloud ce revision get`

Visualizza i dettagli di una revisione dell'applicazione.

ibmcloud ce revision get --name REVISION_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome della revisione dell'applicazione. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce revision get --name newapp-mytest-00002

Output di esempio

Getting application revision 'newapp-mytest-00002'...
Getting application 'newapp-mytest'...
OK
Name:            newapp-mytest-00002
ID:              abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:    myproject
Project ID:      01234567-abcd-abcd-abcd-abcdabcd1111
Age:             27d
Created:         2021-05-05T11:50:00-04:00
Status Summary:  Revision is ready
Environment Variables:
    Type                      Name               Value
    ConfigMap full reference  mycolorconfigmap
    Literal                   TARGET             Sunshine
Image:                  icr.io/codeengine/codeengine
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Port:                   8080
Runtime:
    Concurrency:    100
    Maximum Scale:  10
    Minimum Scale:  0
    Timeout:        300
Conditions:
    Type                OK     Age    Reason
    Active              false  5d22h  NoTraffic : The target is not receiving traffic.
    ContainerHealthy    true   5d22h
    Ready               true   5d22h
    ResourcesAvailable  true   5d22h

`ibmcloud ce revision list`

Elencare tutte le revisioni dell'applicazione in un progetto.

ibmcloud ce revision list [--application APPLICATION] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--application, --app, -a: Utilizzare questa opzione per visualizzare solo le revisioni dell'applicazione specificata. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce revision list

Output di esempio

Code Engine conserva solo l'ultima revisione inattiva dell'applicazione, oltre a quella attiva. Le revisioni più vecchie non vengono conservate.

Listing all application revisions...
OK
Name                   Application      Status  URL  Latest  Tag  Traffic  Age    Conditions  Reason
myapp-hc3u8-2           myapp            Ready                              16d    3 OK / 4
myapp-hc3u8-3           myapp            Ready        true         100%    2d8h    3 OK / 4  
newapp-mytest-00004     newapp-mytest    Ready                              4d20h  3 OK / 4
newapp-mytest-00005     newapp-mytest    Ready        true         100%     2d20h  3 OK / 4

`ibmcloud ce revision logs`

Visualizza i log delle istanze di revisione dell'applicazione.

ibmcloud ce revision logs (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--all-containers] [--follow] [--output OUTPUT] [--quiet] [--tail TAIL] [--timestamps]

Opzioni di comando

--all-containers, --all: Visualizza i registri di tutti i contenitori delle istanze di revisione dell'applicazione specificate. Questo valore è facoltativo. Il valore predefinito è false.
--follow, -f: Seguire i log delle istanze di revisione delle applicazioni. Utilizzare questa opzione per trasmettere i log delle istanze di revisione dell'applicazione. Se si specifica l'opzione --follow, è necessario immettere Ctrl+C per terminare questo comando di log. Questo valore è facoltativo. Il valore predefinito è false.
--instance, -i: Il nome di una specifica istanza di revisione dell'applicazione. Usare il comando revision get per trovare il nome dell'istanza. Questo valore è necessario se --revision non è specificato.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--revision, --rev, -r, --name, -n: Visualizza i registri di tutte le istanze della revisione dell'applicazione specificata. Questo valore è necessario se --instance non è specificato.
--tail, -t: Limita la visualizzazione dei registri dei contenitori delle istanze di revisione dell'applicazione specificate a un numero massimo di righe recenti per contenitore. Ad esempio, per visualizzare le ultime 3 righe dei log dei contenitori delle istanze di revisione dell'applicazione specificate, specificare --tail 3. Se questa opzione non viene specificata, vengono visualizzate tutte le righe dei registri dei contenitori delle istanze di revisione dell'applicazione specificate. Questo valore è facoltativo. Il valore predefinito è -1.
--timestamps, --ts: Includere i timestamp in ogni riga dell'output del log. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce revision logs -n myapp-00001

Output di esempio

Code Engine conserva solo l'ultima revisione inattiva dell'applicazione, oltre a quella attiva. Le revisioni più vecchie non vengono conservate.

Getting logs for all instances of application revision 'newapp-mytest-00002'...
Getting application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp/user-container:
2021-07-15 20:40:56 Listening on port 8080

Comandi segreti

Un segreto consente di includere nella propria distribuzione informazioni di configurazione sensibili, quali password o chiavi SSH. Facendo riferimento ai valori del segreto, è possibile disaccoppiare le informazioni sensibili dall'implementazione e mantenere la portabilità dell'applicazione, della funzione o del lavoro. Chiunque sia autorizzato a partecipare al vostro progetto può vedere i vostri segreti; assicuratevi di sapere che le informazioni segrete possono essere condivise con questi utenti. I segreti contengono informazioni in coppie chiave-valore.

Per utilizzare i comandi di secret è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni sul lavoro con i segreti, vedere Lavoro con i segreti.

Per visualizzare la guida CLI per i comandi secret, eseguire ibmcloud ce secret -h.

A partire dalla versione 1.42.0, la definizione e l'utilizzo dei segreti nella CLI sono unificati nel gruppo di comandi secret del gruppo di comandi. Utilizzare l'opzione --format per specificare la categoria del segreto, ad esempio basic_auth, generic, hmac, ssh, tls, o registry. Il valore predefinito dell'opzione --format è generic.

`ibmcloud ce secret create`

Crea un segreto.

ibmcloud ce secret create --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--format FORMAT] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

Opzioni di comando

--access-key-id, --akid

Specificare l'access_key_id della credenziale HMAC. Questo valore è facoltativo.

--access-key-id-prompt

Richiede access_key_id della credenziale HMAC. Questo valore è facoltativo. Il valore predefinito è false.

--cert-chain-file, --ccf

Specificare un file contenente la catena di certificati fornita dall'autorità di certificazione per un segreto " TLS ". È necessario fornire il percorso del file come valore. Questo valore è necessario per i segreti di tls. Questo valore è facoltativo.

--email, --em

L'indirizzo e-mail per accedere al server di registro per un segreto di registro. Questo valore si applica solo ai segreti di registry. Questo valore è facoltativo.

--format, --fo

Il formato del segreto. I valori validi sono basic_auth, generic, hmac, registry, ssh o tls. Questo valore è facoltativo. Il valore predefinito è generic.

--from-env-file, -e

Crea un segreto generico da un file che contiene una o più righe che corrispondono al formato KEY=VALUE. È necessario fornire il percorso del file come valore. Ogni riga del file specificato viene aggiunta come coppia chiave-valore. Le righe del file specificato che sono vuote o iniziano con # vengono ignorate. Questo valore è necessario se --from-literal o --from-file non sono specificati. Questa opzione può essere specificata più volte. Questo valore si applica solo ai segreti di generic.

--from-file, -f

Crea un segreto generico da un file. È necessario fornire il percorso del file come valore. Questo valore è necessario se --from-literal o --from-env-file non sono specificati. Questa opzione può essere specificata più volte. Questo valore si applica solo ai segreti di generic.

--from-json-file, --json

Il percorso di un file contenente i valori segreti in formato JSON. Questa opzione è supportata per il formato segreto hmac Questo valore è opzionale.

--from-literal, -l

Crea un segreto generico da una coppia chiave-valore. Deve essere nel formato KEY=VALUE. Questo valore è necessario se --from-file o --from-env-file non sono specificati. Questa opzione può essere specificata più volte. Questo valore si applica solo ai segreti di generic.

--key-path, --kp

Il percorso del file della chiave privata SSH non crittografata per un segreto SSH. Se si utilizza la propria chiave SSH privata, questo file si trova solitamente in $HOME/.ssh/id_rsa ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\id_rsa (Windows). Questo valore è necessario per i segreti di ssh. Questo valore è facoltativo.

--known-hosts-path, --khp

Il percorso del file degli host conosciuti per un segreto SSH. Questo valore è una funzione di sicurezza per garantire che la chiave privata sia usata solo per autenticarsi presso gli host a cui si è acceduto in precedenza, in particolare gli host GitHub o GitLab. Questo file si trova solitamente in $HOME/.ssh/known_hosts ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\known_hosts (Windows). Questo valore si applica solo ai segreti di ssh. Questo valore è facoltativo.

-n, --name

Il nome del segreto. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo valore è facoltativo.

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.

--password, --pw

La password per un'autenticazione di base o un segreto di registro. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. Questo valore è necessario per i segreti basic_auth e registry. Questo valore è facoltativo.

--password-from-file, --spf

Il percorso di un file contenente la password per l'autenticazione di base o il segreto del registro. La prima riga del file viene utilizzata per la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. È necessario fornire il percorso del file come valore. Questo valore è necessario per i segreti basic_auth e registry. Questo valore è facoltativo.

--password-from-json-file, --spfj

Il percorso di un file JSON contenente la password per l'autenticazione di base o il segreto del registro. Il campo " apikey " serve per inserire la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. È necessario fornire il percorso del file come valore. Questo valore è necessario per i segreti basic_auth e registry. Questo valore è facoltativo.

--private-key-file, --pkf

Specificare un file contenente la chiave privata relativa a un segreto " TLS " (Risposta a una richiesta di autenticazione) che corrisponda alla catena di certificati specificata tramite l'opzione " cert-chain-file ". È necessario fornire il percorso del file come valore. Questo valore è necessario per i segreti di tls. Questo valore è facoltativo.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questa opzione si applica ai segreti basic_auth, generic, registry, ssh e tls. Questo valore è facoltativo. Il valore predefinito è false.

--secret-access-key, --sak

Specificare la secret_access_key della credenziale HMAC. Questo valore è facoltativo.

--secret-access-key-prompt

Richiede secret_access_key della credenziale HMAC. Questo valore è facoltativo. Il valore predefinito è false.

--server, -s

L'indirizzo URL del server di registro per un segreto di registro. Questa opzione è necessaria per i segreti di registry. Questo valore è facoltativo. Il valore predefinito è us.icr.io.

--username, -u

Il nome utente per l'autenticazione di base o il segreto di registro. Questa opzione è necessaria per i segreti basic_auth e registry. Questo valore è facoltativo.

Esempio di segreto di autenticazione di base

Un segreto di autenticazione di base contiene una chiave username e una password e viene utilizzato quando si accede a un servizio che richiede l'autenticazione di base HTTP.

Per visualizzare la guida CLI per la creazione di un segreto di autenticazione di base, eseguire ibmcloud ce secret create --format basic_auth.

L'esempio seguente crea un segreto di autenticazione di base denominato mysecret-basicauth. Questo segreto contiene il nome utente myusername, mentre il valore della password è ottenuto da un file sulla macchina locale. Se la password non viene fornita da un file o da un file JSON, viene richiesto di inserire il valore della password.

ibmcloud ce secret create --name mysecret-basicauth --format basic_auth --username myusername --password-from-file ./password.txt

Esempio di output per un segreto di autenticazione di base

Creating basic_auth secret 'mysecret-basicauth'...
OK

Esempio di segreto generico

Un segreto generico memorizza semplici coppie chiave-valore e Code Engine non fa alcuna ipotesi sulle coppie chiave-valore definite né sull'uso previsto del segreto.

Per visualizzare la guida CLI per la creazione di un segreto generico, eseguire ibmcloud ce secret create o ibmcloud ce secret create --format generic.

Si noti che --format generic è l'impostazione predefinita quando si crea un segreto con il comando secret create nella CLI.

L'esempio seguente crea un segreto generico chiamato mysecret-generic e il valore di questo segreto è specificato per una coppia chiave-valore con l'opzione --from-literal.

ibmcloud ce secret create --name mysecret-generic --format generic --from-literal "TARGET=My literal secret"

Esempio di output per un segreto generico

Creating generic secret 'mysecret-generic'...
OK

Esempio di un segreto generico con valori provenienti da un file

L'esempio seguente crea un segreto denominato mysecret-fromfile con i valori di un file. Utilizzando l'opzione --from-file per puntare a un file, tutto il contenuto del file diventa il valore della coppia chiave-valore.

ibmcloud ce secret create --name mysecret-genericfromfile  --from-file ./value1.txt --from-file ./value2.txt

Esempio di output di un segreto generico con valori provenienti da un file

Creating secret mysecret-genericfromfile...
OK

Esempio di segreto HMAC

Un segreto HMAC contiene una access_key_id e una secret_access_key chiave e viene utilizzato con S3-compatible strumenti e librerie che richiedono l'autenticazione ma non supportano IBM Cloud® Identity and Access Management chiavi API.

Per visualizzare la guida CLI per la creazione di un segreto HMAC, eseguire ibmcloud ce secret create --format hmac.

L'esempio seguente crea un segreto HMAC denominato mysecret-hmac. Questo segreto contiene i valori access_key_id e secret_access_key forniti quando richiesto. Se una delle due opzioni non viene fornita con il comando o da un file JSON, viene richiesto di inserire i valori.

ibmcloud ce secret create --name mysecret-hmac --format hmac --access-key-id-prompt --secret-access-key-prompt

Esempio di output per un segreto HMAC

Creating hmac_auth secret 'mysecret-hmac'...
OK

Esempio di segreto di registro

Un segreto di registro memorizza le credenziali di accesso al registro del contenitore.

Per visualizzare la guida CLI per la creazione di un segreto di registro, eseguire ibmcloud ce secret create --format registry.

L'esempio seguente crea un segreto di registro denominato mysecret-registry per un'istanza IBM Cloud Container Registry che si trova sul server di registro us.icr.io e specifica le credenziali per username e password.

ibmcloud ce secret create --name mysecret-registry --format registry --server us.icr.io --username iamapikey --password API_KEY

Esempio di output per un segreto di registro

Creating registry secret `mysecret-registry`...
OK

Esempio di segreto SSH

Un segreto SSH memorizza le credenziali per autenticarsi a un servizio con una chiave SSH; ad esempio, l'autenticazione a un repository Git, come GitHub o GitLab.

Per visualizzare la guida CLI per la creazione di un segreto SSH, eseguire ibmcloud ce secret create --format ssh.

L'esempio seguente crea un segreto SSH denominato mysecret-ssh per un host incluso nel file known_hosts e si autentica con un file di chiave privata SSH non crittografato situato all'indirizzo /<filepath>/.ssh/<key_name>, dove <filepath> è il percorso sul sistema. Questo comando richiede un nome e un percorso della chiave e consente anche altri argomenti opzionali, come il percorso del file degli host conosciuti.

ibmcloud ce secret create --name mysecret-ssh --format ssh --key-path ~/.ssh/<key_name> --known-hosts-path  ~/.ssh/known_hosts

Esempio di output per un segreto SSH

Creating SSH secret `mysecret-ssh`...
OK

Esempio di segreto TLS

Un segreto Transport Layer Security ( TLS ) contiene un certificato firmato TLS, compresi tutti i suoi certificati intermedi, e la corrispondente chiave privata di un'autorità di certificazione (CA). Utilizzare i segreti di TLS quando si lavora con mappature di dominio personalizzate.

Per visualizzare la guida CLI per la creazione di un segreto TLS, eseguire ibmcloud ce secret create --format tls.

L'esempio seguente crea un segreto TLS denominato mysecret-tls. La catena di certificati corrispondente al dominio personalizzato è contenuta nel file certificate.txt e il file della chiave privata corrispondente è contenuto nel file privatekey.txt. Entrambi i file si trovano nella directory principale della workstation locale.

ibmcloud ce secret create --name mysecret-tls  --format tls  --cert-chain-file certificate.txt --private-key-file privatekey.txt

Esempio di output per un segreto TLS

Creating TLS secret `mysecret-tls`...
OK

`ibmcloud ce secret delete`

Elimina un segreto.

ibmcloud ce secret delete --name SECRET_NAME [--force] [--ignore-not-found] [--quiet]

Opzioni di comando

--name, -n: Il nome del segreto. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce secret delete --name mysecret-genericfromfile -f

Output di esempio

Deleting secret mysecret-genericfromfile...
OK

`ibmcloud ce secret get`

Visualizzare i dettagli di un segreto.

ibmcloud ce secret get --name SECRET_NAME [--decode] [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome del segreto. Questo campo è obbligatorio.
--decode, -d: Mostra l'output di Data come decodificato nei dettagli. Se questa opzione non viene specificata, i dettagli di Data sono base64-encoded. Questo valore è facoltativo. Il valore predefinito è false.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce secret get --name mysecret-basicauth

Output di esempio

Getting secret 'mysecret-basicauth'...
OK
Name:          mysecret-basicauth
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Format:        basic_auth
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           66s
Created:       2021-03-10T18:44:18-05:00
Data:    
---
password: REDACTED
username: bXl1c2VybmFtZQ==

`ibmcloud ce secret list`

Elencare tutti i segreti in un progetto.

ibmcloud ce secret list [--all] [--format FORMAT] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--all, -a: Visualizza tutti i segreti di tutti i formati, compresi i segreti di basic_auth, generic, registry, ssh, tls e other che non sono gestiti da Code Engine. Questo valore è facoltativo. Il valore predefinito è false.
--format, --fo: Specificare questa opzione per filtrare la visualizzazione dei segreti. I valori validi sono basic_auth, generic, registry, ssh e tls. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

Questo comando elenca tutti i segreti di un progetto.

ibmcloud ce secret list

Output di esempio

Listing secrets...
OK
Name                          Format          Data  Age  
ce-auto-icr-private-us-south  registry        4     333d  
ce-auto-private-icr-us-south  registry        4     335d  
myregistry-seccmd             registry        4     3h31m  
mysecret-basicauth            basic_auth      2     7m37s  
mysecret-generic              generic         1     7m7s  
mysecret-genericfromfile      generic         2     2m29s  
mysecret-hmac                 hmac_auth       2     21m
mysecret-registry             registry        4     111s  
mysecret-ssh                  ssh_auth        2     42m  
mysecret-tls                  tls             2     3h47m

`ibmcloud ce secret update`

Aggiorna un segreto.

ibmcloud ce secret update --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE | --rm KEY) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

Opzioni di comando

--name, -n: Il nome del segreto. Questo campo è obbligatorio.
--access-key-id, --akid: Specificare l'access_key_id della credenziale HMAC. Questo valore è facoltativo.
--access-key-id-prompt: Richiede access_key_id della credenziale HMAC. Questo valore è facoltativo. Il valore predefinito è false.
--cert-chain-file, --ccf: Specificare un file contenente la catena di certificati fornita dall'autorità di certificazione per un segreto " TLS ". È necessario fornire il percorso del file come valore. Questo valore è facoltativo.
--email, --em: L'indirizzo e-mail per accedere al server di registro per un segreto di registro. Questo valore è facoltativo.
--from-env-file, -e: Aggiorna un segreto generico da un file che contiene una o più righe che corrispondono al formato KEY=VALUE. È necessario fornire il percorso del file come valore. Ogni riga del file specificato viene aggiunta come coppia chiave-valore. Le righe del file specificato che sono vuote o iniziano con # vengono ignorate. Questo valore è necessario se --from-literal o --from-file non sono specificati.
--from-file, -f: Aggiorna un segreto generico da un file. È necessario fornire il percorso del file come valore. Questo valore è necessario se --from-literal o --from-env-file non sono specificati.
--from-json-file, --json: Il percorso di un file contenente i valori segreti in formato JSON. Questa opzione è supportata per il formato segreto hmac Questo valore è opzionale.
--from-literal, -l: Aggiorna un segreto generico da una coppia chiave-valore. Deve essere nel formato KEY=VALUE. Questo valore è necessario se --from-file o --from-env-file non sono specificati. Questa opzione può essere specificata più volte.
--key-path, --kp: Il percorso del file della chiave privata SSH non crittografata per un segreto SSH. Se si utilizza la propria chiave SSH privata, questo file si trova solitamente in $HOME/.ssh/id_rsa ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\id_rsa (Windows). Questo valore è facoltativo.
--known-hosts-path, --khp: Il percorso del file degli host conosciuti per un segreto SSH. Questo valore è una funzione di sicurezza per garantire che la chiave privata sia usata solo per autenticarsi presso gli host a cui si è acceduto in precedenza, in particolare gli host GitHub o GitLab. Questo file si trova solitamente in $HOME/.ssh/known_hosts ( Mac OS o Linux ) o in %HOMEPATH%\.ssh\known_hosts (Windows). Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--password, --pw: La password per un'autenticazione di base o un segreto di registro. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. Questo valore è facoltativo.
--password-from-file, --spf: Il percorso di un file contenente la password per l'autenticazione di base o il segreto del registro. La prima riga del file viene utilizzata per la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. È necessario fornire il percorso del file come valore. Questo valore è facoltativo.
--password-from-json-file, --spfj: Il percorso di un file JSON contenente la password per l'autenticazione di base o il segreto del registro. Il campo " apikey " serve per inserire la password. Se non viene specificata nessuna delle opzioni --password, --password-from-file o --password-from-json-file, verrà richiesta la password. È necessario fornire il percorso del file come valore. Questo valore è facoltativo.
--private-key-file, --pkf: Specificare un file contenente la chiave privata relativa a un segreto " TLS " (Risposta a una richiesta di autenticazione) che corrisponda alla catena di certificati specificata tramite l'opzione " cert-chain-file ". È necessario fornire il percorso del file come valore. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--rm: Rimuovere una singola coppia chiave-valore in un segreto generico, specificando il nome della chiave. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--secret-access-key, --sak: Specificare la secret_access_key della credenziale HMAC. Questo valore è facoltativo.
--secret-access-key-prompt: Richiede secret_access_key della credenziale HMAC. Questo valore è facoltativo. Il valore predefinito è false.
--server, -s: L'indirizzo URL del server di registro per un segreto di registro. Questo valore è facoltativo. Il valore predefinito è us.icr.io.
--username, -u: Il nome utente per l'autenticazione di base o il segreto di registro. Questo valore è facoltativo.

Esempio

Questo esempio aggiorna un segreto TLS con un certificato e una chiave privata aggiornati.

ibmcloud ce secret update --name mysecret-tls --cert-chain-file certificate2.txt --private-key-file privatekey2.txt

Output di esempio

Updating secret mysecret-tls..
OK

Comandi cos dell'abbonamento

Spesso negli ambienti distribuiti si desidera che le applicazioni o i lavori reagiscano ai messaggi (eventi) generati da altri componenti, che di solito sono chiamati produttori di eventi. Con Code Engine, le applicazioni o i lavori possono ricevere gli eventi di interesse sottoscrivendo i produttori di eventi. Le informazioni sugli eventi vengono ricevute come richieste POST HTTP per le applicazioni e come variabili d'ambiente per i lavori.

Il produttore di eventi Object Storage genera eventi quando vengono apportate modifiche agli oggetti nei bucket di archiviazione degli oggetti. Ad esempio, quando gli oggetti vengono aggiunti a un bucket, un'applicazione può ricevere un evento ed eseguire un'azione basata su tale modifica, magari consumando il nuovo oggetto.

Per utilizzare i comandi di subscription cos è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le sottoscrizioni di IBM Cloud Object Storage, vedere Lavorare con il produttore di eventi IBM Cloud Object Storage. Vedere Come iniziare con gli abbonamenti per ulteriori informazioni su come lavorare con le sottoscrizioni in Code Engine.

È possibile utilizzare subscription o sub nei comandi di subscription cos. Per visualizzare la guida CLI per il comando subscription cos, eseguire ibmcloud ce sub cos -h.

`ibmcloud ce subscription cos create`

Creare una sottoscrizione all'evento IBM Cloud Object Storage.

ibmcloud ce subscription cos create --name COS_SOURCE_NAME --destination DESTINATION_REF --bucket BUCKET_NAME [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--bucket, -b

Il secchio per gli eventi. La destinazione e il bucket devono trovarsi nella stessa regione del progetto. Questo campo è obbligatorio.

--destination, -d

Il nome dell'applicazione o della risorsa di lavoro che si desidera ricevere gli eventi; ad esempio, myapp. Se necessario, utilizzare l'opzione --path per qualificare ulteriormente una destinazione dell'app. Questo campo è obbligatorio.

-n, --name

Il nome dell'abbonamento all'evento " IBM Cloud Object Storage ". Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--destination-type, --dt: Il tipo di destination. I valori validi sono app e job. Questo valore è facoltativo. Il valore predefinito è app.

--event-type, -e

I tipi di evento da tenere d'occhio. I valori validi sono delete, write e all. Questo valore è facoltativo. Il valore predefinito è all.

--extension, --ext

Impostare le estensioni di CloudEvents da inviare alla destinazione. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova estensione CloudEvents o sostituisce un attributo esistente CloudEvent. Specificare un'estensione per ogni opzione --extension ; ad esempio, --ext extA=A --ext extB=B. Questo valore è facoltativo.

--force, -f

Forza la creazione di una sottoscrizione all'evento IBM Cloud Object Storage. Questa opzione salta la convalida della destinazione specificata. Questo valore è facoltativo. Il valore predefinito è false.

--no-wait, --nw

Creare la sottoscrizione all'evento IBM Cloud Object Storage e non attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --no-wait, la creazione dell'abbonamento inizia senza aspettare. Usare il comando subscription cos get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--path

Il percorso all'interno dell'applicazione destination dove vengono inoltrati gli eventi; ad esempio, /events. Il percorso predefinito è la root URL dell'applicazione destination. Questa opzione può essere specificata solo se destination-type è app. Questo valore è facoltativo.

--prefix, -p

Prefisso dell'oggetto IBM Cloud Object Storage. Questo valore è facoltativo.

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--suffix, -s

Suffisso dell'oggetto IBM Cloud Object Storage. Quando si specifica il suffisso, tenere conto del tipo di file. Questo valore è facoltativo.

--wait, -w

Creare la sottoscrizione all'evento IBM Cloud Object Storage e attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --wait, la creazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento sia pronto. Se la sottoscrizione non è pronta entro il periodo specificato da --wait-timeout, la creazione di una sottoscrizione all'evento IBM Cloud Object Storage non riesce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché l'abbonamento all'evento " IBM Cloud Object Storage " sia pronto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 15.

Esempio

La sottoscrizione IBM Cloud Object Storage ascolta le modifiche a un bucket Object Storage. L'esempio seguente crea una sottoscrizione COS chiamata mycosevent per un bucket chiamato mybucket collegato a un'applicazione chiamata myapp. L'opzione --destination-type specifica il tipo di destination che è app o job. Per questo esempio, --destination-type è app, che è il valore predefinito per questa opzione. L'evento viene inviato al percorso /events utilizzando l'opzione --path in modo che l'evento venga inviato a https://<base application URL>/events.

ibmcloud ce subscription cos create --name mycosevent --destination myapp --bucket mybucket --destination-type app --path /events

Output di esempio

Creating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

`ibmcloud ce subscription cos delete`

Eliminare una sottoscrizione a un evento di IBM Cloud Object Storage.

ibmcloud ce subscription cos delete --name COS_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " IBM Cloud Object Storage ". Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--no-wait, --nw: Eliminare la sottoscrizione all'evento IBM Cloud Object Storage e non attendere l'eliminazione della sottoscrizione. Se si specifica l'opzione --no-wait, l'eliminazione dell'abbonamento inizia senza aspettare. Usare il comando subscription cos get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Eliminare la sottoscrizione all'evento IBM Cloud Object Storage e attendere l'eliminazione della sottoscrizione. Se si specifica l'opzione --wait, l'eliminazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento venga eliminato. Questo comando esce quando l'abbonamento viene cancellato o quando viene raggiunto --wait-timeout, a seconda di quale situazione si verifichi per prima. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere affinché l'iscrizione all'evento " IBM Cloud Object Storage " venga eliminata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 15.

Esempio

ibmcloud ce subscription cos delete --name mycosevent -f

Output di esempio

Deleting COS source 'mycosevent'...
OK

`ibmcloud ce subscription cos get`

Visualizza i dettagli di una sottoscrizione a un evento di IBM Cloud Object Storage. Gli attributi visualizzati includono Name, Destination, Bucket, Event Type, Prefix, Suffix, Ready, e Age. Per vedere i dettagli specifici, allegare | grep <attribute>.

ibmcloud ce subscription cos get --name COS_SOURCE_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " IBM Cloud Object Storage ". Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce subscription cos get --name mycosevent

Output di esempio

Getting COS source 'mycosevent'...
OK
Name:          mycosevent
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           12s  
Created:       2021-03-14T13:28:45-05:00  
Destination:  App:myapp
Bucket:       mybucket
EventType:    all
Ready:        true  
Conditions:    
    Type            OK    Age  Reason  
    CosConfigured   true  10s    
    Ready           true  10s    
    ReadyForEvents  true  10s    
    SinkProvided    true  10s    
Events:        
    Type    Reason          Age  Source                Messages  
    Normal  CosSourceReady  11s  cossource-controller  CosSource is ready

Quando Ready è true, la sottoscrizione COS è pronta a scatenare eventi per le modifiche al bucket COS.

`ibmcloud ce subscription cos list`

Elenca tutti gli abbonamenti agli eventi “ IBM Cloud Object Storage ” presenti in un progetto.

ibmcloud ce subscription cos list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce subscription cos list

Output di esempio

Listing COS sources...
OK
Name        Age  Ready  Bucket        EventType  Prefix  Suffix  Destination
mycosevent  20m  true   mycosbucket  all                         http://myapp.2706b22d-676b.svc.cluster.local

`ibmcloud ce subscription cos update`

Aggiornare una sottoscrizione a un evento di IBM Cloud Object Storage.

ibmcloud ce subscription cos update --name COS_SOURCE_NAME [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " IBM Cloud Object Storage ". Questo campo è obbligatorio.
--destination, -d: Il nome dell'applicazione o della risorsa di lavoro che si desidera ricevere gli eventi; ad esempio, myapp. Se necessario, utilizzare l'opzione --path per qualificare ulteriormente una destinazione dell'app. Questo valore è facoltativo.
--destination-type, --dt: Il tipo di destination. I valori validi sono app e job. Questo valore è facoltativo.
--event-type, -e: I tipi di evento da tenere d'occhio. I valori validi sono delete, write e all. Questo valore è facoltativo.
--extension, --ext: Impostare le estensioni di CloudEvents da inviare alla destinazione. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova estensione CloudEvents o sostituisce un attributo esistente CloudEvent. Specificare un'estensione per ogni opzione --extension ; ad esempio, --ext extA=A --ext extB=B. Questo valore è facoltativo.
--extension-rm, --ext-rm: Rimuovere le estensioni di CloudEvents da inviare alla destinazione specificando il nome della chiave. Specificare un'estensione per ogni opzione --ext-rm ; ad esempio, --ext-rm extA --ext-rm extB. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--path: Il percorso all'interno dell'applicazione destination dove vengono inoltrati gli eventi; ad esempio, /events. Il percorso predefinito è la root URL dell'applicazione destination. Questa opzione può essere specificata solo se destination-type è app. Questo valore è facoltativo.
--prefix, -p: Prefisso dell'oggetto IBM Cloud Object Storage. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--suffix, -s: Suffisso dell'oggetto IBM Cloud Object Storage. Quando si specifica il suffisso, tenere conto del tipo di file (estensione) del file. Questo valore è facoltativo.

Esempio

L'esempio seguente aggiorna una sottoscrizione COS chiamata mycosevent per ascoltare solo gli eventi di scrittura.

ibmcloud ce subscription cos update --name mycosevent --event-type write

Output di esempio

Updating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

Comandi cron di sottoscrizione

Il produttore di eventi cron si basa su cron e genera un evento a intervalli regolari. Utilizzate un produttore di eventi cron quando è necessario eseguire un'azione a intervalli ben definiti o a orari specifici.

Per utilizzare i comandi di subscription cron è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le sottoscrizioni di IBM Cloud Object Storage, vedere Lavorare con il produttore di eventi del timer periodico(cron). Vedere Come iniziare con gli abbonamenti per ulteriori informazioni su come lavorare con le sottoscrizioni in Code Engine.

È possibile utilizzare subscription o sub nei comandi di subscription cron. Per visualizzare la guida CLI per il comando subscription cron, eseguire ibmcloud ce sub cron -h.

`ibmcloud ce subscription cron create`

Crea un abbonamento a un evento cron.

ibmcloud ce subscription cron create --name CRON_SOURCE_NAME  --destination DESTINATION_REF [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--destination, -d

-n, --name

Il nome dell'abbonamento all'evento cron. Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--content-type, --ct: Il tipo di supporto dell'opzione --data o --data-base64. Gli esempi includono application/json, application/x-www-form-urlencoded, text/html e text/plain. Questo valore è facoltativo.

--da, --data

I dati da inviare alla destinazione; ad esempio, '{ "message": "Hello world!" }'. Se si specifica l'opzione --data, non utilizzare l'opzione --data-base64.

Questo valore è facoltativo.

--data-base64, --db: I dati base64-encoded da inviare alla destinazione; ad esempio, Q29kZSBFbmdpbmU=. Se si specifica l'opzione --data-base64, non utilizzare l'opzione --data. Questo valore è facoltativo.

--destination-type, --dt

Il tipo di destination. I valori validi sono app, function e job. Questo valore è facoltativo. Il valore predefinito è app.

--extension, --ext

--force, -f

Forza la creazione di un evento cron in abbonamento. Questa opzione salta la convalida della destinazione specificata. Questo valore è facoltativo. Il valore predefinito è false.

--no-wait, --nw

Creare la sottoscrizione all'evento cron e non attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --no-wait, la creazione dell'abbonamento inizia senza aspettare. Usare il comando subscription cron get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--path

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--schedule, -s

Impostare la frequenza con cui l'evento viene attivato, utilizzando il formato crontab. Ad esempio, specificare '*/2 * * * *' (in formato stringa) per ogni due minuti. Per impostazione predefinita, l'evento cron viene attivato ogni minuto ed è impostato sul fuso orario UTC. Per modificare il fuso orario, utilizzare l'opzione --time-zone. Questo valore è facoltativo.

--time-zone, --tz

Impostare il fuso orario per l'evento cron; ad esempio, Asia/Tokyo. Se si specifica l'opzione --schedule, utilizzare questa opzione per specificare il fuso orario. Per i valori validi dei fusi orari, consultare il sito database dei fusi orari. Questo valore è facoltativo. Il valore predefinito è UTC.

--wait, -w

Creare la sottoscrizione all'evento cron e attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --wait, la creazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento sia pronto. Se la sottoscrizione non è pronta entro il periodo specificato da --wait-timeout, la creazione della sottoscrizione all'evento cron fallisce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché l'iscrizione all'evento cron sia pronta. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 15.

Esempio

L'esempio seguente crea una sottoscrizione cron chiamata mycronevent che inoltra un evento cron a un lavoro chiamato myjob ogni 2 minuti.

ibmcloud ce subscription cron create --name mycronevent --destination myjob --schedule '*/2 * * * *' --destination-type job

Output di esempio

Creating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

`ibmcloud ce subscription cron delete`

Eliminare un abbonamento a un evento cron.

ibmcloud ce subscription cron delete --name CRON_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento cron. Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--no-wait, --nw: Eliminare la sottoscrizione all'evento cron e non attendere l'eliminazione della sottoscrizione. Se si specifica l'opzione --no-wait, l'eliminazione dell'abbonamento inizia senza aspettare. Usare il comando subscription cron get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Eliminare la sottoscrizione all'evento cron e attendere che la sottoscrizione venga eliminata. Se si specifica l'opzione --wait, l'eliminazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento venga eliminato. Questo comando esce quando l'abbonamento viene cancellato o quando viene raggiunto --wait-timeout, a seconda di quale situazione si verifichi per prima. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere prima che l'iscrizione all'evento cron venga eliminata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 15.

Esempio

ibmcloud ce subscription cron delete --name mycronevent -f

Output di esempio

Deleting cron source 'mycronevent'...
OK

`ibmcloud ce subscription cron get`

Visualizza i dettagli di una sottoscrizione a un evento cron.

ibmcloud ce subscription cron get --name CRON_SOURCE_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento cron. Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce subscription cron get --name mycronevent

Output di esempio

Getting cron source 'mycronevent'...
OK
Name:          mycronevent  
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           18s  
Created:       2021-03-14T13:33:53-05:00  
Destination:  App:kapp  
Schedule:     */2 * * * *  
Time Zone:    UTC  
Ready:        true
Events:    
    Type     Reason           Age                Source                 Messages  
    Normal   FinalizerUpdate  19s                pingsource-controller  Updated "mycronevent" finalizers

Quando Ready è true, la sottoscrizione cron è pronta per attivare gli eventi secondo la pianificazione specificata.

`ibmcloud ce subscription cron list`

Elencare tutte le sottoscrizioni evento cron in un progetto.

ibmcloud ce subscription cron list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce subscription cron list

Output di esempio

Listing cron sources...
OK
Name         Age  Ready  Destination                                   Schedule     Data
mycronevent  96m  true   http://myapp.cd4200a7-5037.svc.cluster.local  */2 * * * *

`ibmcloud ce subscription cron update`

Aggiornare una sottoscrizione eventi cron.

ibmcloud ce subscription cron update --name CRON_SOURCE_NAME [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE]

Opzioni di comando

--name, -n

Il nome dell'abbonamento all'evento cron. Questo campo è obbligatorio.

--content-type, --ct

Il tipo di supporto dell'opzione --data o --data-base64. Gli esempi includono application/json, application/x-www-form-urlencoded, text/html e text/plain. Questo valore è facoltativo.

--da, --data

I dati da inviare alla destinazione; ad esempio, '{ "message": "Hello world!" }'. Se si specifica l'opzione --data, non utilizzare l'opzione --data-base64.

Questo valore è facoltativo.

--data-base64, --db: I dati base64-encoded da inviare alla destinazione; ad esempio, Q29kZSBFbmdpbmU=. Se si specifica l'opzione --data-base64, non utilizzare l'opzione --data. Questo valore è facoltativo.

--destination, -d

--destination-type, --dt

Il tipo di destination. I valori validi sono app, function e job. Questo valore è facoltativo.

--extension, --ext

--extension-rm, --ext-rm

Rimuovere le estensioni di CloudEvents da inviare alla destinazione specificando il nome della chiave. Specificare un'estensione per ogni opzione --ext-rm ; ad esempio, --ext-rm extA --ext-rm extB. Questo valore è facoltativo.

--output, -o

--path

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--schedule, -s

--time-zone, --tz

Esempio

L'esempio seguente aggiorna una sottoscrizione di origine cron chiamata mycronevent che inoltra un evento cron a un lavoro chiamato myjob ogni ora.

ibmcloud ce subscription cron update --name mycronevent --destination myjob --schedule '0 * * * *' --destination-type job

Output di esempio

Updating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

Abbonamento `kafka` comandi

Il produttore di eventi di Kafka osserva la comparsa di nuovi messaggi in un'istanza di Kafka. Quando si crea una sottoscrizione a Code Engine Kafka per un insieme di argomenti, l'applicazione o il lavoro riceve un evento separato per ogni nuovo messaggio visualizzato in uno degli argomenti.

Per utilizzare i comandi di subscription kafka è necessario trovarsi nel contesto di un progetto.

Per ulteriori informazioni su come lavorare con le sottoscrizioni agli eventi di Kafka, vedere Lavorare con il produttore di eventi di Kafka. Vedere Come iniziare con gli abbonamenti per ulteriori informazioni su come lavorare con le sottoscrizioni in Code Engine.

È possibile utilizzare subscription o sub nei comandi di subscription kafka. Per visualizzare la guida CLI per i comandi subscription, eseguire ibmcloud ce sub kafka -h.

`ibmcloud ce subscription kafka create`

Creare un abbonamento agli eventi Kafka.

ibmcloud ce subscription kafka create --name KAFKA_SOURCE_NAME --destination DESTINATION_REF --topic TOPIC --broker BROKER [--consumer-group CONSUMER_GROUP] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--username USERNAME] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--broker, -b

Impostare un broker nella sorgente Kafka. Un broker è un server Kafka al quale il consumatore si connette. Questa opzione può essere specificata più volte. Questo campo è obbligatorio.

--destination, -d

-n, --name

Il nome dell'abbonamento all'evento " Kafka ". Utilizzare un nome univoco all'interno del progetto.

Il nome deve iniziare e terminare con un carattere alfanumerico minuscolo.
Il nome deve essere composto da 253 caratteri o meno e può contenere lettere minuscole, numeri, punti (.) e trattini (-).

Questo campo è obbligatorio.

--topic, -t: Impostare un argomento nella sorgente Kafka. Gli argomenti vengono utilizzati per filtrare i messaggi da consumare. Questa opzione può essere specificata più volte. Questo campo è obbligatorio.

--consumer-group, --cg

Il nome del gruppo di consumer per gli eventi. Questo valore è facoltativo.

--destination-type, --dt

Il tipo di destination. I valori validi sono app e job. Questo valore è facoltativo. Il valore predefinito è app.

--extension, --ext

--force, -f

Forza la creazione di una sottoscrizione agli eventi di Kafka. Questa opzione salta la convalida della destinazione e del segreto specificati. Questo valore è facoltativo. Il valore predefinito è false.

--no-wait, --nw

Creare la sottoscrizione all'evento Kafka e non attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --no-wait, la creazione dell'abbonamento inizia senza aspettare. Usare il comando subscription kafka get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.

--output, -o

--password, -p

La password che viene utilizzata per autenticarsi all'istanza Kafka. Se si specifica l'opzione " --password ", non è possibile specificare l'opzione " --secret ". Questo valore è facoltativo.

--path

--quiet, -q

Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

--secret, -s

Il nome del segreto utilizzato per l'autenticazione all'istanza di Kafka, che include sia la chiave username che quella password. Se si specifica l'opzione " --secret ", non è possibile specificare le opzioni " --username " o " --password ". Questo valore è facoltativo.

--username, -u

Il nome utente utilizzato per autenticarsi all'istanza Kafka. Se si specifica l'opzione " --username ", è necessario specificare anche l'opzione " --password " e non è consentito specificare l'opzione " --secret ". Questo valore è facoltativo. Il valore predefinito è token.

--wait, -w

Creare la sottoscrizione all'evento Kafka e attendere che la sottoscrizione sia pronta. Se si specifica l'opzione --wait, la creazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento sia pronto. Se la sottoscrizione non è pronta entro il periodo specificato da --wait-timeout, la creazione di una sottoscrizione all'evento Kafka non riesce. Questo valore è facoltativo. Il valore predefinito è true.

--wait-timeout, --wto

Il tempo, espresso in secondi, da attendere affinché l'abbonamento all'evento " Kafka " sia pronto. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 120.

Esempio

L'esempio seguente crea una sottoscrizione all'evento Kafka, chiamata mykafkaevent, che inoltra un evento Kafka a un'applicazione ricevente, chiamata kafka-receiver-app. Specificate un'opzione --broker per ogni broker dell'argomento. L'opzione --destination specifica la risorsa Code Engine che riceve gli eventi. kafka-subscription-secret fornisce le credenziali per accedere al broker di messaggi.

ibmcloud ce subscription kafka create --name mykafkasubscription --destination kafka-receiver-app --secret kafka-subscription-secret --topic kafka-topic1 --broker broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker  broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093

Output di esempio

Creating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

`ibmcloud ce subscription kafka delete`

Eliminare una sottoscrizione a un evento di Kafka.

ibmcloud ce subscription kafka delete --name KAFKA_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " Kafka ". Questo campo è obbligatorio.
--force, -f: Forzare l'eliminazione senza conferma. Questo valore è facoltativo. Il valore predefinito è false.
--ignore-not-found, --inf: Se non viene trovato, non fallisce. Questo valore è facoltativo. Il valore predefinito è false.
--no-wait, --nw: Eliminare la sottoscrizione all'evento Kafka e non attendere l'eliminazione della sottoscrizione. Se si specifica l'opzione --no-wait, l'eliminazione dell'abbonamento inizia senza aspettare. Usare il comando subscription kafka get per verificare lo stato dell'abbonamento. Questo valore è facoltativo. Il valore predefinito è false.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--wait, -w: Eliminare la sottoscrizione all'evento Kafka e attendere l'eliminazione della sottoscrizione. Se si specifica l'opzione --wait, l'eliminazione dell'abbonamento attende un tempo massimo in secondi, impostato dall'opzione --wait-timeout, affinché l'abbonamento venga eliminato. Questo comando esce quando l'abbonamento viene cancellato o quando viene raggiunto --wait-timeout, a seconda di quale situazione si verifichi per prima. Questo valore è facoltativo. Il valore predefinito è true.
--wait-timeout, --wto: Il tempo, espresso in secondi, da attendere prima che l'iscrizione all'evento " Kafka " venga eliminata. Questo valore è necessario se si specifica l'opzione --wait. Questo valore viene ignorato se viene specificata l'opzione --no-wait. Il valore predefinito è 15.

Esempio

ibmcloud ce subscription kafka delete --name mykafkasubscription -f

Output di esempio

Deleting Kafka event subscription 'mykafkasubscription'...
OK

`ibmcloud ce subscription kafka get`

Visualizza i dettagli di una sottoscrizione a un evento di Kafka.

ibmcloud ce subscription kafka get --name KAFKA_SOURCE_NAME [--output OUTPUT] [--quiet]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " Kafka ". Questo campo è obbligatorio.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce subscription kafka get --name mykafkasubscription

Output di esempio

Getting Kafka event subscription 'mykafkasubscription'...
OK
Name:          mykafkasubscription  
[...]
Destination Type:                 app
Destination:                      kafka-receiver-app2
Brokers:
broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
Consumer Group:                   knative-kafka-source-a4072fe1-1dfa-4470-9d07-bf7a0ff8e340
Topics:
kafka-topic1
Secret key reference (user):      kafka-subscription-secret.username
Secret key reference (password):  kafka-subscription-secret.password
Ready:                            true
Conditions:
Type                     OK    Age  Reason
ConnectionEstablished    true  24s
InitialOffsetsCommitted  true  24s
Ready                    true  24s
Scheduled                true  24s
SinkProvided             true  24s
Events:
Type     Reason           Age  Source                  Messages
Normal   FinalizerUpdate  26s  kafkasource-controller  Updated "mykafkasubscription" finalizers

Quando Ready è true, l'abbonamento Kafka è pronto per attivare gli eventi secondo la pianificazione specificata.

`ibmcloud ce subscription kafka list`

Elencare tutte le sottoscrizioni evento Kafka in un progetto.

ibmcloud ce subscription kafka list [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

Opzioni di comando

--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--sort-by, -s: Specifica la colonna in base alla quale ordinare l'elenco. I valori validi sono name e age. Questo valore è facoltativo. Il valore predefinito è name.

Esempio

ibmcloud ce subscription kafka list

Output di esempio

Listing Kafka event subscriptions...
OK
Name                 Age  Ready  Destination Type  Destination          Path  Consumer Group                                             Reason  
mykafkasubscription  94s  true   app               kafka-receiver-app        knative-kafka-source-dc367965-15e4-44f3-bedf-25d453524a68

`ibmcloud ce subscription kafka update`

Aggiornare una sottoscrizione all'evento " Kafka ".

ibmcloud ce subscription kafka update --name KAFKA_SOURCE_NAME [--broker BROKER] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--topic TOPIC] [--username USERNAME]

Opzioni di comando

--name, -n: Il nome dell'abbonamento all'evento " Kafka ". Questo campo è obbligatorio.
--broker, -b: Impostare un broker nella sorgente Kafka. Un broker è un server Kafka al quale il consumatore si connette. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--destination, -d: Il nome dell'applicazione o della risorsa di lavoro che si desidera ricevere gli eventi; ad esempio, myapp. Se necessario, utilizzare l'opzione --path per qualificare ulteriormente una destinazione dell'app. Questo valore è facoltativo.
--destination-type, --dt: Il tipo di destination. I valori validi sono app e job. Questo valore è facoltativo.
--extension, --ext: Impostare le estensioni di CloudEvents da inviare alla destinazione. Deve essere nel formato NAME=VALUE. Questa azione aggiunge una nuova estensione CloudEvents o sostituisce un attributo esistente CloudEvent. Specificare un'estensione per ogni opzione --extension ; ad esempio, --ext extA=A --ext extB=B. Questo valore è facoltativo.
--extension-rm, --ext-rm: Rimuovere le estensioni di CloudEvents da inviare alla destinazione specificando il nome della chiave. Specificare un'estensione per ogni opzione --ext-rm ; ad esempio, --ext-rm extA --ext-rm extB. Questo valore è facoltativo.
--output, -o: Specifica il formato dell'output del comando. I valori validi sono json, yaml, jsonpath=JSONPATH_EXPRESSION e jsonpath-as-json=JSONPATH_EXPRESSION. Utilizzare jsonpath per specificare il percorso di un elemento dell'output JSON. Questo valore è facoltativo.
--password, -p: La password che viene utilizzata per autenticarsi all'istanza Kafka. Se si specifica l'opzione " --password ", non è possibile specificare l'opzione " --secret ". Questo valore è facoltativo.
--path: Il percorso all'interno dell'applicazione destination dove vengono inoltrati gli eventi; ad esempio, /events. Il percorso predefinito è la root URL dell'applicazione destination. Questa opzione può essere specificata solo se destination-type è app. Questo valore è facoltativo.
--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.
--secret, -s: Il nome del segreto utilizzato per l'autenticazione all'istanza di Kafka, che include sia la chiave username che quella password. Se si specifica l'opzione " --secret ", non è possibile specificare le opzioni " --username " o " --password ". Questo valore è facoltativo.
--topic, -t: Impostare un argomento nella sorgente Kafka. Gli argomenti vengono utilizzati per filtrare i messaggi da consumare. Questa opzione può essere specificata più volte. Questo valore è facoltativo.
--username, -u: Il nome utente utilizzato per autenticarsi all'istanza Kafka. Se si specifica l'opzione " --username ", è necessario specificare anche l'opzione " --password " e non è consentito specificare l'opzione " --secret ". Questo valore è facoltativo. Il valore predefinito è token.

Esempio

L'esempio seguente aggiorna una sottoscrizione di evento Kafka per utilizzare kafka-topic2 invece di kafka-topic1.

ibmcloud ce subscription kafka update --name mykafkasubscription --topic kafka-topic2

Output di esempio

Updating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

Comando della versione

Visualizza la versione dell'interfaccia a riga di comando code-engine.

`ibmcloud ce version`

Visualizza la versione dell'interfaccia a riga di comando code-engine.

ibmcloud ce version [--quiet]

Opzioni di comando

--quiet, -q: Specificare questa opzione per ridurre l'output del comando. Questo valore è facoltativo. Il valore predefinito è false.

Esempio

ibmcloud ce version

Output di esempio

version:  v1.17.0
commit:   3ab130b746f4784c9ff8d3da7bb05b6e7acda6d5