Options de commande

--name, -n

Nom de l'application à lier. Cette valeur est obligatoire.

--no-wait, --nw

Lie l'instance de service sans attendre que la liaison de service soit prête. Si vous spécifiez l'option no-wait, la création de liaison de service démarre et la commande prend fin sans attendre la fin de l'exécution. Utilisez la commande app getpour vérifier le statut de la liaison d'application. Cette valeur est facultative. La valeur par défaut est false.

--prefix, -p

Préfixe des variables d'environnement qui sont créées pour cette liaison de service. Ne doit contenir que des lettres en majuscules, des chiffres et des traits de soulignement (_) et ne peut pas débuter par un chiffre. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--role, -r

Nom d'un rôle de service pour les nouvelles données d'identification de service créées pour cette liaison de service. Les valeurs valides sont Reader, Writer, Manager ou un rôle propre au service. L'option prend par défaut la valeur Manager ou le premier rôle fourni par le service si Manager n'est pas pris en charge. Cette option est ignorée si --service-credential est spécifié. Cette valeur est facultative.

--service-credential, --sc

Nom d'une donnée d'identification de service existante qui doit être utilisée pour cette liaison de service. Si vous ne spécifiez pas de donnée d'identification d'instance de service, de nouvelles données d'identification sont générées lors de l'action de liaison. Cette valeur est facultative.

--service-instance, --si

Nom d'une instance de service IBM Cloud existante qui doit être liée à l'application. Cette valeur est facultative.

--service-instance-id, --siid

L'identificateur global unique d'une instance de service IBM Cloud existante à lier à l'application. Cette valeur est facultative.

--wait, -w

Permet de lier l'instance de service et d'attendre que la liaison de service soit prête. Si vous spécifiez l'option--wait, la liaison d'application attend une durée maximale en secondes, définie par l'option--wait-timeout, pour que la liaison d'application se termine correctement. Si la liaison d'application ne se termine pas correctement ou échoue dans le délai --wait-timeout spécifié, la commande échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que la liaison de service soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 300.

Exemple

Dans cet exemple, associez votre instance du service « IBM Cloud Object Storage » nommée « my-object-storage » à votre application nommée « myapp ».

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

Exemple de sortie

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

Options de commande

-n, --name

Nom de l'application. Utilisez un nom unique dans le projet.

• Le nom doit débuter par une lettre en minuscule.
• Le nom doit se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 63 caractères au maximum et peut contenir des lettres minuscules, des chiffres et des tirets (-).

Cette valeur est obligatoire.

--argument, --arg, -a

Permet de définir des arguments pour l'application. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur remplace les valeurs par défaut qui sont spécifiées dans l'image de conteneur. Cette valeur est facultative.

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

Validation, balise ou branche du référentiel source à extraire. L'option build commit n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative.

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

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. L'option de répertoire de contexte de construction n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative.

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

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. L'option build dockerfile n'est autorisée que si l'option --build-source est définie. Cette valeur est facultative. La valeur par défaut est Dockerfile.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option --build-source est définie sur URL d'un référentiel Git. Cette valeur est facultative.

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

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. L'option "build size" n'est autorisée que si l'option " --build-source " est activée. Cette valeur est facultative. La valeur par défaut est medium.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

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

Stratégie à utiliser pour générer l'image. Les valeurs valides sont dockerfile et buildpacks. L'option de stratégie de construction n'est autorisée que si l'option --build-source est activée. Si aucune valeur n'est indiquée, la stratégie de compilation est déterminée par Code Engine si --build-source est spécifié et que la source se trouve sur votre ordinateur local. Cette valeur est facultative. La valeur par défaut est dockerfile.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. L'option build timeout n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative. La valeur par défaut est 600.

--cluster-local, --cl

Déployez l'application avec un nœud final de type projet-uniquement. La définition d'un nœud final de projet uniquement signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau est possible uniquement à partir d'autres composants Code Engine qui s'exécutent dans le même projet. Cette valeur est facultative. La valeur par défaut est false.

--command, --cmd, -c

Permet de définir des commandes pour l'application. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--concurrency, --cn

Nombre maximal de demandes pouvant être traitées simultanément par instance. Cette valeur est facultative. La valeur par défaut est 100.

--concurrency-target, --ct

Seuil de demandes simultanées par instance auquel une ou plusieurs instances supplémentaires sont créées. Utilisez cette valeur pour augmenter le nombre d'instances en fonction du nombre simultané de demandes. Si --concurrency-target n'est pas spécifié, cette option prend par défaut la valeur de l'option --concurrency. Cette valeur est facultative. La valeur par défaut est 0.

--cpu

Quantité d'UC définie pour l'instance de l'application. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Permet de définir des variables d'environnement dans l'application. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère à définir pour l'instance de l'application. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative. La valeur par défaut est 400M.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec les options --env-from-configmap ou --mount-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret, --mount-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Nom de l'image utilisée pour cette application. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. L'option d'image est obligatoire si l'option --build-sourcen'est pas spécifiée. Cette valeur est facultative.

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

Nombre maximal d'instances pouvant être utilisées pour cette application. Si vous définissez cette valeur sur 0, les mises à l'échelle d'application sont nécessaires. La mise à l'échelle de l'application est limitée uniquement par les instances par le quota de ressources alloué pour le projet de votre application. Voir Limites et quotas pour Code Engine. Cette valeur est facultative. La valeur par défaut est 10.

--memory, -m

Quantité de mémoire définie pour l'instance de l'application. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 4G.

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

Nombre minimal d'instances pouvant être utilisées pour cette application. Cette option permet de s'assurer qu'aucune instance n'est en cours d'exécution lorsque cela n'est pas nécessaire. Cette valeur est facultative. La valeur par défaut est 0.

--mount-configmap, --mount-cm

Ajoute le contenu d'une mappe de configuration au système de fichiers de votre conteneur d'applications en fournissant un répertoire de montage et le nom d'une mappe de configuration, avec le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoute le contenu d'un secret au système de fichiers de votre conteneur d'applications en fournissant un répertoire de montage et le nom d'un secret, avec le format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

--no-cluster-local, --ncl

Déployer l'application avec un noeud final public. L'application se déploie de telle sorte qu'elle puisse recevoir des demandes provenant de l'Internet public ou des composants du projet Code Engine. Cette valeur est facultative. La valeur par défaut est true.

--no-wait, --nw

Crée l'application et n'attend pas que l'application soit prête. Si vous spécifiez l'option --no-wait, la création de l'application démarre sans attendre. Utilisez la commande app get pour vérifier le statut de l'application. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, urlet project-url. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--port, -p

Port sur lequel l'application est en mode écoute. Le format est [NAME:]PORT, où [NAME:] est facultatif. Si [NAME:] est spécifié, les valeurs valides sont h2c ou http1. Lorsque [NAME:] n'est pas spécifié ou a pour valeur http1, le port utilise HTTP/1.1. Lorsque [NAME:] a pour valeur h2c, il utilise HTTP/2 en mode non chiffré. Par défaut, Code Engine part de l'hypothèse que les applications écoutent les connexions entrantes sur le port 8080. Si votre application doit écouter un port autre que le port 8080, utilisez --port pour spécifier ce port. Cette valeur est facultative.

--probe-live, --pl

Configurez la sonde d'activité pour cette application au format NAME=VALUE. Les options valables pour NAME sont : type, port, path, interval, initial-delay, timeout, failure-threshold. Cette option peut être spécifiée plusieurs fois. La propriété type est obligatoire et les valeurs valides sont tcp et http. Par exemple, --probe-live type=tcp --probe-live port=8080. Pour plus d'informations sur l'utilisation des sondes, voir Configuration des sondes pour votre application. Cette valeur est facultative.

--probe-ready, --pr

Configurez la sonde de conformité pour cette application au format NAME=VALUE. Les options valables pour NAME sont : type, port, path, interval, initial-delay, timeout, failure-threshold. Cette option peut être spécifiée plusieurs fois. La propriété type est obligatoire et les valeurs valides sont tcp et http. Par exemple, --probe-ready type=tcp --probe-ready port=8080. Pour plus d'informations sur l'utilisation des sondes, voir Configuration des sondes pour votre application. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

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

Délai en secondes avant la réussite ou l'échec des demandes adressées à l'application. Cette valeur est facultative. La valeur par défaut est 300.

--rn, --revision-name

Nom de la révision. Utilisez un nom unique dans l'application.

• Le nom peut contenir des lettres minuscules, des nombres et des traits d'union (-).
• Le nom doit se terminer par un caractère alphanumérique en minuscule.
• Le nom de révision complet doit être au format Name_of_application-Name of revision.
• Le nom de révision complet doit être composé de 63 caractères ou moins.

Cette valeur est facultative.

--scale-down-delay, --sdd

Durée, en secondes, qui doit s'écouler à un niveau d'accès concurrents réduits avant que l'application ne soit réduite. L'augmentation du nombre de requêtes simultanées entraîne la mise à l'échelle d'une application. Si le nombre de demandes diminue (baisse de la concurrence), le délai spécifié pour cette option détermine la durée pendant laquelle la baisse de la concurrence doit persister, avant que l'application ne soit réduite. Par défaut, l'application sera immédiatement réduite si une baisse de la concurrence est détectée. Cette valeur est facultative. La valeur par défaut est 0.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

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

Activer le montage d'un jeton de ressource de calcul dans le conteneur de cette application. Cette valeur est facultative. La valeur par défaut est false.

--user, -u

ID utilisateur employé pour exécuter l'application. Cette valeur remplace tout ID utilisateur défini dans le fichier Dockerfile de l'application. L'ID doit être conforme aux exigences du système d'exploitation du conteneur. Cette valeur est facultative. La valeur par défaut est 0.

--visibility, -v

La visibilité de l'application. Les valeurs valides sont : public, private et project. La définition d'une visibilité de public signifie que votre application peut recevoir des demandes provenant de l'Internet public ou des composants du projet Code Engine. La définition d'une visibilité de private signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau n'est possible qu'à partir d'autres IBM Cloud utilisant des nœuds finaux privés virtuels (VPE) ou des composants Code Engine qui s'exécutent dans le même projet. La visibilité ne peut être private que si le projet prend en charge la visibilité privée de l'application. La définition d'une visibilité de project signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau est possible uniquement à partir d'autres composants Code Engine qui s'exécutent dans le même projet. Cette valeur est facultative.

--wait, -w

Crée l'application et attend que l'application soit prête. Si vous spécifiez l'option --wait, l'application crée des plages d'attente définies pour une durée maximale en secondes, dans l'option --wait-timeout, pour laisser à l'application le temps d'être prête. Si l'application n'est pas prête dans le délai wait-timeout spécifié, sa création échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que l'application soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

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

Lorsque vous exécutez ibmcloud ce application get -n 'myapp' pour vérifier le statut de l'application, l'URL de cette dernière s'affiche.

Options de commande

--name, -n

Nom de l'application. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--no-wait, --nw

Supprime l'application sans attendre. Si vous spécifiez l'option no-wait, la suppression de l'application commence sans attendre. Utilisez la commande app get pour vérifier le statut de l'application. Cette valeur est facultative. La valeur par défaut est true.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Supprime l'application et attend pour procéder à la suppression. Si vous spécifiez l'option --wait, la suppression de l'application est mise en attente pour une durée maximale en secondes, définie dans l'option --wait-timeout, avant de supprimer l'application. Si l'application n'est pas supprimée dans le délai --wait-timeout spécifié, sa suppression échoue. Cette valeur est facultative. La valeur par défaut est false.

--wait-timeout, --wto

Délai d'attente en secondes avant la suppression de l'application. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

ibmcloud ce application delete --name myapp -f

Exemple de sortie

Deleted application 'myapp'

Options de commande

--application, --app, -a, --name, -n

Permet d'afficher les événements de toutes les instances de l'application spécifiée. Cette valeur est obligatoire si --instance n'est pas spécifié.

--instance, -i

Nom d'une instance d'application spécifique. Utilisez la commande app get pour identifier le nom de l'instance. Cette valeur est obligatoire si --application n'est pas spécifié.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple suivant affiche les informations d'événement système de toutes les instances d'une application spécifiée.

ibmcloud ce application events --application myapp

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

Exemple d'informations d'événement système pour l'instance spécifiée d'une application

L'exemple suivant affiche les informations d'événement système d'une instance spécifiée d'une application. Utilisez la commande app get pour afficher les détails relatifs à votre application, y compris ses instances en cours d'exécution.

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

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
    [...]

Options de commande

--name, -n

Nom de l'application. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, urlet project-url. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--show-all-revisions, -r

Permet d'afficher toutes les révisions de cette application. Si cette option n'est pas spécifiée, seules les révisions configurées pour recevoir du trafic sont affichées. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce application get --name myapp

Exemple de sortie

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

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce app list --sort-by age

Exemple de sortie

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

Options de commande

--all-containers, --all

Permet d'afficher les journaux de tous les conteneurs des instances d'application spécifiées. Cette valeur est facultative. La valeur par défaut est false.

--application, --app, -a, --name, -n

Permet d'afficher les journaux de toutes les instances de l'application spécifiée. Cette valeur est obligatoire si --instance n'est pas spécifié.

--follow, -f

Permet de suivre les journaux des instances de l'application. Utilisez cette option pour diffuser les journaux des instances de l'application. Si vous spécifiez l'option --follow, vous devez entrer Ctrl+C pour mettre fin à cette commande de journal. Cette valeur est facultative. La valeur par défaut est false.

--instance, -i

Nom d'une instance d'application spécifique. Utilisez la commande app get pour identifier le nom de l'instance. Cette valeur est obligatoire si --application n'est pas spécifié.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--raw, -r

Permet d'afficher les journaux sans les libellés d'instance et de conteneur. Cette valeur est facultative. La valeur par défaut est false.

--tail, -t

Permet de limiter l'affichage des journaux des conteneurs des instances d'application spécifiées à un nombre maximal de lignes récentes par conteneur. Par exemple, pour afficher les dernières lignes 3 des journaux des conteneurs des instances d'application spécifiées, indiquez --tail 3. Si cette option n'est pas spécifiée, toutes les lignes des journaux des conteneurs des instances d'application spécifiées sont affichées. Cette valeur est facultative. La valeur par défaut est -1.

--timestamps, --ts

Permet d'inclure des horodatages sur chaque ligne dans la sortie de journal. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple suivant affiche les journaux d'une instance spécifique d'une application. Utilisez la commande app get pour obtenir le nom des instances d'application.

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

Exemple de sortie

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/

Exemple de journaux de toutes les instances d'une application

L'exemple suivant affiche les journaux de toutes les instances d'une application.

ibmcloud ce application logs --app myapp

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/

Options de commande

--application, --app, -a, --name, -n

Redémarrer toutes les instances en cours d'exécution de l'application spécifiée. Cette valeur est obligatoire si --instance n'est pas spécifié.

--instance, -i

Nom d'une instance d'application spécifique. Utilisez la commande app get pour identifier le nom de l'instance. Cette valeur est obligatoire si --application n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce application restart --name myapp

Exemple de sortie

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

Options de commande

--name, -n

Nom de l'application pour laquelle vous souhaitez annuler la liaison. Cette valeur est obligatoire.

--all, -A

Permet d'annuler la liaison de toutes les instances de service avec cette application. Cette valeur est obligatoire si --binding n'est pas spécifié. La valeur par défaut est false.

--binding, -b

Nom de la liaison à annuler. Exécutez ibmcloud ce app get -n APP_NAME pour afficher les noms de liaison. Cette valeur est obligatoire si --all n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

Cet exemple permet de retirer toutes les liaisons de votre application nommée myapp.

ibmcloud ce application unbind --name myapp --all

Exemple de sortie

Removing service bindings...
OK

Options de commande

--name, -n

Nom de l'application. Cette valeur est obligatoire.

--argument, --arg, -a

Permet de définir des arguments pour l'application. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur est facultative.

--arguments-clear, --ac

Permet d'effacer les arguments d'une application. Cette valeur est facultative. La valeur par défaut est false.

--build-clear, --bc

Supprimez l'association d'une génération à partir de cette application. L'option « Effacer la compilation » n'est disponible que si votre application dispose actuellement d'une compilation associée. Cette valeur est facultative. La valeur par défaut est false.

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

Validation, balise ou branche du référentiel source à extraire. L'option « build commit » n'est autorisée que si l'option « --build-source » est définie sur l' URL d'un dépôt Git via cette commande app update, ou si votre application dispose actuellement d'une version associée provenant d'un dépôt Git. Cette valeur est facultative.

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

Effacer la validation, la balise ou la branche dans le référentiel source pour l'extraction. L'option « commit clear » est autorisée si votre application dispose actuellement d'une version associée. Cette valeur est facultative. La valeur par défaut est false.

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

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. L'option de répertoire de contexte de génération est autorisée si l'option --build-sourceest définie sur cette commande app updateou si votre application dispose actuellement d'une génération associée. Cette valeur est facultative.

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

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. L'option « build dockerfile » n'est autorisée que si l'option « --build-source » est définie dans cette commande « app update », ou si votre application dispose actuellement d'une build associée. Cette valeur est facultative. La valeur par défaut est Dockerfile.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option « --build-source » est définie sur l'adresse URL d'un référentiel Git via cette commande application update, ou si votre application dispose actuellement d'une version associée provenant d'un référentiel Git. Cette valeur est facultative.

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

Effacer le secret SSH. Cette option est autorisée si votre application dispose actuellement d'une version associée. Cette valeur est facultative. La valeur par défaut est false.

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

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. L'option « build size » n'est autorisée que si l'option « --build-source » est activée dans cette commande « app update », ou si votre application dispose actuellement d'une version associée. Cette valeur est facultative. La valeur par défaut est medium.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

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

Stratégie à utiliser pour générer l'image. Les valeurs valides sont dockerfile et buildpacks. L'option de stratégie de compilation n'est autorisée que si l'option « --build-source » est activée dans cette commande « app update », ou si votre application dispose actuellement d'une compilation associée. Si elle n'est pas spécifiée, la stratégie de génération est déterminée par Code Engine si --build-source est spécifié et si la source se trouve sur votre machine locale. Cette valeur est facultative. La valeur par défaut est dockerfile.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. L'option de délai d'expiration de la compilation n'est autorisée que si l'option « --build-source » est définie dans cette commande « app update », ou si votre application dispose actuellement d'une compilation associée. Cette valeur est facultative. La valeur par défaut est 600.

--cluster-local, --cl

Déployez l'application avec un nœud final de type projet-uniquement. La définition d'un nœud final de projet uniquement signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau est possible uniquement à partir d'autres composants Code Engine qui s'exécutent dans le même projet. Cette valeur est facultative. La valeur par défaut est false.

--command, --cmd, -c

Permet de définir des commandes pour l'application. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--commands-clear, --cc

Permet d'effacer les commandes d'une application. Cette valeur est facultative. La valeur par défaut est false.

--concurrency, --cn

Nombre maximal de demandes pouvant être traitées simultanément par instance. Cette valeur est facultative. La valeur par défaut est 0.

--concurrency-target, --ct

Seuil de demandes simultanées par instance auquel une ou plusieurs instances supplémentaires sont créées. Utilisez cette valeur pour augmenter le nombre d'instances en fonction du nombre simultané de demandes. Si --concurrency-target n'est pas spécifié, cette option prend par défaut la valeur de l'option --concurrency. Cette valeur est facultative. La valeur par défaut est 0.

--cpu

Quantité d'UC définie pour l'instance de l'application. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 0.

--env, -e

Permet de définir des variables d'environnement dans l'application. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des mappes de configuration complètes en utilisant le nom de la mappe de configuration. Pour retirer des références de clé individuelles à des mappes de configuration, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des secrets intégraux en utilisant le nom de secret. Pour retirer des références de clé individuelles à des secrets, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--env-rm

Permet de retirer des références de variable d'environnement à la clé d'une paire clé-valeur dans une mappe de configuration ou un secret. Pour retirer des références de clé individuelles et des valeurs littérales, spécifiez le nom de la clé. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère à définir pour l'instance de l'application. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec les options --env-from-configmap ou --mount-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret, --mount-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Nom de l'image utilisée pour cette application. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

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

Nombre maximal d'instances pouvant être utilisées pour cette application. Si vous définissez cette valeur sur 0, les mises à l'échelle d'application sont nécessaires. La mise à l'échelle de l'application est limitée uniquement par les instances par le quota de ressources alloué pour le projet de votre application. Voir Limites et quotas pour Code Engine. Cette valeur est facultative. La valeur par défaut est 10.

--memory, -m

Quantité de mémoire définie pour l'instance de l'application. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative.

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

Nombre minimal d'instances pouvant être utilisées pour cette application. Cette valeur est facultative. La valeur par défaut est 0.

--mount-configmap, --mount-cm

Ajoute le contenu d'une mappe de configuration au système de fichiers de votre conteneur d'applications en fournissant un répertoire de montage et le nom d'une mappe de configuration, avec le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-rm

Retire le contenu d'une mappe de configuration ou d'un secret du système de fichiers de votre conteneur d'applications en spécifiant le répertoire dans lequel la mappe de configuration ou le secret est monté. Spécifiez un répertoire de montage par option --mount-rm, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b, par exemple. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoute le contenu d'un secret au système de fichiers de votre conteneur d'applications en fournissant un répertoire de montage et le nom d'un secret, avec le format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

--no-cluster-local, --ncl

Déployer l'application avec un noeud final public. L'application se déploie de telle sorte qu'elle puisse recevoir des demandes provenant de l'Internet public ou des composants du projet Code Engine. Cette valeur est facultative. La valeur par défaut est true.

--no-wait, --nw

Met à jour l'application et n'attend pas que l'application soit prête. Si vous spécifiez l'option no-wait, la mise à jour de l'application commence sans attendre. Utilisez la commande app get pour vérifier le statut de l'application. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, urlet project-url. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--port, -p

Port sur lequel l'application est en mode écoute. Le format est [NAME:]PORT, où [NAME:] est facultatif. Si [NAME:] est spécifié, les valeurs valides sont h2c ou http1. Lorsque [NAME:] n'est pas spécifié ou a pour valeur http1, le port utilise HTTP/1.1. Lorsque [NAME:] a pour valeur h2c, il utilise HTTP/2 en mode non chiffré. Par défaut, Code Engine part de l'hypothèse que les applications écoutent les connexions entrantes sur le port 8080. Si votre application doit écouter un port autre que le port 8080, utilisez --port pour spécifier ce port. Cette valeur est facultative.

--probe-live, --pl

Configurez la sonde d'activité pour cette application au format NAME=VALUE. Les options valables pour NAME sont : type, port, path, interval, initial-delay, timeout, failure-threshold. Cette option peut être spécifiée plusieurs fois. La propriété type est obligatoire et les valeurs valides sont tcp et http. Par exemple, --probe-live type=tcp --probe-live port=8080. Pour plus d'informations sur l'utilisation des sondes, voir Configuration des sondes pour votre application. Cette valeur est facultative.

--probe-live-clear, --plr

Supprimez la sonde d'activité. Cette option n'est autorisée que si votre application dispose actuellement d'une sonde de vivacité. Cette valeur est facultative. La valeur par défaut est false.

--probe-ready, --pr

Configurez la sonde de conformité pour cette application au format NAME=VALUE. Les options valables pour NAME sont : type, port, path, interval, initial-delay, timeout, failure-threshold. Cette option peut être spécifiée plusieurs fois. La propriété type est obligatoire et les valeurs valides sont tcp et http. Par exemple, --probe-ready type=tcp --probe-ready port=8080. Pour plus d'informations sur l'utilisation des sondes, voir Configuration des sondes pour votre application. Cette valeur est facultative.

--probe-ready-reset, --prr

Réinitialise la sonde de conformité à la configuration par défaut. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--rebuild

Régénérez l'image à partir de la source. L'option de reconstruction est autorisée si votre application dispose actuellement d'une génération associée. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

--registry-secret-clear, --rsc

Effacer le secret du registre. Cette valeur est facultative. La valeur par défaut est false.

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

Délai en secondes avant la réussite ou l'échec des demandes adressées à l'application. Cette valeur est facultative. La valeur par défaut est 0.

--rn, --revision-name

Nom de la révision. Utilisez un nom unique dans l'application.

• Le nom peut contenir des lettres minuscules, des nombres et des traits d'union (-).
• Le nom doit se terminer par un caractère alphanumérique en minuscule.
• Le nom de révision complet doit être au format Name_of_application-Name of revision.
• Le nom de révision complet doit être composé de 63 caractères ou moins.

Cette valeur est facultative.

--scale-down-delay, --sdd

Durée, en secondes, qui doit s'écouler à un niveau d'accès concurrents réduits avant que l'application ne soit réduite. L'augmentation du nombre de requêtes simultanées entraîne la mise à l'échelle d'une application. Si le nombre de demandes diminue (baisse de la concurrence), le délai spécifié pour cette option détermine la durée pendant laquelle la baisse de la concurrence doit persister, avant que l'application ne soit réduite. Par défaut, l'application sera immédiatement réduite si une baisse de la concurrence est détectée. Cette valeur est facultative. La valeur par défaut est 0.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

--service-account-clear, --sac

Effacer le compte de service. Cette valeur est facultative. La valeur par défaut est false.

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

Activer le montage d'un jeton de ressource de calcul dans le conteneur de cette application. Cette valeur est facultative. La valeur par défaut est false.

--user, -u

ID utilisateur employé pour exécuter l'application. Cette valeur remplace tout ID utilisateur défini dans le fichier Dockerfile de l'application. L'ID doit être conforme aux exigences du système d'exploitation du conteneur. Cette valeur est facultative. La valeur par défaut est 0.

--visibility, -v

La visibilité de l'application. Les valeurs valides sont : public, private et project. La définition d'une visibilité de public signifie que votre application peut recevoir des demandes provenant de l'Internet public ou des composants du projet Code Engine. La définition d'une visibilité de private signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau n'est possible qu'à partir d'autres IBM Cloud utilisant des nœuds finaux privés virtuels (VPE) ou des composants Code Engine qui s'exécutent dans le même projet. La visibilité ne peut être private que si le projet prend en charge la visibilité privée de l'application. La définition d'une visibilité de project signifie que votre application n'est pas accessible à partir de l'accès public à Internet et que l'accès au réseau est possible uniquement à partir d'autres composants Code Engine qui s'exécutent dans le même projet. Cette valeur est facultative.

--wait, -w

Met à jour l'application et attend que l'application soit prête. Si vous spécifiez l'option --wait, la mise à jour de l'application est mise en attente pour une durée maximale en secondes, définie dans l'option --wait-timeout, pour laisser à l'application le temps d'être prête. Si l'application n'est pas prête dans le délai --wait-timeout spécifié, sa mise à jour échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant la mise à jour de l'application. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

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

Exemple

ibmcloud ce beta help

Exemple de sortie

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.

Options de commande

-n, --name

Nom de la génération. Utilisez un nom unique dans le projet.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 63 caractères au maximum et peut contenir des caractères alphanumériques en minuscule et des traits d'union (-).

Cette valeur est obligatoire.

--build-type, --bt

Type de génération. Les valeurs valides sont git et local. Si le type de génération est local, les options --source, --commitet --git-repo-secret ne sont pas valides. Cette valeur est facultative. La valeur par défaut est git.

--commit, --cm, --revision

Validation, balise ou branche du référentiel source à extraire. L'option de validation est autorisée si l'option --build-type est git et non autorisée si l'option --build-type est local. Cette valeur est facultative.

--context-dir, --cdr

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. Cette valeur est facultative.

--dockerfile, --df

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. Cette valeur est facultative. La valeur par défaut est Dockerfile.

--force, -f

Permet de ne pas vérifier l'existence des références de secret spécifiées. Les références de secret sont spécifiées avec l'option --get-repo-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option est autorisée si l'option --build-type est git et n'est pas autorisée si l'option --build-type est local. Cette valeur est facultative.

--image, -i

Emplacement du registre d'images. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où TAG est facultatif. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

La clé de registre utilisée pour accéder au registre. Vous pouvez ajouter la clé de registre en exécutant la commande « registry create ». Cette valeur est facultative.

--size, --sz

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. Cette valeur est facultative. La valeur par défaut est medium.

--source, --src

Adresse URL du référentiel Git qui contient votre code source. Par exemple https://github.com/IBM/CodeEngine. L'option source est obligatoire si l'option --build-type est git et non autorisée si l'option --build-type est local. Cette valeur est facultative.

--strategy, --str

Stratégie à utiliser pour générer l'image. Pour les candidatures et les offres d'emploi, les adresses valides sont dockerfile et buildpacks. Pour les fonctions, les valeurs valides se présentent sous la forme « codebundle-[RUNTIME-ID] ». Par exemple, si vous voulez construire un paquet de code pour votre fonction avec l'ID d'exécution nodejs-24, utilisez codebundle-nodejs-24 comme stratégie de construction. Vous pouvez trouver l'ID de toutes les fonctions prises en charge en exécutant la commande ibmcloud ce fn runtimes. Cette valeur est facultative. La valeur par défaut est dockerfile.

--timeout, --to

Délai en secondes avant la réussite ou l'échec de la génération. Cette valeur est facultative. La valeur par défaut est 600.

Exemple

L'exemple suivant crée un fichier de configuration de génération appelé helloworld-build à partir d'un fichier Dockerfile source stocké dans https://github.com/IBM/CodeEngine dans le répertoire hello de la branche main, avec la stratégie dockerfile et la taille medium (moyenne). Lorsque cette génération est soumise, l'image de conteneur générée est stockée dans une instance Container Registry à us.icr.io/mynamespace/codeengine-helloworld accessible à l'aide d'un secret de registre d'images appelé 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

Exemple de sortie

Creating build helloworld-build...
OK

Options de commande

--name, -n

Nom de la génération. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce build delete --name helloworld-build

Exemple de sortie

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

Options de commande

--name, -n

Nom de la génération. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce build get --name helloworld-build

Exemple de sortie

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

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce build list

Exemple de sortie

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

Options de commande

--name, -n

Nom de la génération. Cette valeur est obligatoire.

--commit, --cm, --revision

Validation, balise ou branche du référentiel source à extraire. Cette valeur est facultative.

--commit-clear, --cmc

Effacer la validation, la balise ou la branche dans le référentiel source pour l'extraction. Cette valeur est facultative. La valeur par défaut est false.

--context-dir, --cdr

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. Cette valeur est facultative.

--dockerfile, --df

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. Cette valeur est facultative. La valeur par défaut est Dockerfile.

--force, -f

Permet de ne pas vérifier l'existence des références de secret spécifiées. Les références de secret sont spécifiées avec l'option --get-repo-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette valeur est facultative.

--git-repo-secret-clear, --grsc

Effacer le secret SSH. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Emplacement du registre d'images. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où TAG est facultatif. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

--size, --sz

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. Cette valeur est facultative.

--source, --src

Adresse URL du référentiel Git qui contient votre code source. Par exemple https://github.com/IBM/CodeEngine. Cette valeur est facultative.

--strategy, --str

Stratégie à utiliser pour générer l'image. Pour les candidatures et les offres d'emploi, les adresses valides sont dockerfile et buildpacks. Pour les fonctions, les valeurs valides se présentent sous la forme « codebundle-[RUNTIME-ID] ». Par exemple, si vous voulez construire un paquet de code pour votre fonction avec l'ID d'exécution nodejs-24, utilisez codebundle-nodejs-24 comme stratégie de construction. Vous pouvez trouver l'ID de toutes les fonctions prises en charge en exécutant la commande ibmcloud ce fn runtimes. Cette valeur est facultative.

--timeout, --to

Délai en secondes avant la réussite ou l'échec de la génération. Cette valeur est facultative. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

Updating build helloworld-build...
OK

Options de commande

--name, -n

Nom de l'exécution de génération. Cette valeur est obligatoire.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce buildrun cancel --name mybuildrun

Exemple de sortie

Canceling build run 'mybuildrun'...
OK

Options de commande

--build, -b

Cette option permet de supprimer toutes les exécutions de génération de la génération spécifiée. L'option --build est requise si vous ne spécifiez pas la valeur --name. Cette valeur est facultative.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--name, -n

Nom de l'exécution de génération. L'option --name est requise si vous ne spécifiez pas la valeur --build. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce buildrun delete --name mybuildrun

Exemple de sortie

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

Options de commande

--buildrun, -b, --br, --name, -n

Nom de l'exécution de génération. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

Cet exemple affiche les informations d'événement système d'une exécution de génération.

ibmcloud ce buildrun events --buildrun mybuildrun

Exemple de sortie

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

Options de commande

--name, -n

Nom de l'exécution de génération. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce buildrun get --name mybuildrun

Exemple de sortie

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

Options de commande

--build, -b

Cette option permet d'afficher uniquement les exécutions de génération de la génération spécifiée. Cette valeur est facultative.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce buildrun list

Exemple de sortie

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

Options de commande

--buildrun, -b, --br, --name, -n

Nom de l'exécution de génération. Cette valeur est obligatoire.

--follow, -f

Permet de suivre les journaux de l'exécution de génération. Utilisez cette option pour diffuser les journaux de l'exécution de génération. Si vous spécifiez l'option --follow, vous devez entrer Ctrl+C pour mettre fin à cette commande de journal. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--raw, -r

Permet d'afficher les journaux sans les libellés d'instance et de conteneur. Cette valeur est facultative. La valeur par défaut est false.

--tail, -t

Permet de limiter l'affichage des journaux des conteneurs de l'exécution de génération spécifiée à un nombre maximal de lignes récentes par conteneur. Par exemple, pour afficher les dernières lignes 3 des journaux des conteneurs de l'exécution de génération spécifiée, indiquez --tail 3. Si cette option n'est pas spécifiée, toutes les lignes des journaux des conteneurs de l'exécution de compilation spécifiée sont affichées. Cette valeur est facultative. La valeur par défaut est -1.

--timestamps, --ts

Permet d'inclure des horodatages sur chaque ligne dans la sortie de journal. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce buildrun logs --name mybuildrun

Exemple de sortie

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"}}

Options de commande

--build, -b, --bd

Nom de la configuration de génération à utiliser. Cette valeur est facultative.

--commit, --cm, --revision

Validation, balise ou branche du référentiel source à extraire. L'option de validation de génération est autorisée si l'option --sourceest définie sur l'URL d'un référentiel Git et n'est pas autorisée si l'option --sourcen'est pas définie sur l'URL d'un référentiel Git. Cette valeur est facultative.

--context-dir, --cdr

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. L'option de répertoire de contexte de génération est autorisée si l'option --build n'est pas définie et n'est pas autorisée si l'option--build est définie. Cette valeur est facultative.

--dockerfile, --df

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. L'option de génération dockerfile est autorisée si l'option --buildn'est pas définie et n'est pas autorisée si l'option --build est définie. Cette valeur est facultative. La valeur par défaut est Dockerfile.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option --build-source est définie sur URL d'un référentiel Git. Cette valeur est facultative.

--image, -i

Emplacement du registre d'images. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où TAG est facultatif. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

-n, --name

Nom de l'exécution de génération. Utilisez un nom unique dans le projet. Si l'option --build est définie, l'option de nom est facultative. Si l'option --build n'est pas définie, l'option de nom est requise.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 63 caractères au maximum et peut contenir des caractères alphanumériques en minuscule et des traits d'union (-).

Cette valeur est facultative.

--no-wait, --nw

Permet de soumettre l'exécution de génération et de ne pas attendre qu'elle soit terminée. Si vous spécifiez l'option --no-wait, la soumission de l'exécution de génération démarre, sans attendre. Utilisez la commande buildrun get pour vérifier le statut de l'exécution de génération. Cette valeur est facultative. La valeur par défaut est true.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. L'option « registry secret » est autorisée si l'option « --build » n'est pas définie, et l'option « pas » est autorisée si l'option « --build » est définie. Cette valeur est facultative.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

--size, --sz

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. L'option « build size » est autorisée si l'option « --build » n'est pas définie, et n'est pas autorisée si l'option « --build » est définie. Cette valeur est facultative. La valeur par défaut est medium.

--source, --src

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Si l'option --buildest définie, l'option source est requise si l'option --build-typesur la génération associée est localet n'est pas autorisée si l'option --build-typede la génération associée estgit. Si l'option --buildn'est pas définie, l'option source est facultative. Cette valeur est facultative. La valeur par défaut est ..

--strategy, --str

Stratégie à utiliser pour générer l'image. Pour les candidatures et les offres d'emploi, les adresses valides sont dockerfile et buildpacks. Pour les fonctions, les valeurs valides se présentent sous la forme « codebundle-[RUNTIME-ID] ». Par exemple, si vous voulez construire un paquet de code pour votre fonction avec l'ID d'exécution nodejs-24, utilisez codebundle-nodejs-24 comme stratégie de construction. Vous pouvez trouver l'ID de toutes les fonctions prises en charge en exécutant la commande ibmcloud ce fn runtimes. L'option de stratégie de compilation est autorisée si l'option « --build » n'est pas définie, et n'est pas autorisée si l'option « --build » est définie. Si aucune valeur n'est indiquée, la stratégie de compilation est déterminée par Code Engine si --source est spécifié et que la source se trouve sur votre ordinateur local. Cette valeur est facultative. La valeur par défaut est dockerfile.

--timeout, --to

Délai en secondes avant la réussite ou l'échec de l'exécution de génération. Cette valeur est facultative. La valeur par défaut est 600.

--wait, -w

Permet de soumettre l'exécution de génération et d'attendre qu'elle soit terminée. Si vous spécifiez l'option --wait, le délai d'attente maximal, en secondes, de la soumission de l'exécution de génération pour que l'exécution de génération aboutisse est défini par l'option --wait-timeout. Si l'exécution de génération ne se termine pas dans le délai --wait-timeout spécifié, la soumission de l'exécution de génération échoue. Cette valeur est facultative. La valeur par défaut est false.

--wait-timeout, --wto

Délai d'attente, en secondes, avant que cette exécution de génération soit terminée. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

La commande illustrée ci-après permet de soumettre une exécution de génération nommée mybuildrun et d'utiliser le fichier de configuration de génération appelé helloworld-build.

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

Exemple de sortie

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

Options de commande

-n, --name

Nom de la mappe de configuration. Utilisez un nom unique dans le projet.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 253 caractères au maximum et peut contenir des lettres minuscules, des chiffres, des points (.) et des tirets (-).

Cette valeur est obligatoire.

--from-env-file, -e

Crée une mappe de configuration à partir d'un fichier contenant une ou plusieurs lignes correspondant au format KEY=VALUE. Vous devez fournir le chemin d'accès au fichier en tant que valeur. Chaque ligne du fichier spécifié est ajoutée en tant que paire clé-valeur. Toutes les lignes du fichier indiqué qui sont vides ou commencent par #sont ignorées. Cette valeur est obligatoire si --from-literal ou --from-file n'est pas spécifié.

--from-file, -f

Permet de créer une mappe de configuration depuis un fichier. Vous devez fournir le chemin d'accès au fichier en tant que valeur. Cette valeur est obligatoire si --from-literal ou --from-env-file n'est pas spécifié.

--from-literal, -l

Permet de créer une mappe de configuration depuis une paire clé-valeur. Le format requis est KEY=VALUE. Cette valeur est obligatoire si --from-file ou --from-env-file n'est pas spécifié. Cette option peut être spécifiée plusieurs fois.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple illustré ci-après crée une mappe de configuration nommée configmap-fromliteral avec deux valeurs de paire de clés : color=blue et size=large.

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

Exemple de sortie

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

Exemple de mappe de configuration avec des valeurs provenant de plusieurs fichiers

L'exemple illustré ci-après crée une mappe de configuration nommée configmap-fromfile avec des valeurs provenant de plusieurs fichiers.

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

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

Options de commande

--name, -n

Nom de la mappe de configuration. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

Deleting Configmap 'configmap-fromliteral'...
OK

Options de commande

--name, -n

Nom de la mappe de configuration. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce configmap get --name configmap-fromliteral

Exemple de sortie

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

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce configmap list

Exemple de sortie

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

Options de commande

--name, -n

Nom de la mappe de configuration. Cette valeur est obligatoire.

--from-env-file, -e

Met à jour une mappe de configuration à partir d'un fichier contenant une ou plusieurs lignes correspondant au format KEY=VALUE. Vous devez fournir le chemin d'accès au fichier en tant que valeur. Chaque ligne du fichier spécifié est ajoutée en tant que paire clé-valeur. Toutes les lignes du fichier indiqué qui sont vides ou commencent par #sont ignorées. Cette valeur est obligatoire si --from-literal ou --from-file n'est pas spécifié. Cette option peut être spécifiée plusieurs fois.

--from-file, -f

Permet de mettre à jour une mappe de configuration à partir d'un fichier. Vous devez fournir le chemin d'accès au fichier en tant que valeur. Cette valeur est obligatoire si --from-literal ou --from-env-file n'est pas spécifié. Cette option peut être spécifiée plusieurs fois.

--from-literal, -l

Permet de mettre à jour une mappe de configuration à partir d'une paire clé-valeur. Le format requis est KEY=VALUE. Cette valeur est obligatoire si --from-file ou --from-env-file n'est pas spécifié. Cette option peut être spécifiée plusieurs fois.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--rm

Permet de retirer une paire clé-valeur individuelle d'une mappe de configuration en spécifiant le nom de la clé. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

Exemple

L'exemple illustré ci-après met à jour une mappe de configuration nommée configmap-fromliteral avec une paire de valeurs de nom d'utilisateur et de mot de passe.

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

Exemple de sortie

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

Exemple de mappe de configuration avec des valeurs d'un fichier

L'exemple illustré ci-après met à jour une mappe de configuration nommée configmap-fromfile avec des valeurs provenant d'un fichier.

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

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

Exemple

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

Exemple de sortie

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

Exemple de création d'une connexion sortante sur un chemin privé

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

Exemple de sortie pour créer une connexion sortante sur un chemin privé

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

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Exemple d'obtention d'une connexion sortante sur un chemin privé

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

Exemple de sortie pour obtenir une connexion sortante sur un chemin privé

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

Exemple

ibmcloud ce connectivity outbound list

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Exemple

ibmcloud ce connectivity subnetpool list

Exemple de sortie

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

Options de commande

--domain-name, --dn, -n, --name

Spécifiez le nom du mappage de domaine. Ce nom doit être un nom de domaine complet valide. Par exemple, www.example.com. Cette valeur est obligatoire.

--target, -t

Nom de l'application ou de la fonction cible. Cette valeur est obligatoire.

--target-type, --type

Type de la cible. Les valeurs valides sont application ou function. Cette valeur est obligatoire.

--tls-secret, --secret, --tls

Indiquez un secret de type « TLS » contenant le certificat, y compris tous ses certificats intermédiaires, ainsi que la clé privée correspondante pour le mappage de domaine. Le certificat doit être signé par une autorité de certification publique digne de confiance. Les certificats autosignés ne sont pas pris en charge. Cette valeur est obligatoire.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple suivant crée un mappage de domaine personnalisé entre l'application Code Engine myapp et le domaine personnalisé www.example.com et utilise le secret TLS, mytlssecret.

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

Exemple de sortie

OK
Domain mapping successfully created.

Options de commande

--domain-name, --dn, -n, --name

Nom du mappage de domaine. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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

Options de commande

--domain-name, --dn, -n, --name

Le nom du mappage de domaine Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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  

Options de commande

--all, -a

Affichez tous les mappages de domaine dans un projet, y compris les mappages de domaine système et personnalisés. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

L'exemple suivant affiche une liste de tous les mappages de domaines personnalisés.

ibmcloud ce domainmapping list

Exemple de sortie

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    

Pour afficher une liste de tous les mappages de domaines pour vos applications, y compris les mappages de domaines personnalisés et les mappages de domaines générés automatiquement par le système, spécifiez l'option --all avec la commande ibmcloud ce domainmapping list avec la commande

Options de commande

--domain-name, --dn, -n, --name

Nom du mappage de domaine. Cette valeur est obligatoire.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--target, -t

Nom de l'application ou de la fonction cible. Cette valeur est facultative.

--target-type, --type

Type de la cible. Les valeurs valides sont application ou function. Cette valeur est facultative.

--tls-secret, --secret, --tls

Indiquez un secret de type « TLS » contenant le certificat, y compris tous ses certificats intermédiaires, ainsi que la clé privée correspondante pour le mappage de domaine. Le certificat doit être signé par une autorité de certification publique digne de confiance. Les certificats autosignés ne sont pas pris en charge. Cette valeur est facultative.

Exemple

L'exemple suivant met à jour le mappage du domaine www.example.com pour utiliser mytlssecret2 au lieu de mytlssecret.

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

Exemple de sortie

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

Exemple

ibmcloud ce experimental help

Exemple de sortie

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.

Options de commande

--id, --fid, --fleet-id

Obligatoire. L’ID de la flotte serveur. Cette valeur est obligatoire.

--force, -f

Forcer l’annulation sans confirmation. Cette valeur est facultative. La valeur par défaut est false.

--hard

Annulez immédiatement la flotte sans serveur, y compris les tâches dont l'état est « running ». Si vous ne spécifiez pas l'option « hard », le traitement des tâches en état « running » se poursuit jusqu'à ce qu'elles atteignent un état final, et ce n'est qu'à ce moment-là que la flotte passe à l'état « canceled ». Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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  

Options de commande

--image, -i

Obligatoire. Nom de l’image de conteneur utilisée pour traiter les tâches. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est obligatoire.

--tasks-state-store, --ts-state

Obligatoire. Indiquez le magasin de données persistantes qui conserve l'état des tâches de la flotte. Cette valeur est obligatoire.

--argument, --arg, -a

Définir les arguments nécessaires à l'exécution de la commande dans la tâche. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--command, --cmd, -c

Définir une commande à exécuter dans la tâche. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--cpu, --cp

Quantité d'UC à définir pour une tâche. Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Définir les variables d'environnement à transmettre à la tâche. Doit être au format NAME=VALUE. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans ce ConfigMap. Entrez NAME pour faire référence à la mappe de configuration complète, ou PREFIX=NAME pour faire référence à la mappe de configuration complète dans laquelle chaque clé est préfixée avec PREFIX, ou NAME:KEY_A,KEY_B pour faire référence à des clés individuelles. Pour spécifier un nouveau nom pour une clé référencée, utilisez le format NAME:NEW_KEY_NAME=KEY_A. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans ce secret. Entrez NAME pour faire référence au secret complet, ou PREFIX=NAME pour faire référence au secret complet dans lequel chaque clé est préfixée avec PREFIX, ou NAME:KEY_A,KEY_B pour faire référence à des clés individuelles. Pour spécifier un nouveau nom pour une clé référencée, utilisez le format NAME:NEW_KEY_NAME=KEY_A. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--gpu, --gp

Nombre de GPU à allouer à la ressource. Le format est GPU_FAMILY:NUMBER_OF_GPUS. La valeur par défaut de NUMBER_OF_GPUS est 1 et elle peut être une fraction. Par exemple, h100:0.5 Cette valeur est facultative.

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

Nombre maximal d'instances de tâches à exécuter en parallèle. Cette valeur est facultative. La valeur par défaut est 1.

--maxexecutiontime, --met

Durée maximale d'exécution d'une tâche, exprimée en secondes. Cette valeur est facultative. La valeur par défaut est 0.

--memory, -m

Quantité de mémoire à définir pour une tâche. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative. La valeur par défaut est 2G.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME: [SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--name, -n

Nom de la flotte. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret du registre est utilisé pour s'authentifier auprès d'un registre privé afin de télécharger l'image du conteneur. Exécutez la commande « ibmcloud ce registry create » pour créer une clé secrète dans le registre. Cette valeur est facultative.

--retrylimit, -r

Nombre de fois qu'une tâche doit être relancée avant d'être considérée comme ayant échoué. Cette valeur est facultative. La valeur par défaut est 3.

--subnetpool-id, --spi

ID du pool de sous-réseaux à utiliser pour l'attribution du réseau de la flotte. Cette valeur est facultative.

--subnetpool-name, --spn

Nom du pool de sous-réseaux à utiliser pour le placement réseau de la flotte. Cette valeur est facultative.

--task-indexes, --ti

Indiquez les index des tâches à traiter, par exemple 0,3,6,9, 1-5,7-8,10. Ne spécifiez pas plus de 1 000 entrées d’index. Cette option ne peut pas être spécifiée si l'option « --tasks » est spécifiée. Cette valeur est facultative.

--tasks, --ts

Indiquez le nombre de tâches à traiter par la flotte. Si aucune option de spécification de tâche n'est fournie, cette option est utilisée avec la valeur par défaut « 1 ».

--tasks-from-cos-bucket, --ts-bucket

Indiquer l'emplacement des fichiers à l'intérieur d'un compartiment COS. Pour chaque fichier, les tâches doivent être traitées par la flotte. Cette valeur est facultative.

--tasks-from-cos-object, --ts-cos

Indiquez l'emplacement d'un fichier JSONL qui se trouve dans un compartiment COS. Ce fichier définit les tâches qui doivent être exécutées par la flotte. Cette valeur est facultative.

--tasks-from-local-file, --ts-file

Indiquez l'emplacement d'un fichier JSONL local. Ce fichier définit les tâches qui doivent être exécutées par la flotte. Cette valeur est facultative.

--worker-profile, --profile, --prof

Indiquez une préférence pour le profil de worker pris en charge. Cette valeur est facultative.

Exemple

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

Exemple de sortie

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

Options de commande

--id, --fid, --fleet-id

Obligatoire. L’ID de la flotte serveur. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Supprimez la flotte sans serveur et attendez que la fin de la suppression. Cette valeur est facultative. La valeur par défaut est false.

--wait-timeout, --wto

Délai d'attente en secondes pour la suppression de la flotte sans serveur. Cette valeur est facultative. La valeur par défaut est 180.

Exemple

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

Exemple de sortie

Deleting serverless fleet...
OK

Options de commande

--id, --fid, --fleet-id

Obligatoire. L’ID de la flotte serveur. Cette valeur est obligatoire.

--output, -o

Format de sortie. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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

Options de commande

--output, -o

Format de sortie. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name, status et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce fleet list

Exemple de sortie

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  

Options de commande

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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

Options de commande

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

Deleting serverless fleet worker...
OK

Exemple

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

Exemple de sortie

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  

Exemple

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

Exemple de sortie

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

Exemple

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

Exemple de sortie

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  

Options de commande

--name, -n

Nom de la fonction à lier. Cette valeur est obligatoire.

--no-wait, --nw

Lie l'instance de service sans attendre que la liaison de service soit prête. Si vous spécifiez l'option no-wait, la création de liaison de service démarre et la commande prend fin sans attendre la fin de l'exécution. Utilisez la commande « function get » pour vérifier l'état de la liaison de la fonction. Cette valeur est facultative. La valeur par défaut est false.

--prefix, -p

Préfixe des variables d'environnement qui sont créées pour cette liaison de service. Ne doit contenir que des lettres en majuscules, des chiffres et des traits de soulignement (_) et ne peut pas débuter par un chiffre. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--role, -r

Nom d'un rôle de service pour les nouvelles données d'identification de service créées pour cette liaison de service. Les valeurs valides sont Reader, Writer, Manager ou un rôle propre au service. L'option prend par défaut la valeur Manager ou le premier rôle fourni par le service si Manager n'est pas pris en charge. Cette option est ignorée si --service-credential est spécifié. Cette valeur est facultative.

--service-credential, --sc

Nom d'une donnée d'identification de service existante qui doit être utilisée pour cette liaison de service. Si vous ne spécifiez pas de donnée d'identification d'instance de service, de nouvelles données d'identification sont générées lors de l'action de liaison. Cette valeur est facultative.

--service-instance, --si

Nom d'une instance existante du service « IBM Cloud » à associer à la fonction. Cette valeur est facultative.

--service-instance-id, --siid

Le GUID d'une instance existante du service « IBM Cloud » à associer à la fonction. Cette valeur est facultative.

--wait, -w

Permet de lier l'instance de service et d'attendre que la liaison de service soit prête. Si vous spécifiez l'option « --wait », la fonction « bind » attend pendant une durée maximale en secondes, définie par l'option « --wait-timeout », que la fonction « bind » s'exécute correctement. Si la fonction « bind » ne s'effectue pas correctement ou échoue dans le délai spécifié ( --wait-timeout ), la commande échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que la liaison de service soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 300.

Exemple

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

Exemple de sortie

Binding service instance...
Status: Done
OK

Options de commande

-n, --name

Nom de la fonction. Utilisez un nom unique dans le projet.

• Le nom doit débuter par une lettre en minuscule.
• Le nom doit se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 63 caractères au maximum et peut contenir des lettres minuscules, des chiffres et des tirets (-).

Cette valeur est obligatoire.

--runtime, -r

La durée d'exécution à utiliser pour la fonction. Pour connaître les durées d'exécution prises en charge pour cette région, exécutez ibmcloud ce function runtimes. Voir Délais d'exécution. Cette valeur est obligatoire.

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

Validation, balise ou branche du référentiel source à extraire. Cette valeur est facultative.

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

Répertoire dans le référentiel qui contient le code source de votre fonction. Cette valeur est facultative.

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

Nom du secret SSH, qui contient les données d'identification permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de bundle de code. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option --build-source est définie sur URL d'un référentiel Git. Cette valeur est facultative.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. Cette valeur est facultative. La valeur par défaut est 600.

--code-bundle, --cb

Le nom de l'image code-bundle à utiliser pour cette fonction. Lorsque l'option « build-source » est spécifiée, cette valeur correspond au chemin d'accès à l'image de sortie générée par la publication de la version. Lorsque l' build-source n'est pas spécifiée, cette valeur correspond au chemin d'accès à l'image du bundle de code existant. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où TAG est facultatif. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

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

Nom du secret de registre utilisé pour l'authentification auprès d'un registre privé. Vous pouvez ajouter la clé de registre en exécutant la commande « registry create ». Cette valeur est facultative.

--cpu

Nombre d'unités centrales défini pour l'instance de la fonction. Pour connaître les valeurs valides, consultez la section « Combinaisons de mémoire et de processeurs prises en charge ». Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Définir des variables d'environnement dans la fonction. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans ce ConfigMap en utilisant l'une des méthodes suivantes.

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes.

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Cette valeur est facultative. La valeur par défaut est false.

--inline-code

Indiquez le chemin d'accès au fichier contenant le code source de votre fonction. Le code est intégré à la fonction. Cette valeur est facultative.

--main, --fn-main

Spécifiez le nom de votre fonction principale dans le code source fourni. Cette option est requise lorsque le nom n'est pas main. Cette valeur est facultative. La valeur par défaut est main.

--maxexecutiontime, --met

Durée maximale, en secondes, pendant laquelle cette fonction doit terminer son exécution. Cette valeur est facultative. La valeur par défaut est 60.

--memory, -m

La quantité de mémoire allouée à la fonction. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 4G.

--no-wait, --nw

N'attendez pas la fin de l'exécution de la génération. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--scale-down-delay, --sdd

Durée, en secondes, pendant laquelle une instance est active à la fin d'un appel. Cette option peut réduire les temps de démarrage à froid. Pour plus d'informations, voir Peut-on maintenir mon instance de fonction en vie plus longtemps? Cette valeur est facultative. La valeur par défaut est 1.

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

Activer le montage d'un jeton de ressource de calcul pour les exécutions de la fonction. Cette valeur est facultative. La valeur par défaut est false.

--visibility, -v

Visibilité de la fonction. Les valeurs valides sont : public, private et project. La visibilité ne peut être « private » que si le projet prend en charge la visibilité « private » des fonctions. Cette valeur est facultative. La valeur par défaut est public.

--wait, -w

Attendez la fin de l'exécution de la génération. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Durée d'attente, en secondes, jusqu'à ce que la fonction soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

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

Lorsque vous exécutez la commande « ibmcloud ce fn get -n 'myfunction' » pour vérifier l'état de la fonction, la page « URL » correspondant à votre fonction s'affiche.

Options de commande

--name, -n

Nom de la fonction. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce fn delete --name myfunction

Exemple de sortie

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

Options de commande

--name, -n

Nom de la fonction. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--save, -s

Enregistrez le code source de la fonction sur le système de fichiers local. Cette option n'est prise en charge que pour les fonctions créées avec du code en ligne. Cette valeur est facultative.

Exemple

ibmcloud ce fn get --name myfunction

Exemple de sortie

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()

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce fn delete --name myfunction

Exemple de sortie

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  

Options de commande

--all, -A

Afficher tous les environnements d'exécution, y compris ceux qui ont été dépréciés. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce fn runtimes

Exemple de sortie

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

Options de commande

--name, -n

Nom de la fonction pour laquelle vous souhaitez annuler la liaison. Cette valeur est obligatoire.

--all, -A

Annule la liaison de toutes les instances de service pour cette fonction. Cette valeur est obligatoire si --binding n'est pas spécifié. La valeur par défaut est false.

--binding, -b

Nom de la liaison à annuler. Exécutez ibmcloud ce function get -n FUNCTION_NAME pour afficher les noms de liaison. Cette valeur est obligatoire si --all n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce fn unbind --name myfunction --all

Exemple de sortie

Removing bindings from 'myfunction'...
OK

Options de commande

--name, -n

Obligatoire. Nom de la fonction. Cette valeur est obligatoire.

--build-clear, --bc

Retirez l'association d'une génération de cette fonction. L'option « build clear » n'est autorisée que si votre fonction est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est false.

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

Validation, balise ou branche du référentiel source à extraire. Cette valeur est facultative.

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

Effacer la validation, la balise ou la branche dans le référentiel source pour l'extraction. L'option "commit clear" n'est autorisée que si votre fonction a une version associée. Cette valeur est facultative. La valeur par défaut est false.

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

Répertoire dans le référentiel qui contient le code source de votre fonction. Cette option n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative.

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

Nom de la clé secrète SSH contenant les identifiants nécessaires pour accéder au dépôt privé qui héberge le code source permettant de créer votre image. Cette valeur est facultative.

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

Effacer le secret SSH. Cette option n'est autorisée que si votre fonction a actuellement une construction associée. Cette valeur est facultative. La valeur par défaut est false.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. Cette valeur est facultative. La valeur par défaut est 600.

--code-bundle, --cb

Le nom de l'image code-bundle à utiliser pour cette fonction. Lorsque l'option « build-source » est spécifiée, cette valeur correspond au chemin d'accès à l'image de sortie générée par la publication de la version. Lorsque l' build-source n'est pas spécifiée, cette valeur correspond au chemin d'accès à l'image du bundle de code existant. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où TAG est facultatif. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

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

Nom du secret de registre utilisé pour l'authentification auprès d'un registre privé. Vous pouvez ajouter la clé de registre en exécutant la commande « registry create ». Cette valeur est facultative.

--cpu

Nombre d'unités centrales défini pour l'instance de la fonction. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Définir des variables d'environnement dans la fonction. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des mappes de configuration complètes en utilisant le nom de la mappe de configuration. Pour retirer des références de clé individuelles à des mappes de configuration, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des secrets intégraux en utilisant le nom de secret. Pour retirer des références de clé individuelles à des secrets, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--env-rm

Permet de retirer des références de variable d'environnement à la clé d'une paire clé-valeur dans une mappe de configuration ou un secret. Pour retirer des références de clé individuelles et des valeurs littérales, spécifiez le nom de la clé. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec les options --env-from-configmap ou --mount-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret, --mount-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--inline-code

Spécifiez le chemin d'accès à un fichier contenant le code source de votre fonction. Le code est intégré à la fonction. Cette valeur est facultative.

--main, --fn-main

Spécifiez le nom de votre fonction principale dans le code source fourni. Cette option est requise lorsque le nom n'est pas main. Cette valeur est facultative. La valeur par défaut est main.

--maxexecutiontime, --met

Durée maximale d'exécution, en secondes, pour que cette fonction termine son exécution. Cette valeur est facultative. La valeur par défaut est 60.

--memory, -m

La quantité de mémoire allouée à la fonction. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 4G.

--no-wait, --nw

Permet de soumettre l'exécution de génération et de ne pas attendre qu'elle soit terminée. Si vous spécifiez l'option --no-wait, la soumission de l'exécution de génération démarre, sans attendre. Utilisez la commande buildrun get pour vérifier le statut de l'exécution de génération. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--rebuild

Recompiler l'image à partir du code source. L'option de reconstruction n'est autorisée que si votre fonction dispose actuellement d'une version associée. Cette valeur est facultative. La valeur par défaut est false.

--runtime, -r

La durée d'exécution à utiliser pour la fonction. Pour connaître les durées d'exécution prises en charge pour cette région, exécutez ibmcloud ce function runtimes. Voir Délais d'exécution. Cette valeur est facultative.

--scale-down-delay, --sdd

Durée, en secondes, pendant laquelle une instance est active à la fin d'un appel. Cette option peut réduire les temps de démarrage à froid. Pour plus d'informations, voir Peut-on maintenir mon instance de fonction en vie plus longtemps? Cette valeur est facultative. La valeur par défaut est 1.

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

Activer le montage d'un jeton de ressource de calcul pour les exécutions de la fonction. Cette valeur est facultative. La valeur par défaut est false.

--visibility, -v

Visibilité de la fonction. Les valeurs valides sont : public, private et project. La visibilité ne peut être « private » que si le projet prend en charge la visibilité « private » des fonctions. Cette valeur est facultative.

--wait, -w

Attendez la fin de l'exécution de la génération. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Durée d'attente, en secondes, jusqu'à ce que la fonction soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

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

Lorsque vous exécutez la commande « ibmcloud ce fn get -n 'myfunction' » pour vérifier l'état de la fonction, la page « URL » correspondant à votre fonction s'affiche.

Exemple

ibmcloud ce help

Exemple de sortie

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.

Options de commande

--name, -n

Nom du travail à lier. Cette valeur est obligatoire.

--no-wait, --nw

Lie l'instance de service sans attendre que la liaison de service soit prête. Si vous spécifiez l'option --no-wait, la création de liaison de service démarre et la commande prend fin sans attendre la fin de l'exécution. Utilisez la commande job get pour vérifier le statut de liaison du travail. Cette valeur est facultative. La valeur par défaut est false.

--prefix, -p

Préfixe des variables d'environnement qui sont créées pour cette liaison de service. Ne doit contenir que des lettres en majuscules, des chiffres et des traits de soulignement (_) et ne peut pas débuter par un chiffre. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--role, -r

Nom d'un rôle de service pour les nouvelles données d'identification de service créées pour cette liaison de service. Les valeurs valides sont Reader, Writer, Manager ou un rôle propre au service. L'option prend par défaut la valeur Manager ou le premier rôle fourni par le service si Manager n'est pas pris en charge. Cette option est ignorée si --service-credential est spécifié. Cette valeur est facultative.

--service-credential, --sc

Nom d'une donnée d'identification de service existante qui doit être utilisée pour cette liaison de service. Si vous ne spécifiez pas de donnée d'identification d'instance de service, de nouvelles données d'identification sont générées lors de l'action de liaison. Cette valeur est facultative.

--service-instance, --si

Nom d'une instance de service IBM Cloud existante qui doit être liée au travail. Cette valeur est facultative.

--service-instance-id, --siid

L'identificateur global unique d'une instance de service IBM Cloud existante à lier au travail. Cette valeur est facultative.

--wait, -w

Permet de lier l'instance de service et d'attendre que la liaison de service soit prête. Si vous spécifiez l'option --wait, le délai d'attente maximal, en secondes, pour que la liaison de travail aboutisse est défini par l'option --wait-timeout. Si la liaison de travail ne se termine pas correctement ou échoue dans le délai --wait-timeout spécifié, la commande échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que la liaison de service soit prête. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 300.

Exemple

Cet exemple permet de lier une instance de service appelée my-object-storage à un travail nommé hello.

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

Exemple de sortie

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

Options de commande

-n, --name

Nom du travail. Utilisez un nom unique dans le projet.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 63 caractères au maximum et peut contenir des lettres minuscules, des chiffres et des tirets (-).

Cette valeur est obligatoire.

--argument, --arg, -a

Permet de définir des arguments pour les exécutions du travail. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur est facultative.

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

Spécifie les indices du tableau utilisés pour les exécutions du travail, par exemple 0,3,6,9, 1-5,7-8,10. L'ensemble des résultats des index est limité à 1000 entrées. Cette option ne peut être spécifiée que si l'option « array-size » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 0.

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

Permet de spécifier le nombre d'instances utilisées pour les exécutions du travail. Lorsque vous utilisez cette option, le système convertit en index de tableau. Par exemple, si vous indiquez instances de 5, le système le convertit en array-indexes de 0 - 4. Cette option ne peut être spécifiée que si l'option « --array-indexes » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 1.

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

Validation, balise ou branche du référentiel source à extraire. L'option build commit n'est autorisée que si l'option --build-source est définie sur URL d'un dépôt Git. Cette valeur est facultative.

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

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. L'option de répertoire de contexte de construction n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative.

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

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. L'option build dockerfile n'est autorisée que si l'option --build-source est définie. Cette valeur est facultative. La valeur par défaut est Dockerfile.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option --build-source est définie sur URL d'un référentiel Git. Cette valeur est facultative.

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

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. L'option "build size" n'est autorisée que si l'option " --build-source " est activée. Cette valeur est facultative. La valeur par défaut est medium.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

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

Stratégie à utiliser pour générer l'image. Les valeurs valides sont dockerfile et buildpacks. L'option de stratégie de construction n'est autorisée que si l'option --build-source est activée. Si aucune valeur n'est indiquée, la stratégie de compilation est déterminée par Code Engine si --build-source est spécifié et que la source se trouve sur votre ordinateur local. Cette valeur est facultative. La valeur par défaut est dockerfile.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. L'option build timeout n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative. La valeur par défaut est 600.

--command, --cmd, -c

Permet de définir des commandes pour les exécutions du travail. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--cpu

Quantité d'UC à définir pour les exécutions du travail. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Permet de définir des variables d'environnement pour les exécutions du travail. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère à définir pour les exécutions du travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative. La valeur par défaut est 400M.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec l'option --env-from-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Nom de l'image qui est utilisée pour les exécutions du travail. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. L'option d'image est obligatoire si l'option --build-sourcen'est pas spécifiée. Cette valeur est facultative.

--maxexecutiontime, --met

Temps d'exécution maximal, en secondes, pour les exécutions du travail. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 7200.

--memory, -m

Quantité de mémoire définie pour les exécutions du travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 4G.

--mode

Mode pour les exécutions du travail. Les valeurs valides sont task et daemon. En mode « task », les options « maxexecutiontime » et « retrylimit » s'appliquent. En mode « daemon », comme il n'y a pas de délai d'expiration et que les instances défaillantes sont redémarrées indéfiniment, les options « --maxexecutiontime » et « --retrylimit » ne sont pas autorisées. Cette valeur est facultative. La valeur par défaut est « task ».

--mount-configmap, --mount-cm

Ajoutez le contenu d'une mappe de configuration au système de fichiers de l'exécution du travail en fournissant un répertoire de montage et le nom d'une mappe de configuration, sous le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoutez les contenus d'un secret au système de fichiers de l'exécution du travail en fournissant un répertoire de montage et le nom d'un secret, au format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

--no-wait, --nw

N'attendez pas la fin de l'exécution de la génération. Si vous spécifiez l'option --no-wait, l'exécution de la génération commence et n'attend pas. Utilisez la commande buildrun get pour vérifier le statut de l'exécution de génération. L'option no-wait n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

--retrylimit, -r

Nombre de réexécutions d'une instance du travail avant que celui-ci ne soit marqué comme ayant échoué. Un index de tableau d'un travail est réexécuté lorsqu'il renvoie un code d'exit différent de zéro. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 3.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

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

Activer le montage d'un jeton de ressource de calcul pour les exécutions du travail. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Attendez la fin de l'exécution de la génération. Si vous spécifiez l'option--wait, l'exécution de génération attend une durée maximale en secondes, définie par l'option--wait-timeout, pour que l'exécution de la génération soit terminée. Si l'exécution de génération n'est pas terminée dans la période--wait-timeout spécifiée, l'exécution de la génération échoue. L'option wait n'est autorisée que si l'option --build-source est activée. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que cette exécution de génération soit terminée. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. L'option wait-timeout n'est autorisée que si l'option --build-source est activée. La valeur par défaut est 600.

Exemple

L'exemple suivant utilise l'image de conteneur icr.io/codeengine/firstjob et affecte 2G Mo de mémoire et 1 unité centrale au conteneur. Pour plus d'informations sur la sélection de la mémoire et de l'unité centrale, voir Combinaisons de mémoire et d'unité centrale prises en charge.

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

Exemple de sortie

Creating job 'hellojob'...
OK

Options de commande

--name, -n

Nom du travail. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--orphan-job-runs, -o

Permet d'indiquer que les exécutions de travail associées à cette configuration de travail doivent être conservées. Ces exécutions de travail orphelines doivent ensuite être supprimées séparément. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce job delete --name hello

Exemple de sortie

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

Lorsque vous exécutez la commande ibmcloud ce job delete pour supprimer un travail, toutes les exécutions de travail soumises qui font référence à ce travail sont également supprimées.

Options de commande

--name, -n

Nom du travail. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce job get --name hellojob

Exemple de sortie

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

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce job list

Exemple de sortie

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

Options de commande

--name, -n

Nom du travail pour lequel vous souhaitez annuler la liaison. Cette valeur est obligatoire.

--all, -A

Permet d'annuler la liaison de toutes les instances de service avec ce travail. Cette valeur est obligatoire si --binding n'est pas spécifié. La valeur par défaut est false.

--binding, -b

Nom de la liaison à annuler. Exécutez ibmcloud ce job get -n JOB_NAME pour afficher les noms de liaison. Cette valeur est obligatoire si --all n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

Cet exemple permet de retirer toutes les liaisons de votre travail nommé hello.

ibmcloud ce job unbind --name hello --all

Exemple de sortie

Removing service bindings...
OK

Options de commande

--name, -n

Nom du travail. Cette valeur est obligatoire.

--argument, --arg, -a

Permet de définir des arguments pour les exécutions du travail. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur est facultative.

--arguments-clear, --ac

Permet d'effacer les arguments d'un travail. Cette valeur est facultative. La valeur par défaut est false.

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

Spécifie les indices du tableau utilisés pour les exécutions du travail, par exemple 0,3,6,9, 1-5,7-8,10. L'ensemble des résultats des index est limité à 1000 entrées. Cette option ne peut être spécifiée que si l'option « array-size » n'est pas spécifiée. Cette valeur est facultative.

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

Permet de spécifier le nombre d'instances utilisées pour les exécutions du travail. Lorsque vous utilisez cette option, le système convertit en index de tableau. Par exemple, si vous indiquez instances de 5, le système le convertit en array-indexes de 0 - 4. Cette option ne peut être spécifiée que si l'option « --array-indexes » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 0.

--build-clear, --bc

Supprimez l'association d'une génération à partir de ce travail. L'option « build clear » n'est autorisée que si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est false.

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

Validation, balise ou branche du référentiel source à extraire. L'option « build commit » n'est autorisée que si l'option « --build-source » est définie sur l' URL d'un dépôt Git via cette commande job update, ou si votre tâche est actuellement associée à une compilation provenant d'un dépôt Git. Cette valeur est facultative.

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

Effacer la validation, la balise ou la branche dans le référentiel source pour l'extraction. L'option « commit clear » n'est autorisée que si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est false.

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

Répertoire inclus dans le référentiel qui contient le fichier de packs de construction ou le fichier Dockerfile. L'option de répertoire de contexte de compilation n'est autorisée que si l'option « --build-source » est définie dans cette commande « job update », ou si votre tâche est actuellement associée à une compilation. Cette valeur est facultative.

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

Chemin d'accès au Dockerfile. Spécifiez cette option uniquement si le nom est différent de Dockerfile. L'option de génération dockerfile est autorisée si l'option --build-sourceest définie sur cette commandejob update ou si votre travail comporte actuellement une génération associée. Cette valeur est facultative. La valeur par défaut est Dockerfile.

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

Nom du secret SSH, qui contient les identifiants permettant d'accéder au référentiel privé contenant le code source pour la génération de votre image de conteneur. Pour créer ce secret SSH, utilisez la commande secret create --format SSH. Un secret SSH est également utilisé comme secret d'accès au référentiel Git. Cette option n'est autorisée que si l'option « --build-source » est définie sur l'adresse URL d'un référentiel Git via cette commande job update, ou si votre tâche est actuellement associée à une version provenant d'un référentiel Git. Cette valeur est facultative.

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

Effacer le secret SSH. Cette option est autorisée si votre tâche est actuellement associée à une version. Cette valeur est facultative. La valeur par défaut est false.

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

Taille de la génération, qui détermine la quantité de ressources utilisée. Les valeurs valides sont : small, medium, large, xlarge et xxlarge. Pour plus de détails, voir Définition de la taille de la génération. L'option « build size » n'est autorisée que si l'option « --build-source » est activée dans cette commande « job update », ou si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est medium.

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

L'URL du référentiel Git ou le chemin d'accès à la source locale qui contient votre code source ; par exemple, https://github.com/IBM/CodeEngine ou.. Cette valeur est facultative.

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

Stratégie à utiliser pour générer l'image. Les valeurs valides sont dockerfile et buildpacks. L'option de stratégie de build n'est autorisée que si l'option « --build-source » est activée dans cette commande « job update », ou si votre tâche est actuellement associée à un build. Si elle n'est pas spécifiée, la stratégie de génération est déterminée par Code Engine si --build-source est spécifié et si la source se trouve sur votre machine locale. Cette valeur est facultative. La valeur par défaut est dockerfile.

--build-timeout, --bto

Délai en secondes avant la réussite ou l'échec de la génération. L'option de délai d'expiration de la compilation n'est autorisée que si l'option « --build-source » est définie dans cette commande « job update », ou si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est 600.

--command, --cmd, -c

Permet de définir des commandes pour les exécutions du travail. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--commands-clear, --cc

Permet d'effacer les commandes d'un travail. Cette valeur est facultative. La valeur par défaut est false.

--cpu

Quantité d'UC à définir pour les exécutions du travail. Cette valeur met à jour toute valeur --cpu qui est affectée dans le travail. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 0.

--env, -e

Permet de définir des variables d'environnement pour les exécutions du travail. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, --env envA=A --env envB=B. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des mappes de configuration complètes en utilisant le nom de la mappe de configuration. Pour retirer des références de clé individuelles à des mappes de configuration, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des secrets intégraux en utilisant le nom de secret. Pour retirer des références de clé individuelles à des secrets, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--env-rm

Permet de retirer des références de variable d'environnement à la clé d'une paire clé-valeur dans une mappe de configuration ou un secret. Pour retirer des références de clé individuelles et des valeurs littérales, spécifiez le nom de la clé. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère à définir pour les exécutions du travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec l'option --env-from-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Nom de l'image qui est utilisée pour les exécutions du travail. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. Cette valeur est facultative.

--maxexecutiontime, --met

Temps d'exécution maximal, en secondes, pour les exécutions du travail. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 7200.

--memory, -m

Quantité de mémoire définie pour les exécutions du travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative.

--mode

Mode pour les exécutions du travail. Les valeurs valides sont task et daemon. En mode « task », les options « maxexecutiontime » et « retrylimit » s'appliquent. En mode « daemon », comme il n'y a pas de délai d'expiration et que les instances défaillantes sont redémarrées indéfiniment, les options « --maxexecutiontime » et « --retrylimit » ne sont pas autorisées. Cette valeur est facultative.

--mount-configmap, --mount-cm

Ajoutez le contenu d'une mappe de configuration au système de fichiers de l'exécution du travail en fournissant un répertoire de montage et le nom d'une mappe de configuration, sous le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-rm

Supprimez le contenu d'une mappe de configuration ou d'un secret du système de fichiers de l'exécution du travail en spécifiant le répertoire dans lequel la mappe de configuration ou le secret est monté. Spécifiez un répertoire de montage par option --mount-rm, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b, par exemple. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoutez les contenus d'un secret au système de fichiers de l'exécution du travail en fournissant un répertoire de montage et le nom d'un secret, au format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

--no-wait, --nw

N'attendez pas la fin de l'exécution de la génération. Si vous spécifiez l'option --no-wait, l'exécution de la génération commence et n'attend pas. Utilisez la commande buildrun get pour vérifier le statut de l'exécution de génération. L'option « sans attente » n'est autorisée que si l'option « --build-source » est activée dans cette commande « job update » ou si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--rebuild

Régénérez l'image à partir de la source. L'option de reconstruction est autorisée si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

--registry-secret-clear, --rsc

Effacer le secret du registre. Cette valeur est facultative. La valeur par défaut est false.

--retrylimit, -r

Nombre de réexécutions d'une instance du travail avant que celui-ci ne soit marqué comme ayant échoué. Un index de tableau d'un travail est réexécuté lorsqu'il renvoie un code d'exit différent de zéro. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 3.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

--service-account-clear, --sac

Effacer le compte de service. Cette valeur est facultative. La valeur par défaut est false.

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

Activer le montage d'un jeton de ressource de calcul pour les exécutions du travail. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Attendez la fin de l'exécution de la génération. Si vous spécifiez l'option--wait, l'exécution de génération attend une durée maximale en secondes, définie par l'option--wait-timeout, pour que l'exécution de la génération soit terminée. Si l'exécution de génération n'est pas terminée dans la période--wait-timeout spécifiée, l'exécution de la génération échoue. L'option « wait » n'est autorisée que si l'option « --build-source » est activée pour cette commande « job update » ou si votre tâche est actuellement associée à une compilation. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant que cette exécution de génération soit terminée. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. L'option délai d'attente est autorisée si l'option --build-sourceest définie sur cette commandejob update ou si votre travail comporte actuellement une génération associée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

Updating job 'hellojob'...
OK

Options de commande

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--job, -j

Cette option permet de supprimer toutes les exécutions de travail du travail spécifié. L'option --job est requise si vous ne spécifiez pas la valeur --name. Cette valeur est facultative.

--name, -n

Nom de l'exécution de travail à supprimer. L'option --name est requise si vous ne spécifiez pas la valeur --job. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce jobrun delete --name myjobrun -f

Exemple de sortie

Deleting job run 'myjobrun'...
OK

Options de commande

--instance, -i

Nom d'une instance d'exécution de travail spécifique. Utilisez la commande jobrun get pour identifier le nom de l'instance. Cette valeur est obligatoire si --jobrun n'est pas spécifié.

--jobrun, -j, --name, -n

Afficher les événements de toutes les instances de l'exécution de travail spécifiée. Cette valeur est obligatoire si --instance n'est pas spécifié.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple suivant affiche les informations d'événement système de toutes les instances d'une exécution de travail spécifiée.

ibmcloud ce jobrun events --jobrun myjobrun

Exemple de sortie

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"

Exemple d'informations d'événement système pour l'instance spécifiée d'une exécution de travail

Vous pouvez également afficher des informations sur les évènements système pour une instance spécifiée d'un travail exécuté à l'aide de l'option --instance avec la commande ibmcloud ce jobrun events. Utilisez la commande jobrun get pour afficher les détails de l'exécution de votre travail, y compris les instances d'exécution de l'exécution du travail.

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

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

Options de commande

--name, -n

Nom de l'exécution de travail. Cette valeur est obligatoire.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce jobrun get --name myjobrun  

Exemple de sortie

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

Options de commande

--job, -j

Cette option permet d'afficher uniquement les exécutions de travail du travail spécifié. Cette valeur est facultative.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce jobrun list

Exemple de sortie

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

Le nom de l'exécution de travail répertoriée indique le nom de l'exécution de travail et la révision en cours de cette dernière.

Options de commande

--follow, -f

Permet de suivre les journaux des instances d'exécution de travail. Utilisez cette option pour diffuser les journaux des instances d'exécution de travail. Si vous spécifiez l'option --follow, vous devez entrer Ctrl+C pour mettre fin à cette commande de journal. Cette valeur est facultative. La valeur par défaut est false.

--instance, -i

Nom d'une instance d'exécution de travail spécifique. Utilisez la commande jobrun get pour identifier le nom de l'instance. Cette valeur est obligatoire si --jobrun n'est pas spécifié.

--jobrun, -j, --name, -n

Afficher les journaux de toutes les instances de l'exécution de travail spécifiée Cette valeur est obligatoire si --instance n'est pas spécifié.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--raw, -r

Permet d'afficher les journaux sans les libellés d'instance et de conteneur. Cette valeur est facultative. La valeur par défaut est false.

--tail, -t

Permet de limiter l'affichage des journaux des instances d'exécution de travail spécifiées à un nombre maximal de lignes récentes. Par exemple, pour afficher les dernières lignes 3 des journaux des instances d'exécution de travaux spécifiées, indiquez --tail 3. Si cette option n'est pas spécifiée, toutes les lignes des journaux des instances d'exécution du travail spécifiées sont affichées. Cette valeur est facultative. La valeur par défaut est -1.

--timestamps, --ts

Permet d'inclure des horodatages sur chaque ligne dans la sortie de journal. Cette valeur est facultative. La valeur par défaut est false.

Exemple

L'exemple suivant affiche les journaux d'une instance spécifique d'une exécution de travail. Utilisez la commande jobrun get pour obtenir le nom des instances d'exécution de travail.

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

Exemple de sortie

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

Exemple de journaux de toutes les instances d'une exécution de travail

L'exemple suivant affiche les journaux de toutes les instances d'une exécution de travail.

ibmcloud ce jobrun logs --jobrun myjobrun

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

Options de commande

--instance, -i

Nom d'une instance d'exécution de travail spécifique. Utilisez la commande jobrun get pour identifier le nom de l'instance. Cette valeur est obligatoire si --jobrun n'est pas spécifié.

--jobrun, -j, --name, -n

Redémarrer toutes les instances en cours d'exécution du travail spécifié. Cette valeur est obligatoire si --instance n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce jobrun restart --name myjobrun   

Exemple de sortie

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

Options de commande

--jobrun, -j

Nom de l'exécution de travail précédente sur laquelle cette exécution de travail est basée. Cette valeur est obligatoire.

--argument, --arg, -a

Permet de définir des arguments pour cette exécution de travail. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur est facultative.

--arguments-clear, --ac

Permet d'effacer les arguments d'une exécution de travail. Cette valeur est facultative. La valeur par défaut est false.

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

Spécifie les index des instances utilisées pour l'exécution de cette tâche, par exemple 0,3,6,9, 1-5,7-8,10. L'ensemble des résultats des index est limité à 1000 entrées. Cette option ne peut être spécifiée que si l'option « array-size » n'est pas spécifiée. Cette valeur est facultative.

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

Permet de spécifier le nombre d'instances utilisées pour cette exécution de travail. Lorsque vous utilisez cette option, le système convertit en index de tableau. Par exemple, si vous indiquez instances de 5, le système le convertit en array-indexes de 0 - 4. Cette option ne peut être spécifiée que si l'option « --array-indexes » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 0.

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

Permet de définir une valeur personnalisée pour la variable d'environnement « JOB_ARRAY_SIZE ». Par défaut, la variable d'environnement JOB_ARRAY_SIZE est définie soit sur la valeur array-size , soit sur le nombre d'index spécifié par array-indexes``. La valeur de la variable d'environnement JOB_ARRAY_SIZE n'affecte pas la taille du tableau configuré. Cette option permet d'imposer une taille de tableau constante pour les scénarios de réexécution de travaux, dans lesquels seules certaines instances de travaux sont soumises ou resoumises. Cette valeur est facultative.

--command, --cmd, -c

Permet de définir des commandes pour cette exécution de travail. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--commands-clear, --cc

Permet d'effacer les commandes d'une exécution de travail. Cette valeur est facultative. La valeur par défaut est false.

--cpu

Quantité d'UC définie pour chaque index de tableau pour cette exécution de travail. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 0.

--env, -e

Permet de définir des variables d'environnement pour cette exécution de travail. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, -e envA -e envB. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des mappes de configuration complètes en utilisant le nom de la mappe de configuration. Pour retirer des références de clé individuelles à des mappes de configuration, utilisez l'option --env-rm. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

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

Permet de retirer des références de variable d'environnement à des secrets intégraux en utilisant le nom de secret. Pour retirer des références de clé individuelles à des secrets, utilisez l'option --env-rm. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--env-rm

Permet de retirer des références de variable d'environnement à la clé d'une paire clé-valeur dans une mappe de configuration ou un secret. Pour retirer des références de clé individuelles et des valeurs littérales, spécifiez le nom de la clé. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère pour cette exécution de travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec l'option --env-from-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret. Cette valeur est facultative. La valeur par défaut est false.

--maxexecutiontime, --met

Temps d'exécution maximal, en secondes, pour cette exécution de travail. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 7200.

--memory, -m

Quantité de mémoire à affecter à cette exécution de travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative.

--mode

Mode de l'exécution du travail. Les valeurs valides sont task et daemon. En mode « task », les options « maxexecutiontime » et « retrylimit » s'appliquent. En mode « daemon », comme il n'y a pas de délai d'expiration et que les instances défaillantes sont redémarrées indéfiniment, les options « maxexecutiontime » et « retrylimit » ne sont pas autorisées. Cette valeur est facultative.

--mount-configmap, --mount-cm

Ajoutez le contenu d'une mappe de configuration au système de fichiers de ce travail en fournissant un répertoire de montage et le nom d'une mappe de configuration, sous le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-rm

Supprimez le contenu d'une mappe de configuration ou d'un secret du système de fichiers de ce travail en spécifiant le répertoire dans lequel la mappe de configuration ou le secret est monté. Spécifiez un répertoire de montage par option --mount-rm, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b, par exemple. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoutez le contenu d'un secret au système de fichiers de ce travail en fournissant un répertoire de montage et le nom d'un secret, au format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

-n, --name

Nom de cette exécution de travail. Cette valeur est obligatoire si aucune configuration de travail n'est associée au travail référencé. Utilisez un nom unique dans le projet.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 53 caractères au maximum et peut contenir des lettres minuscules, des chiffres et des tirets (-).

Cette valeur est facultative.

--no-wait, --nw

Permet de soumettre à nouveau le travail et de ne pas attendre que ses instances soient terminées. Si vous spécifiez l'option --no-wait, la nouvelle soumission de l'exécution de travail démarre, sans attendre. Utilisez la commande jobrun get pour vérifier le statut d'exécution du travail. Cette valeur est facultative. La valeur par défaut est true.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--retrylimit, -r

Nombre de réexécutions d'une instance de cette exécution de travail avant que celle-ci ne soit marquée comme ayant échoué. Un index de tableau d'une exécution de travail est réexécuté lorsqu'il renvoie un code d'exit différent de zéro. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 3.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

--service-account-clear, --sac

Effacer le compte de service. Cette valeur est facultative. La valeur par défaut est false.

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

Activer le montage d'un jeton de ressource de calcul pour les instances de ce travail. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Permet de soumettre à nouveau l'exécution de travail et d'attendre que ses instances se terminent. Si vous spécifiez l'option --wait, le délai d'attente maximal, en secondes, de la nouvelle soumission de l'exécution de travail pour que l'exécution de travail aboutisse est défini par l'option --wait-timeout. Si l'exécution de travail ne se termine pas dans le délai --wait-timeout spécifié, la nouvelle soumission de l'exécution de travail échoue. Cette valeur est facultative. La valeur par défaut est false.

--wait-timeout, --wto

Délai d'attente en secondes avant que l'exécution des instances de cette exécution de travail soit terminée. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

L'exemple illustré ci-après réexécute l'exécution de travail myjobrun pour les instances 4-5. Le nom de l'exécution de travail soumise à nouveau est myjobresubmit.

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

Exemple de sortie

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

Options de commande

--argument, --arg, -a

Permet de définir des arguments pour cette exécution de travail. Spécifiez un argument par option --argument ; par exemple, -a argA -a argB. Cette valeur est facultative.

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

Spécifie les index des instances utilisées pour l'exécution de cette tâche, par exemple 0,3,6,9, 1-5,7-8,10. L'ensemble des résultats des index est limité à 1000 entrées. Cette option ne peut être spécifiée que si l'option « array-size » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 0.

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

Permet de spécifier le nombre d'instances utilisées pour cette exécution de travail. Lorsque vous utilisez cette option, le système convertit en index de tableau. Par exemple, si vous indiquez instances de 5, le système le convertit en array-indexes de 0 - 4. Cette option ne peut être spécifiée que si l'option « --array-indexes » n'est pas spécifiée. Cette valeur est facultative. La valeur par défaut est 1.

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

Permet de définir une valeur personnalisée pour la variable d'environnement « JOB_ARRAY_SIZE ». Par défaut, la variable d'environnement JOB_ARRAY_SIZE est définie soit sur la valeur array-size , soit sur le nombre d'index spécifié par array-indexes``. La valeur de la variable d'environnement JOB_ARRAY_SIZE n'affecte pas la taille du tableau configuré. Cette option permet d'imposer une taille de tableau constante pour les scénarios de réexécution de travaux, dans lesquels seules certaines instances de travaux sont soumises ou resoumises. Cette valeur est facultative.

--command, --cmd, -c

Permet de définir des commandes pour cette exécution de travail. Spécifiez une commande par option --command ; par exemple, --cmd cmdA --cmd cmdB. Cette valeur remplace la commande par défaut qui est spécifiée dans l'image de conteneur. Cette valeur est facultative.

--cpu

Quantité d'UC définie pour chaque index de tableau pour cette exécution de travail. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 1.

--env, -e

Permet de définir des variables d'environnement pour cette exécution de travail. Le format requis est NAME=VALUE. Cette action permet d'ajouter une nouvelle variable d'environnement ou de remplacer une variable d'environnement existante. Spécifiez une variable d'environnement par option --env ; par exemple, -e envA -e envB. Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur qui sont stockées dans cette mappe de configuration en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'une mappe de configuration nommée configmapName, utilisez la valeur configmapName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement de la mappe de configuration. Pour spécifier un préfixe, utilisez la valeurPREFIX=CONFIGMAP_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans la mappe de configurationconfigmapName enCUSTOM_, utilisez la valeurCUSTOM_=configmapName. Si la mappe de configuration configmapName contient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, afin d'ajouter une variable d'environnement pour une clé key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans une mappe de configuration nommée configmapName, utilisez la valeur configmapName:myKey=key1.

Cette valeur est facultative.

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

Définissez les variables d'environnement à partir des paires clé-valeur stockées dans un secret en utilisant l'une des méthodes suivantes :

• Afin d'ajouter des variables d'environnement pour toutes les clés d'un secret nommé secretName, utilisez la valeur secretName. Vous pouvez modifier les noms de variables d'environnement en spécifiant un préfixe lors du référencement du secret. Pour spécifier un préfixe, utilisez la valeurPREFIX=SECRET_NAME. Chaque variable d'environnement obtenue a le format<PREFIX><NAME_OF_KEY_IN_SECRET>. Par exemple, pour définir le préfixe de tous les noms de clés des clés dans le secretsecretName vers CUSTOM_, utilisez la valeurCUSTOM_=secretName. Si le secret secretNamecontient KEY_A, le nom de la variable d'environnement estCUSTOM_KEY_A.
• Pour ajouter des variables d'environnement pour des clés individuelles, utilisez le formatNAME:KEY_A,KEY_B. Par exemple, pour ajouter une variable d'environnement pour une clé uniquekey1 dans un secret nommésecretName, utilisez la valeursecretName:key1. Pour affecter un nom différent à une clé référencée, utilisez le format NAME:NEW_NAME=KEY_A. Par exemple, pour ajouter une variable d'environnement nommée myKey pour une clé unique key1 dans un secret nommé secretName, utilisez la valeur secretName:myKey=key1.

Cette valeur est facultative.

--ephemeral-storage, --es

Quantité de stockage éphémère pour cette exécution de travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Cette valeur est facultative. La valeur par défaut est 400M.

--force, -f

Ne pas vérifier l'existence des références de mappe de configuration et de secret spécifiées. Les références de mappe de configuration sont spécifiées avec l'option --env-from-configmap. Les références de secret sont spécifiées avec l'option --env-from-secret ou --registry-secret. Cette valeur est facultative. La valeur par défaut est false.

--image, -i

Nom de l'image qui est utilisée pour cette exécution de travail. Le format est REGISTRY/NAMESPACE/REPOSITORY:TAG, où REGISTRY et TAG sont facultatifs. Si REGISTRY n'est pas spécifié, la valeur par défaut est docker.io. Si TAG n'est pas spécifié, la valeur par défaut est latest. Si vous ne spécifiez pas l'option --job, les valeurs --name et --image sont obligatoires. Cette valeur est facultative.

--job, -j

Nom de la configuration de travail. Pour afficher les configurations de travail, utilisez la commande job list. Si vous spécifiez la valeur --job, vous pouvez éventuellement spécifier la valeur --name. Si vous ne spécifiez pas la valeur --job, vous devez spécifier les valeurs --name et --image. Cette valeur est facultative.

--maxexecutiontime, --met

Temps d'exécution maximal, en secondes, pour cette exécution de travail. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 7200.

--memory, -m

Quantité de mémoire à affecter à cette exécution de travail. Utilisez M pour mégaoctets ou G pour gigaoctets. Pour prendre connaissance des valeurs valides, voir Combinaisons de mémoire et d'unité centrale prises en charge. Cette valeur est facultative. La valeur par défaut est 4G.

--mode

Mode de l'exécution du travail. Les valeurs valides sont task et daemon. En mode « task », les options « maxexecutiontime » et « retrylimit » s'appliquent. En mode « daemon », comme il n'y a pas de délai d'expiration et que les instances défaillantes sont redémarrées indéfiniment, les options « maxexecutiontime » et « retrylimit » ne sont pas autorisées. Cette valeur est facultative. La valeur par défaut est « task ».

--mount-configmap, --mount-cm

Ajoutez le contenu d'une mappe de configuration au système de fichiers de ce travail en fournissant un répertoire de montage et le nom d'une mappe de configuration, sous le format MOUNT_DIRECTORY=CONFIGMAP_NAME. Chaque mappe de configuration montée doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur de la mappe de configuration, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-configmap, --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b, par exemple. Cette valeur est facultative.

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

Montage d'un stockage de persistance des données. Le format est le suivant : MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH]. SUBPATH est facultatif. Cette option peut être spécifiée plusieurs fois. Cette valeur est facultative.

--mount-secret, --mount-sec

Ajoutez le contenu d'un secret au système de fichiers de ce travail en fournissant un répertoire de montage et le nom d'un secret, au format MOUNT_DIRECTORY=SECRET_NAME. Chaque secret monté doit utiliser un répertoire de montage unique. Pour chaque paire clé-valeur du secret, un fichier est ajouté au répertoire de montage spécifié, où le nom de fichier est la clé et le contenu du fichier, la valeur de la paire clé-valeur. Spécifiez une configuration de montage par option --mount-secret, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b, par exemple. Cette valeur est facultative.

-n, --name

Nom de cette exécution de travail. Si vous ne spécifiez pas la valeur --job, les valeurs --name et --image sont obligatoires. Utilisez un nom unique dans le projet.

• Le nom doit débuter et se terminer par un caractère alphanumérique en minuscule.
• Le nom doit comporter 53 caractères au maximum et peut contenir des lettres minuscules, des chiffres et des tirets (-).

Cette valeur est facultative.

--no-wait, --nw

Permet de soumettre l'exécution de travail et de ne pas attendre que ses instances soient terminées. Si vous spécifiez l'option --no-wait, la soumission de l'exécution de travail démarre, sans attendre. Utilisez la commande jobrun get pour vérifier le statut d'exécution du travail. Cette valeur est facultative. La valeur par défaut est true.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--registry-secret, --rs

Nom du secret de registre. Le secret de registre est utilisée pour l'authentification auprès d'un registre privé lorsque vous téléchargez l'image de conteneur. Cette valeur est facultative.

--retrylimit, -r

Nombre de réexécutions d'une instance de cette exécution de travail avant que celle-ci ne soit marquée comme ayant échoué. Un index de tableau d'une exécution de travail est réexécuté lorsqu'il renvoie un code d'exit différent de zéro. Cette option ne peut être spécifiée que si mode est task. Cette valeur est facultative. La valeur par défaut est 3.

--service-account, --sa

Nom du compte de service. Un compte de service fournit une identité pour les processus qui s'exécutent dans une instance. Pour les comptes de service intégrés, vous pouvez utiliser les noms raccourcis manager, none, reader et writer. Vous pouvez également utiliser les noms complets préfixés avec le Kubernetes Config Context, qui peut être déterminé à l'aide de la commande project current. Cette valeur est facultative.

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

Activer le montage d'un jeton de ressource de calcul pour les instances de ce travail. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Permet de soumettre l'exécution de travail et d'attendre que ses instances soient terminées. Si vous spécifiez l'option --wait, le délai d'attente maximal, en secondes, de la soumission de l'exécution de travail pour que l'exécution de travail aboutisse est défini par l'option --wait-timeout. Si l'exécution de travail ne se termine pas dans le délai --wait-timeout spécifié, la soumission de l'exécution de travail échoue. Cette valeur est facultative. La valeur par défaut est false.

--wait-timeout, --wto

Délai d'attente en secondes avant que l'exécution des instances de cette exécution de travail soit terminée. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

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

Exemple de sortie

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

Options de commande

--cos-access-secret, --cos-sec

Obligatoire. Nom du secret qui contient les identifiants permettant d’accéder à l’instance COS. Cette valeur est obligatoire.

--cos-bucket-name, --cos-bucket

Obligatoire. Le nom du compartiment COS. Cette valeur est obligatoire.

--name, -n

Obligatoire. Nom du magasin de données persistantes. Utilisez un nom unique dans le projet. Cette valeur est obligatoire.

--cos-bucket-location, --cos-loc

Emplacement du compartiment COS. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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

Options de commande

--name, -n

Obligatoire. Nom du magasin de données persistant. Cette valeur est obligatoire.

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--ignore-not-found, --inf

Si introuvable, pas d'échec. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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

Options de commande

--name, -n

Obligatoire. Nom du magasin de données persistantes. Cette valeur est obligatoire.

--output, -o

Format de sortie. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

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

Exemple de sortie

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  

Options de commande

--output, -o

Format de sortie. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

Cette commande dresse la liste de tous les magasins de données persistants d'un projet.

ibmcloud ce persistentdatastore list

Exemple de sortie

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  

Options de commande

-n, --name

Nom du projet. Utilisez un nom unique dans votre région. Le nom ne doit pas contenir plus de 128 caractères et peut comporter :

• N'importe quel caractère Unicode ou alphanumérique.
• Uniquement les caractères spéciaux suivants : espaces ( ), points (.), deux-points (:), traits de soulignement (_) et tirets (-).

Cette valeur est obligatoire.

--endpoint, -e

Le point final du projet. Les valeurs valides sont public et private. Si l'option --endpoint n'est pas explicitement spécifiée, le comportement est déterminé par le système. Si l'interface de ligne de commande IBM Cloud est connectée à private.cloud.ibm.com, le projet Code Engine se comporte comme si --endpoint était private. Si l'interface de ligne de commande IBM Cloud est connectée à cloud.ibm.com, le projet Code Engine se comporte comme si --endpoint était public. Cette valeur est facultative.

--no-select, --ns

Ne sélectionnez pas le projet comme contexte actuel après sa création. Si vous ne sélectionnez pas cette option, le projet est automatiquement sélectionné. Cette valeur est facultative. La valeur par défaut est false.

--no-wait, --nw

Créer le projet et ne pas attendre qu'il soit créé. Si vous spécifiez l'option no-wait, la création du projet commence sans attendre. Utilisez la commande project get pour vérifier le statut du projet. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--tag, -t

Libellé à affecter à votre projet. Le libellé doit contenir 128 caractères ou moins et peut contenir des lettres, des nombres, des espaces (), des points (.), deux points (:), des traits de soulignement (_) et des traits d'union (-). Spécifiez un libellé par option --tag ; par exemple, --tag tagA --tag tagB. Cette valeur est facultative.

--wait, -w

Créer le projet et attendre sa création. Si vous spécifiez l'option --wait, la création du projet peut avoir lieu dans le délai maximal défini en secondes par l'option --wait-timeout. Si le projet n'est pas créé dans le délai --wait-timeout spécifié, la création du projet échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant la création du projet. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

ibmcloud ce project create --name myproject  

Exemple de sortie

Creating project 'myproject'...
OK

Options de commande

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce project current  

Exemple de sortie

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

Options de commande

--force, -f

Permet de forcer une suppression sans demander de confirmation. Cette valeur est facultative. La valeur par défaut est false.

--hard

Supprimez immédiatement le projet. Si vous ne spécifiez pas l'option --hard, le projet peut être restauré dans un délai de 7 jours à l'aide de la commande project restore ou reclamation restore. Cette valeur est facultative. La valeur par défaut est false.

--id, --guid

ID du projet. Cette valeur est obligatoire si --name n'est pas spécifié.

--name, -n

Nom du projet. Cette valeur est obligatoire si --id n'est pas spécifié.

--no-wait, --nw

Supprimer le projet sans attendre. Si vous spécifiez l'option no-wait, la suppression du projet commence sans attendre. Utilisez la commande project get pour vérifier le statut du projet. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Supprimer le projet et attendre sa suppression. Si vous spécifiez l'option --wait, la suppression du projet est mise en attente pour une durée maximale en secondes, définie dans l'option --wait-timeout, avant de supprimer le projet. Si le projet n'est pas supprimé dans le délai --wait-timeout spécifié, sa suppression échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant la suppression du projet. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

ibmcloud ce project delete --name myproject -f

Exemple de sortie

Deleting project 'myproject'...
OK

Options de commande

--id, --guid

ID du projet. Cette valeur est obligatoire si --name n'est pas spécifié.

--name, -n

Nom du projet. Cette valeur est obligatoire si --id n'est pas spécifié.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

Exemple

ibmcloud ce project get --name myproject

Exemple de sortie

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

Options de commande

--all-resource-groups, --all

Affiche les projets provenant de tous les groupes de ressources. Par défaut, les projets qui s'affichent proviennent uniquement du groupe de ressources en cours. Cette valeur est facultative. La valeur par défaut est false.

--output, -o

Indique le format de la sortie de la commande. Les valeurs valides sont json, yaml, jsonpath=JSONPATH_EXPRESSIONet jsonpath-as-json=JSONPATH_EXPRESSION. Utilisez jsonpath pour indiquer le chemin d'accès à un élément de la sortie JSON. Cette valeur est facultative.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--regions, -r

Limite l'affichage de projets aux régions spécifiées. Indiquez le nom d'une ou plusieurs régions ; par exemple, us-south,eu-de. Cette valeur est facultative.

--sort-by, -s

Indique la colonne par laquelle trier la liste. Les valeurs valides sont name et age. Cette valeur est facultative. La valeur par défaut est name.

Exemple

ibmcloud ce project list

Exemple de sortie

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

Options de commande

--id, --guid

ID du projet. Cette valeur est obligatoire si --name n'est pas spécifié.

--name, -n

Nom du projet. Cette valeur est obligatoire si --id n'est pas spécifié.

--no-wait, --nw

Restaurer le projet sans attendre sa restauration. Si vous spécifiez l'option no-wait, la restauration du projet commence sans attente. Utilisez la commande project get pour vérifier le statut du projet. Cette valeur est facultative. La valeur par défaut est false.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.

--wait, -w

Restaurer le projet et attendre sa restauration. Si vous spécifiez l'option --wait, la restauration du projet peut avoir lieu dans le délai maximal défini en secondes par l'option --wait-timeout. Si le projet n'est pas restauré dans le délai --wait-timeout spécifié, la restauration du projet échoue. Cette valeur est facultative. La valeur par défaut est true.

--wait-timeout, --wto

Délai d'attente en secondes avant la restauration du projet. Cette valeur est obligatoire si l'option --wait est spécifiée. Cette valeur est ignorée si l'option --no-wait est spécifiée. La valeur par défaut est 600.

Exemple

L'exemple ci-dessous restaure à l'état actif le projet myproject dont le statut est soft deleted. Utilisez la commande project list pour afficher la liste de tous les projets avec leur statut.

ibmcloud ce project restore --name myproject

Exemple de sortie

Restoring project 'myproject'...
OK

Options de commande

--endpoint, -e

Le point final du projet. Les valeurs valides sont public et private. Si l'option --endpoint n'est pas explicitement spécifiée, le comportement est déterminé par le système. Si l'interface de ligne de commande IBM Cloud est connectée à private.cloud.ibm.com, le projet Code Engine se comporte comme si --endpoint était private. Si l'interface de ligne de commande IBM Cloud est connectée à cloud.ibm.com, le projet Code Engine se comporte comme si --endpoint était public. Cette valeur est facultative.

--id, --guid

ID du projet. Cette valeur est obligatoire si --name n'est pas spécifié.

--kubecfg, -k

Ajoutez le projet au fichier de configuration Kubernetes par défaut. Vous pouvez remplacer le fichier de configuration Kubernetes par défaut en définissant la variable d'environnement KUBECONFIG. Cette valeur est facultative. La valeur par défaut est false.

--name, -n

Nom du projet. Cette valeur est obligatoire si --id n'est pas spécifié.

--quiet, -q

Spécifiez cette option pour réduire la sortie de la commande. Cette valeur est facultative. La valeur par défaut est false.