IBM Cloud Code Engine CLI

コマンド・オプション

--name, -n

バインドするアプリケーションの名前。 この値は必須です。

--no-wait, --nw

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるのを待機しません。 no-wait オプションを指定した場合は、サービス・バインディングの作成が開始して、コマンドは作成の完了を待機せずに終了します。 app getコマンドを使用して、アプリケーションのバインド状況を確認します。 この値はオプション です。 デフォルト値は falseです。

--prefix, -p

このサービス・バインディング用に作成される環境変数の接頭部。 使用できるのは大文字、数字、および下線 (_) だけです。また、先頭を数字にすることはできません。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--role, -r

このサービス・バインディング用に作成される新しいサービス資格情報のサービス役割の名前。 有効な値には、Reader、Writer、Manager、またはサービス固有の役割があります。 デフォルトではこのオプションは Manager に設定されます。Manager がサポートされない場合には、サービスから最初に指定された役割に設定されます。 --service-credential を指定した場合、このオプションは無視されます。 この値はオプション です。

--service-credential, --sc

このサービス・バインディングで使用する既存のサービス資格情報の名前。 サービス・インスタンス資格情報を指定しない場合は、バインディング操作時に新規の資格情報が生成されます。 この値はオプション です。

--service-instance, --si

アプリケーションにバインドする既存の IBM Cloud サービス・インスタンスの名前。 この値はオプション です。

--service-instance-id, --siid

アプリケーションにバインドする既存のIBM Cloudサービス・インスタンスの GUID。 この値はオプション です。

--wait, -w

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるまで待機します。 --waitオプションを指定した場合、アプリケーション・バインドは、アプリケーション・バインドが正常に完了するまで、--wait-timeoutオプションで設定された最大時間 (秒単位) 待機します。 アプリ・バインドが正常に完了しない場合、または --wait-timeout で指定された期間内に失敗した場合、このコマンドは失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

サービス・バインディングの準備が完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は300です。

例

この例では、 my-object-storage という IBM Cloud Object Storage サービスインスタンスを、 myapp というアプリケーションにバインドします。

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

出力例

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

コマンド・オプション

-n, --name

アプリケーションの名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭は小文字でなければなりません。
• 名前の末尾は小文字の英数字でなければなりません。
• 名前は 63 文字以下でなければならず、使用できるのは小文字、数字、ハイフン (-) です。

この値は必須です。

--argument, --arg, -a

アプリケーションの引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値は、コンテナー・イメージ内に指定されているデフォルトの値をオーバーライドします。 この値はオプション です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 ビルド・コミット・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。

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

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 ビルド・コンテキスト・ディレクトリー・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。

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

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 build dockerfile オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は Dockerfileです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、 --build-source オプションが URL の Git リポジトリに設定されている場合にのみ許可されます。 この値はオプション です。

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

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 ビルド・サイズ・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は medium です。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

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

イメージのビルドに使用する戦略。 有効な値は dockerfile および buildpacks です。 ビルド・ストラテジー・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 指定されていない場合、 --build-source が指定され、ソースがローカル・マシンにあれば、ビルド戦略は Code Engine によって決定される。 この値はオプション です。 デフォルト値はdockerfileです。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 ビルド・タイムアウト・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は600です。

--cluster-local, --cl

プロジェクト専用エンドポイントを使用してアプリケーションをデプロイします。 プロジェクト専用エンドポイントを設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている他の Code Engine コンポーネントからのみネットワーク・アクセスが可能になります。 この値はオプション です。 デフォルト値はfalseです。

--command, --cmd, -c

アプリケーションのコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--concurrency, --cn

1 つのインスタンスで同時に処理できる要求の最大数。 この値はオプション です。 デフォルト値は100です。

--concurrency-target, --ct

インスタンスあたりの同時要求数のしきい値。この値に達すると、1 つ以上の追加インスタンスが作成されます。 同時要求の数に基づいてインスタンスをスケールアップするときにこの値を使用します。 --concurrency-target を指定しない場合、このオプションはデフォルトで --concurrency オプションの値に設定されます。 この値はオプション です。 デフォルト値は 0です。

--cpu

アプリケーションのインスタンスのために設定する CPU の量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は1です。

--env, -e

アプリケーションに環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

--ephemeral-storage, --es

アプリケーションのインスタンスのために設定する一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。 デフォルト値は 400Mです。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap または --mount-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret、--mount-secret、または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

このアプリケーションに使用するイメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 --build-sourceオプションが指定されていない場合は、イメージ・オプションが必要です。 この値はオプション です。

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

このアプリケーションに使用できるインスタンスの最大数。 この値を0に設定すると、アプリケーションは必要に応じてスケーリングされます。 アプリケーションのスケーリングは、アプリケーションのプロジェクトのリソース割り当て量ごとのインスタンスによってのみ制限されます。 Code Engine の制限と割り当て量を参照してください。 この値はオプション です。 デフォルト値は 10です。

--memory, -m

アプリケーションのインスタンスに設定するメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は4Gです。

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

このアプリケーションに使用できるインスタンスの最小数。 このオプションは、必要がないときにはインスタンスを 1 つも実行しないようにする場合に役に立ちます。 この値はオプション です。 デフォルト値は0です。

--mount-configmap, --mount-cm

マウント・ディレクトリーと構成マップの名前を MOUNT_DIRECTORY=CONFIGMAP_NAME の形式で指定して、アプリケーション・コンテナーのファイル・システムに構成マップの内容を追加します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-secret, --mount-sec

マウント・ディレクトリーとシークレットの名前を MOUNT_DIRECTORY=SECRET_NAME の形式で指定して、アプリケーション・コンテナーのファイル・システムにシークレットの内容を追加します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

--no-cluster-local, --ncl

パブリック・エンドポイントを使用してアプリケーションをデプロイします。 アプリケーションは、パブリック・インターネットまたはCode Engineプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 この値はオプション です。 デフォルト値はtrueです。

--no-wait, --nw

アプリケーションを作成し、アプリケーションの準備完了を待機しません。 --no-wait オプションを指定した場合は、アプリケーションの作成が開始され、待機は行われません。 アプリケーションの状況を確認するには、app get コマンドを使用してください。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url、およびproject-urlです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--port, -p

アプリケーションが listen するポート。 形式は [NAME:]PORT です。[NAME:] はオプションです。 [NAME:] を指定する場合、有効な値は h2c または http1 です。 [NAME:] を指定しないか、http1 と指定した場合、ポートでは HTTP/1.1 が使用されます。 [NAME:] が h2c の場合、ポートでは暗号化されない HTTP/2 が使用されます。 Code Engine は、デフォルトではアプリが着信接続をポート 8080 で listen するという前提で機能します。 アプリケーションがポート 8080 以外のポートで listen する必要がある場合は、--port を使用してそのポートを指定してください。 この値はオプション です。

--probe-live, --pl

このアプリケーションの活性プローブを NAME=VALUE 形式で構成します。 NAME の有効なオプションは、 type、 port、 path、 interval、 initial-delay、 timeout、 failure-threshold です。 このオプションは複数回指定できます。 type プロパティーは必須で、有効な値は tcp および http です。 例えば、 --probe-liveタイプ=TCP --probe-liveport=8080。 プローブの操作について詳しくは、「 アプリ用のプローブの構成」を参照してください。 この値はオプション です。

--probe-ready, --pr

このアプリケーションの作動可能プローブを NAME=VALUE 形式で構成します。 NAME の有効なオプションは、 type、 port、 path、 interval、 initial-delay、 timeout、 failure-threshold です。 このオプションは複数回指定できます。 type プロパティーは必須で、有効な値は tcp および http です。 例えば、 --probe-readyタイプ=TCP --probe-readyport=8080。 プローブの操作について詳しくは、「 アプリ用のプローブの構成」を参照してください。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

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

アプリケーションに対して行われた要求の成功/失敗までにかけられる時間 (秒単位)。 この値はオプション です。 デフォルト値は300です。

--rn, --revision-name

リビジョンの名前。 アプリケーション内で固有の名前を使用します。

• 名前に使用できるのは、小文字、数字、ハイフン (-) です。
• 名前の末尾は小文字の英数字でなければなりません。
• 完全修飾リビジョン名は、Name_of_application-Name of revisionの形式でなければなりません。
• 完全修飾リビジョン名は 63 文字以下でなければなりません。

この値はオプション です。

--scale-down-delay, --sdd

並行性が低下した状態で、アプリケーションがスケールダウンされる前に経過する時間 (秒単位)。 同時要求の数が増えると、アプリケーションが拡大します。 要求の数が減少 (並行性の低下) した場合、このオプションに指定された時間によって、アプリケーションがスケールダウンされる前に、削減された並行性を保持する必要がある期間が決定されます。 デフォルトでは、並行性の低下が検出されると、アプリケーションは即時にスケールダウンされます。 この値はオプション です。 デフォルト値は0です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

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

このアプリケーションのコンテナーへの計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--user, -u

アプリケーションを実行するために使用するユーザー ID (UID)。 この値は、アプリケーションの Dockerfile に設定されているユーザー ID をオーバーライドします。 コンテナーのオペレーティング・システム要件に準拠した ID でなければなりません。 この値はオプション です。 デフォルト値は0です。

--visibility, -v

アプリケーションの表示設定。 有効な値は public、 private、 project。 可視性をpublicに設定することは、アプリがパブリック・インターネットから、またはCode Engineプロジェクト内のコンポーネントから要求を受信できることを意味します。 可視性をprivateに設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている仮想プライベート・エンドポイント (VPE) またはCode Engineコンポーネントを使用する他のIBM Cloudからのみネットワーク・アクセスが可能になります。 可視性をprivateにできるのは、プロジェクトがアプリケーションのプライベート可視性をサポートしている場合のみです。 可視性をprojectに設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている他のCode Engineコンポーネントからのみネットワーク・アクセスが可能になります。 この値はオプション です。

--wait, -w

アプリケーションを作成し、アプリケーションの準備完了を待機します。 --wait オプションを指定した場合、アプリケーション作成コマンドは、--wait-timeout オプションで設定された最大時間 (秒単位) まで、アプリケーションの準備完了を待機します。 指定した wait-timeout の期間内にアプリケーションの準備が完了しない場合、アプリケーション作成コマンドは失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

アプリケーションの準備が完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

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

出力例

Creating application 'myapp'...
[...]
Run `ibmcloud ce application get -n 'myapp'` to check the application status.
OK

https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud

アプリケーションの状態を確認するために ibmcloud ce application get -n 'myapp' を実行すると、アプリケーションの URL が表示されます。

コマンド・オプション

--name, -n

アプリケーションの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--no-wait, --nw

アプリケーションを削除し、このアプリケーションが削除されるのを待機しません。 no-wait オプションを指定した場合は、アプリケーションの削除が開始され、待機は行われません。 アプリケーションの状況を確認するには、app get コマンドを使用してください。 この値はオプション です。 デフォルト値は trueです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

アプリケーションを削除し、このアプリケーションが削除されるのを待機します。 --wait オプションを指定した場合、アプリケーション削除コマンドは、--wait-timeout オプションで設定された最大時間 (秒単位) まで、アプリケーションの削除を待機します。 指定した --wait-timeout の期間内にアプリケーションが削除されない場合、アプリケーション削除コマンドは失敗します。 この値はオプション です。 デフォルト値はfalseです。

--wait-timeout, --wto

アプリケーションが削除されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

ibmcloud ce application delete --name myapp -f

出力例

Deleted application 'myapp'

コマンド・オプション

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

指定されたアプリケーションのすべてのインスタンスのイベントを表示します。 --instance を指定しない場合は、この値が必須です。

--instance, -i

特定のアプリケーション・インスタンスの名前。 インスタンス名を確認するには、app get コマンドを使用してください。 --application を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例は、指定されたアプリケーションのすべてのインスタンスに関するシステム・イベント情報を表示します。

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

アプリの指定されたインスタンスのシステム・イベント情報の例

以下の例は、アプリの指定されたインスタンスに関するシステム・イベント情報を表示します。 アプリに関する詳細 (アプリの実行中インスタンスを含む) を表示するには、app get コマンドを使用します。

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

コマンド・オプション

--name, -n

アプリケーションの名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url、およびproject-urlです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--show-all-revisions, -r

このアプリケーションのすべてのリビジョンを表示します。 指定しない場合、トラフィックを受信するように構成されているリビジョンのみが表示されます。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce application get --name myapp

出力例

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

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce app list --sort-by age

出力例

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

コマンド・オプション

--all-containers, --all

指定されたアプリケーション・インスタンスのすべてのコンテナーのログを表示します。 この値はオプション です。 デフォルト値はfalseです。

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

指定されたアプリケーションのすべてのインスタンスのログを表示します。 --instance を指定しない場合は、この値が必須です。

--follow, -f

アプリケーション・インスタンスのログを監視します。 アプリケーション・インスタンスのログをストリーミングするには、このオプションを使用します。 --follow オプションを指定する場合、このログ・コマンドを終了するには Ctrl+C を入力しなければなりません。 この値はオプション です。 デフォルト値は falseです。

--instance, -i

特定のアプリケーション・インスタンスの名前。 インスタンス名を確認するには、app get コマンドを使用してください。 --application を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--raw, -r

インスタンスとコンテナー・ラベルなしでログを表示します。 この値はオプション です。 デフォルト値はfalseです。

--tail, -t

指定されたアプリケーション・インスタンスのコンテナーについて、ログの最新の行をコンテナーごとに最大で何行表示するかを制限します。 例えば、指定したアプリケーション・インスタンスのコンテナーのログの最後の3行を表示するには、--tail 3と指定します。 このオプションが指定されない場合、指定されたアプリケーション・インスタンスのコンテナーのログのすべての行が表示されます。 この値はオプション です。 デフォルト値は -1です。

--timestamps, --ts

ログ出力の各行にタイム・スタンプを含めます。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例は、アプリの特定のインスタンスのログを表示します。 アプリ・インスタンスの名前は、app get コマンドで確認できます。

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

出力例

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/

アプリのすべてのインスタンスのログの例

以下の例では、アプリのすべてのインスタンスのログを表示します。

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/

コマンド・オプション

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

指定したアプリケーションの実行中のインスタンスをすべて再始動します。 --instance を指定しない場合は、この値が必須です。

--instance, -i

特定のアプリケーション・インスタンスの名前。 インスタンス名を確認するには、app get コマンドを使用してください。 --application を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce application restart --name myapp

出力例

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

コマンド・オプション

--name, -n

アンバインドするアプリケーションの名前。 この値は必須です。

--all, -A

このアプリケーションのすべてのサービス・インスタンスをアンバインドします。 --binding を指定しない場合は、この値が必須です。 デフォルト値はfalseです。

--binding, -b

アンバインドするバインディングの名前。 バインディング名を参照するには、ibmcloud ce app get -n APP_NAME を実行します。 --all を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

この例では、myapp というアプリケーションからすべてのバインディングを削除します。

ibmcloud ce application unbind --name myapp --all

出力例

Removing service bindings...
OK

コマンド・オプション

--name, -n

アプリケーションの名前。 この値は必須です。

--argument, --arg, -a

アプリケーションの引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値はオプション です。

--arguments-clear, --ac

アプリケーションの引数をクリアします。 この値はオプション です。 デフォルト値はfalseです。

--build-clear, --bc

このアプリケーションからビルドの関連付けを削除します。 ビルドクリアオプションは、アプリに現在関連するビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 ビルドコミットオプションは、この app update コマンドで Git リポジトリの URL に --build-source オプションが設定されている場合、または現在アプリケーションに Git リポジトリソースからの関連ビルドがある場合にのみ許可されます。 この値はオプション です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチをクリアします。 コミットクリアオプションは、アプリケーションに現在関連するビルドがある場合に使用できます。 この値はオプション です。 デフォルト値はfalseです。

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

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 このapp updateコマンドに--build-sourceオプションが設定されている場合、またはアプリケーションに現在関連付けられたビルドがある場合は、ビルド・コンテキスト・ディレクトリー・オプションが許可されます。 この値はオプション です。

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

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 build dockerfile オプションは、この app update コマンドに --build-source オプションが設定されているか、アプリケーションに現在関連するビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はDockerfileです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、この application update コマンドで --build-source オプションが Git リポジトリの URL に設定されているか、アプリケーションに Git リポジトリ・ソースからの関連ビルドが現在ある場合にのみ許可されます。 この値はオプション です。

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

SSH シークレットをクリアします。 このオプションは、アプリケーションに現在関連するビルドがある場合に許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 ビルド・サイズ・オプションは、この app update コマンドで --build-source オプションが設定されているか、アプリケーションに現在関連するビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値は medium です。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

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

イメージのビルドに使用する戦略。 有効な値は dockerfile および buildpacks です。 ビルド戦略オプションは、この app update コマンドで --build-source オプションが設定されているか、アプリケーションに現在関連するビルドがある場合にのみ許可されます。 指定しない場合、--build-sourceが指定され、ソースがローカル・マシン上にある場合、ビルド・ストラテジーは Code Engine によって決定されます。 この値はオプション です。 デフォルト値はdockerfileです。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 ビルド・タイムアウト・オプションは、この app update ・コマンドに --build-source ・オプションが設定されているか、アプリケーションに現在関連するビルドがある場合にのみ許可される。 この値はオプション です。 デフォルト値は 600です。

--cluster-local, --cl

プロジェクト専用エンドポイントを使用してアプリケーションをデプロイします。 プロジェクト専用エンドポイントを設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている他の Code Engine コンポーネントからのみネットワーク・アクセスが可能になります。 この値はオプション です。 デフォルト値はfalseです。

--command, --cmd, -c

アプリケーションのコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--commands-clear, --cc

アプリケーションのコマンドをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--concurrency, --cn

1 つのインスタンスで同時に処理できる要求の最大数。 この値はオプション です。 デフォルト値は0です。

--concurrency-target, --ct

インスタンスあたりの同時要求数のしきい値。この値に達すると、1 つ以上の追加インスタンスが作成されます。 同時要求の数に基づいてインスタンスをスケールアップするときにこの値を使用します。 --concurrency-target を指定しない場合、このオプションはデフォルトで --concurrency オプションの値に設定されます。 この値はオプション です。 デフォルト値は 0です。

--cpu

アプリケーションのインスタンスのために設定する CPU の量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は0です。

--env, -e

アプリケーションに環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

構成マップ名を使用して、構成マップ全体に対する環境変数の参照を削除します。 構成マップに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

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

シークレット名を使用して、シークレット全体に対する環境変数の参照を削除します。 シークレットに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

--env-rm

構成マップまたはシークレットのキー/値のペアのキーに対する環境変数の参照を削除します。 個々のキー参照およびリテラル値を削除するには、キーの名前を指定します。 このオプションは、複数回指定できます。 この値はオプション です。

--ephemeral-storage, --es

アプリケーションのインスタンスのために設定する一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap または --mount-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret、--mount-secret、または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

このアプリケーションに使用するイメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

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

このアプリケーションに使用できるインスタンスの最大数。 この値を0に設定すると、アプリケーションは必要に応じてスケーリングされます。 アプリケーションのスケーリングは、アプリケーションのプロジェクトのリソース割り当て量ごとのインスタンスによってのみ制限されます。 Code Engine の制限と割り当て量を参照してください。 この値はオプション です。 デフォルト値は 10です。

--memory, -m

アプリケーションのインスタンスに設定するメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。

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

このアプリケーションに使用できるインスタンスの最小数。 この値はオプション です。 デフォルト値は0です。

--mount-configmap, --mount-cm

マウント・ディレクトリーと構成マップの名前を MOUNT_DIRECTORY=CONFIGMAP_NAME の形式で指定して、アプリケーション・コンテナーのファイル・システムに構成マップの内容を追加します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-rm

構成マップまたはシークレットがマウントされているディレクトリーを指定して、アプリケーション・コンテナーのファイル・システムから構成マップまたはシークレットの内容を削除します。 1 つの --mount-rm オプションにつき 1 つのマウント・ディレクトリーを指定します (例: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b)。 この値はオプション です。

--mount-secret, --mount-sec

マウント・ディレクトリーとシークレットの名前を MOUNT_DIRECTORY=SECRET_NAME の形式で指定して、アプリケーション・コンテナーのファイル・システムにシークレットの内容を追加します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

--no-cluster-local, --ncl

パブリック・エンドポイントを使用してアプリケーションをデプロイします。 アプリケーションは、パブリック・インターネットまたはCode Engineプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 この値はオプション です。 デフォルト値はtrueです。

--no-wait, --nw

アプリケーションを更新し、アプリケーションの準備完了を待機しません。 no-wait オプションを指定した場合は、アプリケーションの更新が開始され、待機は行われません。 アプリケーションの状況を確認するには、app get コマンドを使用してください。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、jsonpath-as-json=JSONPATH_EXPRESSION、url、およびproject-urlです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--port, -p

アプリケーションが listen するポート。 形式は [NAME:]PORT です。[NAME:] はオプションです。 [NAME:] を指定する場合、有効な値は h2c または http1 です。 [NAME:] を指定しないか、http1 と指定した場合、ポートでは HTTP/1.1 が使用されます。 [NAME:] が h2c の場合、ポートでは暗号化されない HTTP/2 が使用されます。 Code Engine は、デフォルトではアプリが着信接続をポート 8080 で listen するという前提で機能します。 アプリケーションがポート 8080 以外のポートで listen する必要がある場合は、--port を使用してそのポートを指定してください。 この値はオプション です。

--probe-live, --pl

このアプリケーションの活性プローブを NAME=VALUE 形式で構成します。 NAME の有効なオプションは、 type、 port、 path、 interval、 initial-delay、 timeout、 failure-threshold です。 このオプションは複数回指定できます。 type プロパティーは必須で、有効な値は tcp および http です。 例えば、 --probe-liveタイプ=TCP --probe-liveport=8080。 プローブの操作について詳しくは、「 アプリ用のプローブの構成」を参照してください。 この値はオプション です。

--probe-live-clear, --plr

活性プローブを削除します。 このオプションは、アプリに現在 Liveness プローブがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

--probe-ready, --pr

このアプリケーションの作動可能プローブを NAME=VALUE 形式で構成します。 NAME の有効なオプションは、 type、 port、 path、 interval、 initial-delay、 timeout、 failure-threshold です。 このオプションは複数回指定できます。 type プロパティーは必須で、有効な値は tcp および http です。 例えば、 --probe-readyタイプ=TCP --probe-readyport=8080。 プローブの操作について詳しくは、「 アプリ用のプローブの構成」を参照してください。 この値はオプション です。

--probe-ready-reset, --prr

作動可能プローブをデフォルト構成にリセットします。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--rebuild

ソースからイメージを再構築します。 再ビルド・オプションは、アプリケーションに現在関連付けられたビルドがある場合に許可されます。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

--registry-secret-clear, --rsc

レジストリー・シークレットをクリアします。 この値はオプション です。 デフォルト値はfalseです。

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

アプリケーションに対して行われた要求の成功/失敗までにかけられる時間 (秒単位)。 この値はオプション です。 デフォルト値は0です。

--rn, --revision-name

リビジョンの名前。 アプリケーション内で固有の名前を使用します。

• 名前に使用できるのは、小文字、数字、ハイフン (-) です。
• 名前の末尾は小文字の英数字でなければなりません。
• 完全修飾リビジョン名は、Name_of_application-Name of revisionの形式でなければなりません。
• 完全修飾リビジョン名は 63 文字以下でなければなりません。

この値はオプション です。

--scale-down-delay, --sdd

並行性が低下した状態で、アプリケーションがスケールダウンされる前に経過する時間 (秒単位)。 同時要求の数が増えると、アプリケーションが拡大します。 要求の数が減少 (並行性の低下) した場合、このオプションに指定された時間によって、アプリケーションがスケールダウンされる前に、削減された並行性を保持する必要がある期間が決定されます。 デフォルトでは、並行性の低下が検出されると、アプリケーションは即時にスケールダウンされます。 この値はオプション です。 デフォルト値は0です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

--service-account-clear, --sac

サービス・アカウントをクリアします。 この値はオプション です。 デフォルト値はfalseです。

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

このアプリケーションのコンテナーへの計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--user, -u

アプリケーションを実行するために使用するユーザー ID (UID)。 この値は、アプリケーションの Dockerfile に設定されているユーザー ID をオーバーライドします。 コンテナーのオペレーティング・システム要件に準拠した ID でなければなりません。 この値はオプション です。 デフォルト値は0です。

--visibility, -v

アプリケーションの表示設定。 有効な値は public、 private、 project。 可視性をpublicに設定することは、アプリがパブリック・インターネットから、またはCode Engineプロジェクト内のコンポーネントから要求を受信できることを意味します。 可視性をprivateに設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている仮想プライベート・エンドポイント (VPE) またはCode Engineコンポーネントを使用する他のIBM Cloudからのみネットワーク・アクセスが可能になります。 可視性をprivateにできるのは、プロジェクトがアプリケーションのプライベート可視性をサポートしている場合のみです。 可視性をprojectに設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクトで実行されている他のCode Engineコンポーネントからのみネットワーク・アクセスが可能になります。 この値はオプション です。

--wait, -w

アプリケーションを更新し、アプリケーションの準備完了を待機します。 --wait オプションを指定した場合、アプリケーション更新コマンドは、--wait-timeout オプションで設定された最大時間 (秒単位) まで、アプリケーションの準備完了を待機します。 指定した --wait-timeout の期間内にアプリケーションの準備が完了しない場合、アプリケーション作成コマンドは失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

アプリケーションが更新されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

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

出力例

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

例

ibmcloud ce beta help

出力例

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.

コマンド・オプション

-n, --name

ビルドの名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 63 文字以下でなければなりません。使用できるのは小文字の英数字とハイフン (-) です。

この値は必須です。

--build-type, --bt

ビルドのタイプ。 有効な値は git および local です。 ビルドのタイプがlocalの場合、--source、--commit、および--git-repo-secretの各オプションは無効です。 この値はオプション です。 デフォルト値はgitです。

--commit, --cm, --revision

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 コミット・オプションは、--build-typeオプションがgitの場合は許可され、--build-typeオプションがlocalの場合は許可されません。 この値はオプション です。

--context-dir, --cdr

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 この値はオプション です。

--dockerfile, --df

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 この値はオプション です。 デフォルト値はDockerfileです。

--force, -f

指定されたシークレットの参照の存在を検証しません。 シークレット参照は、--get-repo-secret または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値は falseです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、 --build-type オプションが git の場合は許可され、 --build-type オプションが local の場合は許可されません。 この値はオプション です。

--image, -i

イメージ・レジストリーのロケーション。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。TAG はオプションです。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリへのアクセスに使用されるレジストリ秘密。 registry create コマンドを実行すれば、レジストリにシークレットを追加できる。 この値はオプション です。

--size, --sz

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 この値はオプション です。 デフォルト値はmediumです。

--source, --src

ソース・コードが格納されている Git リポジトリーの URL (例: https://github.com/IBM/CodeEngine)。 ソース・オプションは、--build-typeオプションがgitの場合は必須で、--build-typeオプションがlocalの場合は許可されません。 この値はオプション です。

--strategy, --str

イメージのビルドに使用する戦略。 アプリケーションとジョブの場合、有効な値は dockerfile と buildpacks です。 関数の場合、有効な値の形式は codebundle-[RUNTIME-ID]。 例えば、ランタイム ID nodejs-20 を使用して関数のコード・バンドルをビルドする場合は、ビルド戦略として codebundle-nodejs-20 を使用します。 ibmcloud ce fn runtimes コマンドを実行すると、サポートされている関数ランタイムの ID を確認できます。 この値はオプション です。 デフォルト値はdockerfileです。

--timeout, --to

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 この値はオプション です。 デフォルト値は600です。

例

以下の例では、helloworld-build にある https://github.com/IBM/CodeEngine ブランチ内の hello ディレクトリー内にあるソース Dockerfile から、main ストラテジーおよび dockerfile サイズを指定して、medium という名前のビルド構成ファイルを作成します。 このビルドを実行依頼すると、ビルドされるコンテナー・イメージは、us.icr.io/mynamespace/codeengine-helloworld というイメージ・レジストリー・シークレットを使用してアクセスする、myregistry にある Container Registry インスタンスに格納されます。

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

出力例

Creating build helloworld-build...
OK

コマンド・オプション

--name, -n

ビルドの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce build delete --name helloworld-build

出力例

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

コマンド・オプション

--name, -n

ビルドの名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce build get --name helloworld-build

出力例

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

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce build list

出力例

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

コマンド・オプション

--name, -n

ビルドの名前。 この値は必須です。

--commit, --cm, --revision

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 この値はオプション です。

--commit-clear, --cmc

プルするソース・リポジトリー内のコミット、タグ、またはブランチをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--context-dir, --cdr

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 この値はオプション です。

--dockerfile, --df

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 この値はオプション です。 デフォルト値はDockerfileです。

--force, -f

指定されたシークレットの参照の存在を検証しません。 シークレット参照は、--get-repo-secret または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値は falseです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 この値はオプション です。

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

SSH シークレットをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

イメージ・レジストリーのロケーション。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。TAG はオプションです。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

--size, --sz

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 この値はオプション です。

--source, --src

ソース・コードが格納されている Git リポジトリーの URL (例: https://github.com/IBM/CodeEngine)。 この値はオプション です。

--strategy, --str

イメージのビルドに使用する戦略。 アプリケーションとジョブの場合、有効な値は dockerfile と buildpacks です。 関数の場合、有効な値の形式は codebundle-[RUNTIME-ID]。 例えば、ランタイム ID nodejs-20 を使用して関数のコード・バンドルをビルドする場合は、ビルド戦略として codebundle-nodejs-20 を使用します。 ibmcloud ce fn runtimes コマンドを実行すると、サポートされている関数ランタイムの ID を確認できます。 この値はオプション です。

--timeout, --to

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 この値はオプション です。 デフォルト値は600です。

例

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

出力例

Updating build helloworld-build...
OK

コマンド・オプション

--name, -n

ビルド実行の名前。 この値は必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce buildrun cancel --name mybuildrun

出力例

Cancelling build run 'mybuildrun'...
OK

コマンド・オプション

--build, -b

このオプションは、指定されたビルドからすべてのビルド実行を削除する場合に使用します。 --build 値を指定しない場合は、--name オプションが必須です。 この値はオプション です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--name, -n

ビルド実行の名前。 --name 値を指定しない場合は、--build オプションが必須です。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce buildrun delete --name mybuildrun

出力例

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

コマンド・オプション

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

ビルド実行の名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

この例は、ビルド実行に関するシステム・イベント情報を表示します。

ibmcloud ce buildrun events --buildrun mybuildrun

出力例

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

コマンド・オプション

--name, -n

ビルド実行の名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce buildrun get --name mybuildrun

出力例

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

コマンド・オプション

--build, -b

このオプションは、指定されたビルドのビルド実行のみを表示する場合に使用します。 この値はオプション です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce buildrun list

出力例

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

コマンド・オプション

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

ビルド実行の名前。 この値は必須です。

--follow, -f

ビルド実行のログを監視します。 ビルド実行のログをストリーミングするには、このオプションを使用します。 --follow オプションを指定する場合、このログ・コマンドを終了するには Ctrl+C を入力しなければなりません。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--raw, -r

インスタンスとコンテナー・ラベルなしでログを表示します。 この値はオプション です。 デフォルト値はfalseです。

--tail, -t

指定されたビルド実行のコンテナーについて、ログの最新の行をコンテナーごとに最大で何行表示するかを制限します。 例えば、指定されたビルド実行のコンテナーのログの最後の3行を表示するには、--tail 3と指定します。 このオプションが指定されない場合、指定されたビルド実行のコンテナーのログのすべての行が表示されます。 この値はオプション です。 デフォルト値は -1です。

--timestamps, --ts

ログ出力の各行にタイム・スタンプを含めます。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce buildrun logs --name mybuildrun

出力例

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

コマンド・オプション

--build, -b, --bd

使用するビルド構成の名前。 この値はオプション です。

--commit, --cm, --revision

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 ビルド・コミット・オプションは、--sourceオプションが Git リポジトリーの URL に設定されている場合は許可され、--sourceオプションが Git リポジトリーの URL に設定されていない場合は許可されません。 この値はオプション です。

--context-dir, --cdr

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 ビルド・コンテキスト・ディレクトリー・オプションは、--buildオプションが設定されていない場合は許可され、--buildオプションが設定されている場合は許可されません。 この値はオプション です。

--dockerfile, --df

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 --buildオプションが設定されていない場合はビルド Dockerfile オプションが許可され、--buildオプションが設定されている場合は許可されません。 この値はオプション です。 デフォルト値はDockerfileです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、 --build-source オプションが URL の Git リポジトリに設定されている場合にのみ許可されます。 この値はオプション です。

--image, -i

イメージ・レジストリーのロケーション。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。TAG はオプションです。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

-n, --name

ビルド実行の名前。 プロジェクト内で固有の名前を使用します。 --buildオプションが設定されている場合、name オプションはオプションです。 --buildオプションが設定されていない場合は、name オプションが必要です。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 63 文字以下でなければなりません。使用できるのは小文字の英数字とハイフン (-) です。

この値はオプション です。

--no-wait, --nw

ビルド実行を実行依頼し、このビルド実行が完了するのを待機しません。 --no-wait オプションを指定した場合は、ビルド実行の実行依頼が開始して、待機は行われません。 ビルド実行状況を確認するには、buildrun get コマンドを使用します。 この値はオプション です。 デフォルト値は trueです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 レジストリのsecretオプションは、 --build オプションが設定されていない場合は許可され、 --build オプションが設定されている場合は許可されない。 この値はオプション です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

--size, --sz

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 ビルド・サイズ・オプションは、 --build オプションが設定されていない場合は許可され、 --build オプションが設定されている場合は許可されない。 この値はオプション です。 デフォルト値はmediumです。

--source, --src

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 --buildオプションが設定されている場合、関連ビルドの--build-typeオプションがlocalであればソース・オプションが必須であり、関連ビルドの--build-typeオプションがgitであればないが許可されます。 --buildオプションが設定されていない場合、ソース・オプションはオプションです。 この値はオプション です。 デフォルト値は.です。

--strategy, --str

イメージのビルドに使用する戦略。 アプリケーションとジョブの場合、有効な値は dockerfile と buildpacks です。 関数の場合、有効な値の形式は codebundle-[RUNTIME-ID]。 例えば、ランタイム ID nodejs-20 を使用して関数のコード・バンドルをビルドする場合は、ビルド戦略として codebundle-nodejs-20 を使用します。 ibmcloud ce fn runtimes コマンドを実行すると、サポートされている関数ランタイムの ID を確認できます。 ビルド戦略オプションは、 --build オプションが設定されていない場合は許可され、 --build オプションが設定されている場合は許可されない。 指定されていない場合、 --source が指定され、ソースがローカル・マシンにあれば、ビルド戦略は Code Engine によって決定される。 この値はオプション です。 デフォルト値は dockerfileです。

--timeout, --to

ビルド実行の成功/失敗が決まるまで許容する時間 (秒単位)。 この値はオプション です。 デフォルト値は600です。

--wait, -w

ビルド実行を実行依頼し、このビルド実行が完了するのを待機します。 --wait オプションを指定した場合、ビルド実行の実行依頼の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、ビルド実行の完了を待機します。 ビルド実行が --wait-timeout で指定された期間内に完了しない場合、ビルド実行の実行依頼は失敗します。 この値はオプション です。 デフォルト値はfalseです。

--wait-timeout, --wto

このビルド実行が完了するまでに待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

以下のコマンドでは、mybuildrun というビルド実行を実行し、helloworld-build というビルド構成ファイルを使用しています。

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

出力例

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

コマンド・オプション

-n, --name

構成マップの名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 253 文字以下でなければならず、使用できるのは小文字、数字、ピリオド (.)、ハイフン (-) です。

この値は必須です。

--from-env-file, -e

KEY=VALUE の形式と一致する行が 1 つ以上含まれるファイルから構成マップを作成します。 ファイルのパスを値として指定する必要があります。 指定したファイルにある各行が、キー/値のペアとして追加されます。 指定されたファイル内の、空または#で始まる行はすべて無視されます。 --from-literal または --from-file を指定しない場合は、この値が必須です。

--from-file, -f

ファイルから構成マップを作成します。 ファイルのパスを値として指定する必要があります。 --from-literal または --from-env-file を指定しない場合は、この値が必須です。

--from-literal, -l

キー/値のペアから構成マップを作成します。 形式は KEY=VALUE でなければなりません。 --from-file または --from-env-file を指定しない場合は、この値が必須です。 このオプションは、複数回指定できます。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例では、2 組のキー/値のペア (configmap-fromliteral および color=blue) を使用して、size=large という名前の構成マップを作成しています。

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

出力例

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

複数のファイルからの値を持つ構成マップの例

以下の例では、複数のファイルに含まれている値を使用して、configmap-fromfile という名前の構成マップを作成しています。

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.

コマンド・オプション

--name, -n

構成マップの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

Deleting Configmap 'configmap-fromliteral'...
OK

コマンド・オプション

--name, -n

構成マップの名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce configmap get --name configmap-fromliteral

出力例

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

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce configmap list

出力例

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

コマンド・オプション

--name, -n

構成マップの名前。 この値は必須です。

--from-env-file, -e

KEY=VALUE の形式と一致する行が 1 つ以上含まれるファイルで構成マップを更新します。 ファイルのパスを値として指定する必要があります。 指定したファイルにある各行が、キー/値のペアとして追加されます。 指定されたファイル内の、空または#で始まる行はすべて無視されます。 --from-literal または --from-file を指定しない場合は、この値が必須です。 このオプションは、複数回指定できます。

--from-file, -f

ファイルから構成マップを更新します。 ファイルのパスを値として指定する必要があります。 --from-literal または --from-env-file を指定しない場合は、この値が必須です。 このオプションは、複数回指定できます。

--from-literal, -l

キー/値のペアから構成マップを更新します。 形式は KEY=VALUE でなければなりません。 --from-file または --from-env-file を指定しない場合は、この値が必須です。 このオプションは、複数回指定できます。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--rm

キーの名前を指定して、構成マップの個々のキー/値のペアを削除します。 このオプションは、複数回指定できます。 この値はオプション です。

例

以下の例では、ユーザー名とパスワードの値のペアを使用して、configmap-fromliteral という名前の構成マップを更新しています。

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

出力例

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

ファイルからの値を含む構成マップの例

以下の例では、ファイルに含まれている値を使用して、configmap-fromfile という名前の構成マップを更新しています。

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.

例

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

出力例

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

プライベート・パスのアウトバウンド接続を作成する例

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

プライベート・パスのアウトバウンド接続を作成する出力例

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

例

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

出力例

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

例

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

出力例

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

プライベート・パスのアウトバウンド接続を取得する例

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

プライベート・パスのアウトバウンド接続を取得するための出力例

Getting allowed outbound destination 'my-pps-connection'...
OK

Project name:  myproj
Name:          my-pps-connection
Format:        private_path_service_gateway  

Private path service:    
  CRN:        crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::private-path-service-gateway:r010-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f
  Status:     ready  
  Name:       my-private-path--is-vpc-pps  
  Endpoints:    
    api.ce-1a2b3c4d5e6f.intra  

VPE gateway:             
  Name:          code-engine-prod-eu-de-1234ab
  IP addresses:    
    192.168.12.48
    192.168.24.60
    192.168.36.72

例

ibmcloud ce connectivity outbound list

出力例

Listing allowed outbound destinations...
OK

CIDR ranges:                 
  Name               IP address range  
  allow-to-subnet-a  5.6.7.8/29
  allow-to-subnet-b  11.12.13.0/24

Private path connections:    
  Name               Status  Service endpoints  
  broken-connection  failed    
  my-pps-connection  ready   api.ce-1a2b3c4d5e6f.intra

例

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

出力例

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

コマンド・オプション

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

ドメイン・マッピングの名前を指定します。 この名前は、有効な完全修飾ドメイン名 (FQDN) でなければなりません。 例えば、www.example.com です。 この値は必須です。

--target, -t

ターゲット・アプリケーションまたは関数の名前。 この値は必須です。

--target-type, --type

ターゲットのタイプです。 有効な値は application または functionです。 この値は必須です。

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

すべての中間証明書を含む証明書と、ドメインマッピングに対応する秘密鍵を含むTLSシークレットを指定する。 証明書は、信頼できる公開認証局 (CA) によって署名されている必要があります。 自己署名証明書はサポートされていません。 この値は必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例では、 Code Engine myapp アプリケーションとカスタム・ドメイン www.example.com の間のカスタム・ドメイン・マッピングを作成し、TLS シークレット mytlssecret を使用します。

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

出力例

OK
Domain mapping successfully created.

コマンド・オプション

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

ドメイン・マッピングの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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

コマンド・オプション

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

ドメイン・マッピングの名前。この値は 必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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  

コマンド・オプション

--all, -a

プロジェクト内のすべてのドメイン・マッピング (カスタム・ドメイン・マッピングやシステム・ドメイン・マッピングなど) を表示します。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

以下の例では、すべてのカスタム・ドメイン・マッピングのリストを表示します。

ibmcloud ce domainmapping list

出力例

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    

カスタム・ドメイン・マッピングと自動生成されたシステム・ドメイン・マッピングの両方を含む、アプリケーションのすべてのドメイン・マッピングのリストを表示するには、 ibmcloud ce domainmapping list コマンドで --all オプションを指定します。

コマンド・オプション

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

ドメイン・マッピングの名前。 この値は必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--target, -t

ターゲット・アプリケーションまたは関数の名前。 この値はオプション です。

--target-type, --type

ターゲットのタイプです。 有効な値は application または functionです。 この値はオプション です。

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

すべての中間証明書を含む証明書と、ドメインマッピングに対応する秘密鍵を含むTLSシークレットを指定する。 証明書は、信頼できる公開認証局 (CA) によって署名されている必要があります。 自己署名証明書はサポートされていません。 この値はオプション です。

例

以下の例では、 mytlssecret の代わりに mytlssecret2 を使用するように www.example.com ドメイン・マッピングを更新します。

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

出力例

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

例

ibmcloud ce experimental help

出力例

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.

コマンド・オプション

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

必須。 サーバーレスフリートのID。 この値は必須です。

--force, -f

確認なしの強制キャンセル。 この値はオプション です。 デフォルト値はfalseです。

--hard

running 状態のタスクを含むサーバーレスフリートを即座にキャンセルする。 hard オプションを指定しない場合、 running 状態のタスクの処理は、最終状態に達するまで継続され、そのときだけ艦隊は canceled 状態に変わる。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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  

コマンド・オプション

--image, -i

必須。 タスク処理に使用するコンテナ・イメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 この値は必須 です。

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

必須。 船団のタスクの状態を保存するCOSバケットを指定する。 この値は必須です。

--argument, --arg, -a

タスクで実行するコマンドに必要なコマンド引数を設定する。 このオプションは、複数回指定できます。 この値はオプション です。

--command, --cmd, -c

タスクで実行するコマンドを設定する。 このオプションは、複数回指定できます。 この値はオプション です。

--cpu, --cp

タスクに設定するCPUの量。 この値はオプション です。 デフォルト値は1です。

--env, -e

タスクに渡す環境変数を設定する。 NAME=VALUE 形式にする必要があります。 このオプションは、複数回指定できます。 この値はオプション です。

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

この configmap に保管されているキーと値のペアから環境変数を設定します。 完全な configmap を参照するには NAME を指定し、各キーの接頭部が PREFIX である完全な configmap を参照するには PREFIX=NAME を指定し、個々のキーを参照するには NAME:KEY_A,KEY_B を指定します。 参照されるキーに新しい名前を指定するには、NAME:NEW_KEY_NAME=KEY_A の形式を使用します。 このオプションは、複数回指定できます。 この値はオプション です。

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

このシークレットに保管されているキーと値のペアから環境変数を設定します。 完全なシークレットを参照するには NAME を指定し、各キーの接頭部が PREFIX である完全なシークレットを参照するには PREFIX=NAME を指定し、個々のキーを参照するには NAME:KEY_A,KEY_B を指定します。 参照されるキーに新しい名前を指定するには、NAME:NEW_KEY_NAME=KEY_A の形式を使用します。 このオプションは、複数回指定できます。 この値はオプション です。

--gpu, --gp

リソースに割り当てるGPUの数。 フォーマットはGPU_FAMILY:NUMBER_OF_GPUSです。 NUMBER_OF_GPUSのデフォルトは1であり、小数も可能である。 例： h100:0.5 この値は任意である。

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

並列に実行するタスクインスタンスの最大数。 この値はオプション です。 デフォルト値は1です。

--maxexecutiontime, --met

タスクの最大実行時間（秒）。 この値はオプション です。 デフォルト値は0です。

--memory, -m

タスクに設定するメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。 デフォルト値は 2Gです。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--name, -n

フリートの名前。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 ibmcloud ce registry create を実行してレジストリ秘密を作成する。 この値はオプション です。

--retrylimit, -r

タスクを失敗としてマークする前に再実行する回数。 この値はオプション です。 デフォルト値は3です。

--task-indexes, --ti

0,3,6,9, 1-5,7-8,10 のように、処理するタスクインデックスを指定する。 インデックス・エントリーは1000個以下とする。 --tasks が指定されている場合、このオプションは指定できない。 この値はオプション です。

--tasks, --ts

フリートが処理するタスク数を指定する。 この値はオプション です。 デフォルト値は0です。

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

COSバケット内のファイルの場所を指定する。 それぞれのファイルに対して、タスクがフリートによって処理される。 この値はオプション です。

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

COSバケットに存在するJSONLファイルの場所を指定する。 このファイルには、フリートが処理するタスクが定義されている。 この値はオプション です。

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

ローカルのJSONLファイルの場所を指定します。 このファイルには、フリートが処理するタスクが定義されている。 この値はオプション です。

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

支援対象者のプロフィール希望を記入する。 この値はオプション です。

例

ibmcloud ce fleet cancel create --image icr.io/codeengine/helloworld --tasks-state-store mytaskstore --tasks 1

出力例

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

コマンド・オプション

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

必須。 サーバーレスフリートのID。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

サーバーレスフリートを削除し、フリートが削除されるのを待つ。 この値はオプション です。 デフォルト値はfalseです。

--wait-timeout, --wto

サーバーレスフリートが削除されるまでの待ち時間（秒）。 この値はオプション です。 デフォルト値は180です。

例

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

出力例

Deleting serverless fleet...
OK

コマンド・オプション

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

必須。 サーバーレスフリートのID。 この値は必須です。

--output, -o

出力フォーマット。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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 CRN 0:  crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  

コマンド・オプション

--output, -o

出力フォーマット。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は、name、status、およびageです。 この値はオプション です。 デフォルト値はnameです。

例

ibmcloud ce fleet list

出力例

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  

コマンド・オプション

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

Getting serverless fleet task '2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f'...
OK

ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Task index:    226  
Created:       2025-09-26T12:45:58Z  
Finished:      2025-09-26T12:47:03Z  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  

State information:    
  Status:       successful  
  Retries:      0  
  Worker name:  fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-1

例

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

出力例

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

コマンド・オプション

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

Deleting serverless fleet worker...
OK

例

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

出力例

Getting serverless fleet worker...
OK

Name:          fleet-1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e-42  
ID:            2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  
Created:       2025-09-26T20:05:33Z  
Status:        running  
Version:       v1.0.15  
Fleet ID:      1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e  
Project name:  myproj  
Project ID:    3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  

Network placement:      
  IP address:    10.242.0.42  
  Network zone:  eu-de-1  
  Subnet CRN:    crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f  

Profile information:    
  Profile:       cx2-2x4  
  vCPUs:         2  
  Memory (GiB):  4  

例

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

出力例

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

コマンド・オプション

--name, -n

バインドする関数の名前です。 この値は必須です。

--no-wait, --nw

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるのを待機しません。 no-wait オプションを指定した場合は、サービス・バインディングの作成が開始して、コマンドは作成の完了を待機せずに終了します。 ファンクションのバインドステータスを確認するには、 function get コマンドを使用する。 この値はオプション です。 デフォルト値は falseです。

--prefix, -p

このサービス・バインディング用に作成される環境変数の接頭部。 使用できるのは大文字、数字、および下線 (_) だけです。また、先頭を数字にすることはできません。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--role, -r

このサービス・バインディング用に作成される新しいサービス資格情報のサービス役割の名前。 有効な値には、Reader、Writer、Manager、またはサービス固有の役割があります。 デフォルトではこのオプションは Manager に設定されます。Manager がサポートされない場合には、サービスから最初に指定された役割に設定されます。 --service-credential を指定した場合、このオプションは無視されます。 この値はオプション です。

--service-credential, --sc

このサービス・バインディングで使用する既存のサービス資格情報の名前。 サービス・インスタンス資格情報を指定しない場合は、バインディング操作時に新規の資格情報が生成されます。 この値はオプション です。

--service-instance, --si

関数にバインドする既存の IBM Cloud サービスインスタンス名。 この値はオプション です。

--service-instance-id, --siid

関数にバインドする既存の IBM Cloud サービスインスタンスの GUID。 この値はオプション です。

--wait, -w

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるまで待機します。 --wait オプシ ョ ン を指定す る と、 関数バ イ ン ド は、 --wait-timeout オプシ ョ ン で設定 さ れた最大時間 （秒）、 関数バ イ ン ド が正常に完了する ま で待機 し ます。 指定された --wait-timeout 期間内に関数バインドが正常に完了しなかったり、失敗した場合、コマンドは失敗する。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

サービス・バインディングの準備が完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は300です。

例

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

出力例

Binding service instance...
Status: Done
OK

コマンド・オプション

-n, --name

関数の名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭は小文字でなければなりません。
• 名前の末尾は小文字の英数字でなければなりません。
• 名前は 63 文字以下でなければならず、使用できるのは小文字、数字、ハイフン (-) です。

この値は必須です。

--runtime, -r

この関数に使用するランタイム。 この領域でサポートされるランタイムを見つけるには、 ibmcloud ce function runtimes を実行します。 ランタイム を参照してください。 この値は必須です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 この値はオプション です。

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

関数のソース・コードが格納されているリポジトリー内のディレクトリー。 この値はオプション です。

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

SSHシークレットの名前。これには、コード・バンドル・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれてます。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、 --build-source オプションが URL の Git リポジトリに設定されている場合にのみ許可されます。 この値はオプション です。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 この値はオプション です。 デフォルト値は600です。

--code-bundle, --cb

この機能のために使用する code-bundle イメージの名前。 build-source が指定された場合、この値はビルド・プッシュによって生成された出力画像へのパスとなる。 build-source が指定されていない場合、この値は既存のコード・バンドル・イメージへのパスになります。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。TAG はオプションです。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

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

プライベート・レジストリーでの認証に使用されるレジストリー・シークレットの名前。 registry create コマンドを実行すれば、レジストリにシークレットを追加できる。 この値はオプション です。

--cpu

機能のインスタンスに設定されたCPUの量。 有効な値については、 サポートされるメモリとCPUの 組み合わせを参照のこと。 この値はオプション です。 デフォルト値は1です。

--env, -e

関数に環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

このconfigmapに格納されているキーと値のペアから、以下のいずれかの方法で環境変数を設定する。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する。

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 この値はオプション です。 デフォルト値はfalseです。

--inline-code

関数のソースコードを含むファイルへのパスを指定します。 コードは関数と一緒にインラインで格納される。 この値はオプション です。

--main, --fn-main

提供されたソース・コードに主要機能の名前を指定します。 名前が main でない場合、このオプションは必須です。 この値はオプション です。 デフォルト値はmainです。

--maxexecutiontime, --met

この関数が実行を完了するまでの最大時間 (秒)。 この値はオプション です。 デフォルト値は60です。

--memory, -m

機能に設定されているメモリ量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は4Gです。

--no-wait, --nw

ビルド実行が完了するのを待ちません。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--scale-down-delay, --sdd

呼び出しの完了後にインスタンスがアクティブになっている時間 (秒)。 このオプションにより、コールド・スタートの回数を減らすことができます。 詳しくは、 機能インスタンスの存続期間を長くすることはできますか? を参照してください。 この値はオプション です。 デフォルト値は1です。

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

関数の実行に対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--visibility, -v

関数の可視性。 有効な値は public、 private、 project。 プロジェクトがファンクション・プライベート・ビジビリティをサポートしている場合のみ、ビジビリティは private。 この値はオプション です。 デフォルト値はpublicです。

--wait, -w

ビルド実行が完了するまで待ちます。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

関数が準備完了になるまでの待ち時間（秒）。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

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

出力例

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

ファンクションのステータスをチェックするために ibmcloud ce fn get -n 'myfunction' を実行すると、ファンクションの URL が表示されます。

コマンド・オプション

--name, -n

関数の名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce fn delete --name myfunction

出力例

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

コマンド・オプション

--name, -n

関数の名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--save, -s

関数のソースコードをローカルファイルシステムに保存する。 このオプションは、インライン・コードで作成された関数に対してのみサポートされます。 この値はオプション です。

例

ibmcloud ce fn get --name myfunction

出力例

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-20  
  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-20 (managed)  
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce fn delete --name myfunction

出力例

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  

コマンド・オプション

--all, -A

非推奨のランタイムを含めて、すべてのランタイムを表示します。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce fn runtimes

出力例

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

コマンド・オプション

--name, -n

アンバインドする関数の名前です。 この値は必須です。

--all, -A

この機能のすべてのサービス・インスタンスをアンバインドします。 --binding を指定しない場合は、この値が必須です。 デフォルト値はfalseです。

--binding, -b

アンバインドするバインディングの名前。 バインディング名を参照するには、ibmcloud ce function get -n FUNCTION_NAME を実行します。 --all を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce fn unbind --name myfunction --all

出力例

Removing bindings from 'myfunction'...
OK

コマンド・オプション

--name, -n

必須。 関数の名前。 この値は必須です。

--build-clear, --bc

この関数からビルドの関連付けを削除します。 ビルドクリアオプションは、あなたの関数が現在関連するビルドを持っている場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 この値はオプション です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチをクリアします。 コミット・クリア・オプションは、機能に現在関連付けられたビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

関数のソース・コードが格納されているリポジトリー内のディレクトリー。 このオプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。

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

あなたのイメージをビルドするためのソースコードを含むプライベートリポジトリにアクセスするための認証情報を含むSSHシークレットの名前。 この値はオプション です。

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

SSH シークレットをクリアします。 このオプションは、機能に現在関連付けられたビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 この値はオプション です。 デフォルト値は600です。

--code-bundle, --cb

この機能のために使用する code-bundle イメージの名前。 build-source が指定された場合、この値はビルド・プッシュによって生成された出力画像へのパスとなる。 build-source が指定されていない場合、この値は既存のコード・バンドル・イメージへのパスになります。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。TAG はオプションです。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

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

プライベート・レジストリーでの認証に使用されるレジストリー・シークレットの名前。 registry create コマンドを実行すれば、レジストリにシークレットを追加できる。 この値はオプション です。

--cpu

機能のインスタンスに設定されたCPUの量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は1です。

--env, -e

関数に環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

構成マップ名を使用して、構成マップ全体に対する環境変数の参照を削除します。 構成マップに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

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

シークレット名を使用して、シークレット全体に対する環境変数の参照を削除します。 シークレットに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

--env-rm

構成マップまたはシークレットのキー/値のペアのキーに対する環境変数の参照を削除します。 個々のキー参照およびリテラル値を削除するには、キーの名前を指定します。 このオプションは、複数回指定できます。 この値はオプション です。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap または --mount-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret、--mount-secret、または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--inline-code

関数のソース・コードを含むファイルへのパスを指定します。 コードは関数と一緒にインラインで格納される。 この値はオプション です。

--main, --fn-main

提供されたソース・コードに主要機能の名前を指定します。 名前が main でない場合、このオプションは必須です。 この値はオプション です。 デフォルト値はmainです。

--maxexecutiontime, --met

この関数が実行を完了するまでの最大実行時間（秒）。 この値はオプション です。 デフォルト値は60です。

--memory, -m

機能に設定されているメモリ量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は4Gです。

--no-wait, --nw

ビルド実行を実行依頼し、このビルド実行が完了するのを待機しません。 --no-wait オプションを指定した場合は、ビルド実行の実行依頼が開始して、待機は行われません。 ビルド実行状況を確認するには、buildrun get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--rebuild

ソースからイメージを再構築する。 リビルドオプションは、その関数が現在関連するビルドを持っている場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

--runtime, -r

この関数に使用するランタイム。 この領域でサポートされるランタイムを見つけるには、 ibmcloud ce function runtimes を実行します。 ランタイム を参照してください。 この値はオプション です。

--scale-down-delay, --sdd

呼び出しの完了後にインスタンスがアクティブになっている時間 (秒)。 このオプションにより、コールド・スタートの回数を減らすことができます。 詳しくは、 機能インスタンスの存続期間を長くすることはできますか? を参照してください。 この値はオプション です。 デフォルト値は1です。

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

関数の実行に対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--visibility, -v

関数の可視性。 有効な値は public、 private、 project。 プロジェクトがファンクション・プライベート・ビジビリティをサポートしている場合のみ、ビジビリティは private。 この値はオプション です。

--wait, -w

ビルド実行が完了するまで待ちます。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

関数が準備完了になるまでの待ち時間（秒）。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

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

出力例

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

ファンクションのステータスをチェックするために ibmcloud ce fn get -n 'myfunction' を実行すると、ファンクションの URL が表示されます。

例

ibmcloud ce help

出力例

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.

コマンド・オプション

--name, -n

バインドするジョブの名前。 この値は必須です。

--no-wait, --nw

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるのを待機しません。 --no-wait オプションを指定した場合は、サービス・バインディングの作成が開始して、コマンドは作成の完了を待機せずに終了します。 ジョブのバインド状況を確認するには、job get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--prefix, -p

このサービス・バインディング用に作成される環境変数の接頭部。 使用できるのは大文字、数字、および下線 (_) だけです。また、先頭を数字にすることはできません。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--role, -r

このサービス・バインディング用に作成される新しいサービス資格情報のサービス役割の名前。 有効な値には、Reader、Writer、Manager、またはサービス固有の役割があります。 デフォルトではこのオプションは Manager に設定されます。Manager がサポートされない場合には、サービスから最初に指定された役割に設定されます。 --service-credential を指定した場合、このオプションは無視されます。 この値はオプション です。

--service-credential, --sc

このサービス・バインディングで使用する既存のサービス資格情報の名前。 サービス・インスタンス資格情報を指定しない場合は、バインディング操作時に新規の資格情報が生成されます。 この値はオプション です。

--service-instance, --si

ジョブにバインドする既存の IBM Cloud サービス・インスタンスの名前。 この値はオプション です。

--service-instance-id, --siid

ジョブにバインドする既存のIBM Cloudサービス・インスタンスの GUID。 この値はオプション です。

--wait, -w

サービス・インスタンスをバインドし、サービス・バインディングが準備完了になるまで待機します。 --wait オプションを指定した場合、ジョブ・バインドの際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、ジョブ・バインドの正常完了を待機します。 ジョブ・バインドが正常に完了しない場合、または --wait-timeout で指定された期間内に失敗した場合、このコマンドは失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

サービス・バインディングの準備が完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は300です。

例

この例では、my-object-storage という名前のサービス・インスタンスを、hello という名前のジョブにバインドしています。

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

出力例

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

コマンド・オプション

-n, --name

ジョブの名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 63 文字以下でなければならず、使用できるのは小文字、数字、ハイフン (-) です。

この値は必須です。

--argument, --arg, -a

ジョブの実行のための引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値はオプション です。

--array-indices, --ai

ジョブの実行に使用する配列インデックスを指定します。 ハイフン (-) またはコンマ (,) で区切ったインデックスのリストまたは範囲を指定します (例: 0,3,6,9 や 1-5,7-8,10など)。 最大値は 999999 です。 このオプションは、 --array-size オプションが指定されていない場合にのみ指定できる。 この値はオプション です。 デフォルト値は0です。

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

ジョブの実行に使用するインスタンス数を指定します。 このオプションを使用すると、システムが配列インデックスに変換します。 例えば、instances を 5 に指定すると、システムが array-indices を 0 - 4 に変換します。 このオプションを指定できるのは、--array-indices オプションが指定されていない場合のみです。 この値はオプション です。 デフォルト値は1です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 ビルドコミットオプションは、 --build-source オプションが URL の Git リポジトリに設定されている場合にのみ許可されます。 この値はオプション です。

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

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 ビルド・コンテキスト・ディレクトリー・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。

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

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 build dockerfile オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は Dockerfileです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、 --build-source オプションが URL の Git リポジトリに設定されている場合にのみ許可されます。 この値はオプション です。

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

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 ビルド・サイズ・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は medium です。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

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

イメージのビルドに使用する戦略。 有効な値は dockerfile および buildpacks です。 ビルド・ストラテジー・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 指定されていない場合、 --build-source が指定され、ソースがローカル・マシンにあれば、ビルド戦略は Code Engine によって決定される。 この値はオプション です。 デフォルト値はdockerfileです。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 ビルド・タイムアウト・オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値は600です。

--command, --cmd, -c

ジョブの実行のためのコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--cpu

ジョブの実行のために設定する CPU の量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は1です。

--env, -e

ジョブの実行のための環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

--ephemeral-storage, --es

ジョブの実行のために設定する一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。 デフォルト値は 400Mです。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

ジョブの実行に使用するイメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 --build-sourceオプションが指定されていない場合は、イメージ・オプションが必要です。 この値はオプション です。

--maxexecutiontime, --met

ジョブの実行のための最長実行時間 (秒単位)。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 7200です。

--memory, -m

ジョブの実行のために設定するメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は4Gです。

--mode

ジョブを実行するためのモード。 有効な値は task および daemon です。 task モードでは、 maxexecutiontime と retrylimit のオプションが適用される。 daemon モードでは、タイムアウトがなく、失敗したインスタンスは無期限に再起 動されるため、 --maxexecutiontime と --retrylimit オプションは使用できない。 この値はオプション です。 デフォルト値は task。

--mount-configmap, --mount-cm

構成マップの内容をジョブの実行のファイル・システムに追加します。これを行うには、マウント・ディレクトリーと構成マップの名前をMOUNT_DIRECTORY=CONFIGMAP_NAMEという形式で指定します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-secret, --mount-sec

マウント・ディレクトリーとシークレットの名前をMOUNT_DIRECTORY=SECRET_NAMEの形式で指定して、シークレットの内容をジョブの実行のファイル・システムに追加します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

--no-wait, --nw

ビルド実行が完了するのを待ちません。 --no-waitオプションを指定すると、ビルド実行が開始され、待機しません。 ビルド実行状況を確認するには、buildrun get コマンドを使用します。 待機なしオプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

--retrylimit, -r

ジョブに失敗のマークを付けるまでに、ジョブのインスタンスを再実行する回数。 ゼロ以外の終了コードを返したジョブの配列インデックスは、再実行されます。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 3です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

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

ジョブの実行に対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

ビルド実行が完了するまで待ちます。 --waitオプションを指定すると、ビルド実行は、--wait-timeoutオプションで設定された最大時間(秒単位)、ビルド実行の完了を待機します。 指定された--wait-timeout期間内にビルド実行が完了しない場合、ビルド実行は失敗します。 待機オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

ビルド実行が完了するのを待機する時間 (秒) 。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 wait-timeout オプションは、 --build-source オプションが設定されている場合にのみ許可されます。 デフォルト値は 600です。

例

以下の例では、コンテナー・イメージicr.io/codeengine/firstjobを使用し、2G MB をメモリーおよび 1 CPU としてコンテナーに割り当てます。 有効なメモリーと CPU の値の選択方法について詳しくは、サポートされるメモリーと CPU の組み合わせを参照してください。

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

出力例

Creating job 'hellojob'...
OK

コマンド・オプション

--name, -n

ジョブの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--orphan-job-runs, -o

このジョブ構成に関連付けられているジョブ実行を保持することを指定します。 後で、孤立したそれらのジョブ実行を別途削除する必要があります。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce job delete --name hello

出力例

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

ジョブを削除するために ibmcloud ce job delete コマンドを実行してジョブを削除すると、このジョブを参照しているすべてのサブミットされたジョブの実行も削除されます。

コマンド・オプション

--name, -n

ジョブの名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce job get --name hellojob

出力例

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

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce job list

出力例

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

コマンド・オプション

--name, -n

アンバインドするジョブの名前。 この値は必須です。

--all, -A

このジョブのすべてのサービス・インスタンスをアンバインドします。 --binding を指定しない場合は、この値が必須です。 デフォルト値はfalseです。

--binding, -b

アンバインドするバインディングの名前。 バインディング名を参照するには、ibmcloud ce job get -n JOB_NAME を実行します。 --all を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

この例では、hello という名前のジョブからすべてのバインディングを削除しています。

ibmcloud ce job unbind --name hello --all

出力例

Removing service bindings...
OK

コマンド・オプション

--name, -n

ジョブの名前。 この値は必須です。

--argument, --arg, -a

ジョブの実行のための引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値はオプション です。

--arguments-clear, --ac

ジョブの引数をクリアします。 この値はオプション です。 デフォルト値はfalseです。

--array-indices, --ai

ジョブの実行に使用する配列インデックスを指定します。 ハイフン (-) またはコンマ (,) で区切ったインデックスのリストまたは範囲を指定します (例: 0,3,6,9 や 1-5,7-8,10など)。 最大値は 999999 です。 このオプションは、 --array-size オプションが指定されていない場合にのみ指定できる。 この値はオプション です。

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

ジョブの実行に使用するインスタンス数を指定します。 このオプションを使用すると、システムが配列インデックスに変換します。 例えば、instances を 5 に指定すると、システムが array-indices を 0 - 4 に変換します。 このオプションを指定できるのは、--array-indices オプションが指定されていない場合のみです。 この値はオプション です。 デフォルト値は0です。

--build-clear, --bc

このジョブからビルドの関連付けを削除します。 ビルドクリアオプションは、ジョブに現在ビルドが関連付けられている場合にのみ使用できます。 この値はオプション です。 デフォルト値はfalseです。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチ。 ビルドコミットオプションは、この job update コマンドで Git リポジトリの URL に --build-source オプションが設定されている場合、またはジョブが現在 Git リポジトリソースからの関連ビルドを持っている場合にのみ許可されます。 この値はオプション です。

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

プルするソース・リポジトリー内のコミット、タグ、またはブランチをクリアします。 コミットクリアオプションは、ジョブが現在関連するビルドを持っている場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

buildpacks ファイルまたは Dockerfile を含むリポジトリー内のディレクトリー。 ビルド・コンテキスト・ディレクトリ・オプションは、この job update コマンドで --build-source オプションが設定されている場合、またはジョブが現在関連するビルドを持っている場合にのみ許可されます。 この値はオプション です。

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

Dockerfile のパス。 このオプションは、名前が Dockerfile でない場合にのみ指定します。 ビルド Dockerfile オプションは、--build-sourceオプションがこのjob updateコマンドに設定されている場合、またはジョブに現在関連付けられているビルドがある場合に許可されます。 この値はオプション です。 デフォルト値はDockerfileです。

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

SSH シークレットの名前。これには、コンテナー・イメージをビルドするためのソース・コードを含むプライベート・リポジトリーにアクセスするための資格情報が含まれています。 この SSH 秘密を作成するには、 secret create --format SSH コマンドを使用します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 このオプションは、この job update コマンドで --build-source オプションが Git リポジトリの URL に設定されている場合、またはジョブが現在 Git リポジトリ・ソースからの関連ビルドを持っている場合にのみ許可されます。 この値はオプション です。

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

SSH シークレットをクリアします。 このオプションは、ジョブが現在関連するビルドを持っている場合に許可されます。 この値はオプション です。 デフォルト値はfalseです。

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

ビルドのサイズ。使用するリソースの量を決定します。 有効な値は small、 medium、 large、 xlarge、 xxlarge。 詳しくは、ビルドのサイズの決定を参照してください。 ビルド・サイズ・オプションは、この job update コマンドで --build-source オプションが設定されている場合、または現在ジョブに関連するビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値は medium です。

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

Git リポジトリーの URL、またはソース・コードを含むローカル・ソースへのパス (例えば、https://github.com/IBM/CodeEngineまたは.)。 この値はオプション です。

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

イメージのビルドに使用する戦略。 有効な値は dockerfile および buildpacks です。 ビルド戦略オプションは、この job update コマンドで --build-source オプションが設定されている場合、またはジョブが現在関連するビルドを持っている場合にのみ許可されます。 指定しない場合、--build-sourceが指定され、ソースがローカル・マシン上にある場合、ビルド・ストラテジーは Code Engine によって決定されます。 この値はオプション です。 デフォルト値はdockerfileです。

--build-timeout, --bto

ビルドの成功/失敗が決まるまで許容する時間 (秒単位)。 ビルド・タイムアウト・オプションは、この job update ・コマンドで --build-source ・オプションが設定されているか、ジョブに現在ビルドが関連付けられている場合にのみ許可されます。 この値はオプション です。 デフォルト値は 600です。

--command, --cmd, -c

ジョブの実行のためのコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--commands-clear, --cc

ジョブのコマンドをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--cpu

ジョブの実行のために設定する CPU の量。 この値は、ジョブに割り当てられている --cpu 値を更新します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は 0です。

--env, -e

ジョブの実行のための環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: --env envA=A --env envB=B)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

構成マップ名を使用して、構成マップ全体に対する環境変数の参照を削除します。 構成マップに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

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

シークレット名を使用して、シークレット全体に対する環境変数の参照を削除します。 シークレットに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

--env-rm

構成マップまたはシークレットのキー/値のペアのキーに対する環境変数の参照を削除します。 個々のキー参照およびリテラル値を削除するには、キーの名前を指定します。 このオプションは、複数回指定できます。 この値はオプション です。

--ephemeral-storage, --es

ジョブの実行のために設定する一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

ジョブの実行に使用するイメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 この値はオプション です。

--maxexecutiontime, --met

ジョブの実行のための最長実行時間 (秒単位)。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 7200です。

--memory, -m

ジョブの実行のために設定するメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。

--mode

ジョブを実行するためのモード。 有効な値は task および daemon です。 task モードでは、 maxexecutiontime と retrylimit のオプションが適用される。 daemon モードでは、タイムアウトがなく、失敗したインスタンスは無期限に再起 動されるため、 --maxexecutiontime と --retrylimit オプションは使用できない。 この値はオプション です。

--mount-configmap, --mount-cm

構成マップの内容をジョブの実行のファイル・システムに追加します。これを行うには、マウント・ディレクトリーと構成マップの名前をMOUNT_DIRECTORY=CONFIGMAP_NAMEという形式で指定します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-rm

構成マップまたはシークレットがマウントされているディレクトリーを指定して、ジョブの実行のファイル・システムから構成マップまたはシークレットの内容を削除します。 1 つの --mount-rm オプションにつき 1 つのマウント・ディレクトリーを指定します (例: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b)。 この値はオプション です。

--mount-secret, --mount-sec

マウント・ディレクトリーとシークレットの名前をMOUNT_DIRECTORY=SECRET_NAMEの形式で指定して、シークレットの内容をジョブの実行のファイル・システムに追加します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

--no-wait, --nw

ビルド実行が完了するのを待ちません。 --no-waitオプションを指定すると、ビルド実行が開始され、待機しません。 ビルド実行状況を確認するには、buildrun get コマンドを使用します。 no-waitオプションは、この job update コマンドで --build-source オプションが設定されているか、ジョブに現在関連するビルドがある場合にのみ許可されます。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--rebuild

ソースからイメージを再構築します。 再構築オプションは、ジョブに現在関連するビルドがある場合に使用できます。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

--registry-secret-clear, --rsc

レジストリー・シークレットをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--retrylimit, -r

ジョブに失敗のマークを付けるまでに、ジョブのインスタンスを再実行する回数。 ゼロ以外の終了コードを返したジョブの配列インデックスは、再実行されます。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 3です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

--service-account-clear, --sac

サービス・アカウントをクリアします。 この値はオプション です。 デフォルト値はfalseです。

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

ジョブの実行に対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

ビルド実行が完了するまで待ちます。 --waitオプションを指定すると、ビルド実行は、--wait-timeoutオプションで設定された最大時間(秒単位)、ビルド実行の完了を待機します。 指定された--wait-timeout期間内にビルド実行が完了しない場合、ビルド実行は失敗します。 waitオプションは、この job update コマンドに --build-source オプションが設定されているか、ジョブに現在関連するビルドがある場合にのみ使用できる。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

ビルド実行が完了するのを待機する時間 (秒) 。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 待機タイムアウト・オプションは、--build-sourceオプションがこのjob updateコマンドに設定されている場合、またはジョブに現在関連ビルドがある場合に許可されます。 デフォルト値は600です。

例

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

出力例

Updating job 'hellojob'...
OK

コマンド・オプション

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--job, -j

このオプションは、指定されたジョブからすべてのジョブ実行を削除する場合に使用します。 --job 値を指定しない場合は、--name オプションが必須です。 この値はオプション です。

--name, -n

削除するジョブ実行の名前。 --name 値を指定しない場合は、--job オプションが必須です。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce jobrun delete --name myjobrun -f

出力例

Deleting job run 'myjobrun'...
OK

コマンド・オプション

--instance, -i

特定のジョブ実行インスタンスの名前。 インスタンス名を確認するには、jobrun get コマンドを使用してください。 --jobrun を指定しない場合は、この値が必須です。

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

指定されたジョブ実行のすべてのインスタンスのイベントを表示します。 --instance を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例は、指定されたジョブ実行のすべてのインスタンスに関するシステム・イベント情報を表示します。

ibmcloud ce jobrun events --jobrun myjobrun

出力例

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"

ジョブ実行の指定されたインスタンスのシステム・イベント情報の例

ibmcloud ce jobrun eventsコマンドで--instanceオプションを使用して、ジョブ実行の指定されたインスタンスのシステム・イベント情報を表示することもできます。 **jobrun get**コマンドを使用して、ジョブ実行に関する詳細 (ジョブ実行の実行中インスタンスを含む) を表示します。

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

コマンド・オプション

--name, -n

ジョブ実行の名前。 この値は必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce jobrun get --name myjobrun  

出力例

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

コマンド・オプション

--job, -j

このオプションは、指定されたジョブのジョブ実行のみを表示する場合に使用します。 この値はオプション です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce jobrun list

出力例

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

リスト表示されたジョブ実行の名前に、ジョブ実行の名前と現行リビジョンが示されています。

コマンド・オプション

--follow, -f

ジョブ実行インスタンスのログを監視します。 ジョブ実行インスタンスのログをストリーミングするには、このオプションを使用します。 --follow オプションを指定する場合、このログ・コマンドを終了するには Ctrl+C を入力しなければなりません。 この値はオプション です。 デフォルト値は falseです。

--instance, -i

特定のジョブ実行インスタンスの名前。 インスタンス名を確認するには、jobrun get コマンドを使用してください。 --jobrun を指定しない場合は、この値が必須です。

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

指定されたジョブ実行のすべてのインスタンスのログを表示します。 --instance を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--raw, -r

インスタンスとコンテナー・ラベルなしでログを表示します。 この値はオプション です。 デフォルト値はfalseです。

--tail, -t

指定されたジョブ実行インスタンスについて、ログの最新の行を最大で何行表示するかを制限します。 例えば、指定したジョブ実行インスタンスのログの最後の3行を表示するには、--tail 3と指定します。 このオプションが指定されない場合、指定されたジョブ実行インスタンスのログのすべての行が表示されます。 この値はオプション です。 デフォルト値は -1です。

--timestamps, --ts

ログ出力の各行にタイム・スタンプを含めます。 この値はオプション です。 デフォルト値はfalseです。

例

以下の例は、ジョブ実行の特定のインスタンスのログを表示します。 ジョブ実行インスタンスの名前は、jobrun get コマンドで確認できます。

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

出力例

Getting logs for job run instance 'myjobrun-3-0'...
OK

myjobrun-3-0/myjobrun:
Hi from a batch job! My index is: 3

ジョブ実行のすべてのインスタンスのログの例

以下の例では、ジョブ実行のすべてのインスタンスのログを表示します。

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

コマンド・オプション

--instance, -i

特定のジョブ実行インスタンスの名前。 インスタンス名を確認するには、jobrun get コマンドを使用してください。 --jobrun を指定しない場合は、この値が必須です。

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

指定したジョブ実行の実行中のインスタンスをすべて再始動します。 --instance を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce jobrun restart --name myjobrun   

出力例

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

コマンド・オプション

--jobrun, -j

このジョブ実行の基にする過去のジョブ実行の名前。 この値は必須です。

--argument, --arg, -a

このジョブ実行の引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値はオプション です。

--arguments-clear, --ac

ジョブ実行の引数をクリアします。 この値はオプション です。 デフォルト値はfalseです。

--array-indices, --ai

このジョブ実行に使用する配列インデックスを指定します。 ハイフン (-) またはコンマ (,) で区切ったインデックスのリストまたは範囲を指定します (例: 0,3,6,9 や 1-5,7-8,10など)。 最大値は 999999 です。 このオプションは、 --array-size オプションが指定されていない場合にのみ指定できる。 この値はオプション です。

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

このジョブ実行に使用するインスタンス数を指定します。 このオプションを使用すると、システムが配列インデックスに変換します。 例えば、instances を 5 に指定すると、システムが array-indices を 0 - 4 に変換します。 このオプションを指定できるのは、--array-indices オプションが指定されていない場合のみです。 この値はオプション です。 デフォルト値は0です。

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

JOB_ARRAY_SIZE 環境変数のカスタム値を指定する。 デフォルトでは、 JOB_ARRAY_SIZE 環境変数には、 array-size の値か、 array-indices で指定されたインデックスの数が設定される。 JOB_ARRAY_SIZE 環境変数の値は、構成された配列サイズには影響しません。 このオプションを使用して、一部のジョブ・インスタンスのみがサブミットまたは再サブミットされるジョブ再実行シナリオに対して、一定の配列サイズ値を適用します。 この値はオプション です。

--command, --cmd, -c

このジョブ実行のコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--commands-clear, --cc

ジョブ実行のコマンドをクリアします。 この値はオプション です。 デフォルト値はfalseです。

--cpu

このジョブ実行の各配列インデックスのために設定する CPU の量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は0です。

--env, -e

このジョブ実行の環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: -e envA -e envB)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

構成マップ名を使用して、構成マップ全体に対する環境変数の参照を削除します。 構成マップに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

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

シークレット名を使用して、シークレット全体に対する環境変数の参照を削除します。 シークレットに対する個々のキー参照を削除するには、--env-rm オプションを使用します。 このオプションは、複数回指定できます。 この値はオプション です。

--env-rm

構成マップまたはシークレットのキー/値のペアのキーに対する環境変数の参照を削除します。 個々のキー参照およびリテラル値を削除するには、キーの名前を指定します。 このオプションは、複数回指定できます。 この値はオプション です。

--ephemeral-storage, --es

このジョブ実行のための一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値は falseです。

--maxexecutiontime, --met

このジョブ実行の最長実行時間 (秒単位)。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 7200です。

--memory, -m

このジョブ実行に割り当てるメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。

--mode

ジョブ実行のモード。 有効な値は task および daemon です。 task モードでは、 maxexecutiontime と retrylimit のオプションが適用される。 daemon モードでは、タイムアウトがなく、失敗したインスタンスは無期限に再起 動されるため、 maxexecutiontime と retrylimit オプションは使用できない。 この値はオプション です。

--mount-configmap, --mount-cm

MOUNT_DIRECTORY=CONFIGMAP_NAMEの形式でマウント・ディレクトリーと構成マップの名前を指定して、このジョブ実行のファイル・システムに構成マップの内容を追加します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-rm

構成マップまたはシークレットがマウントされているディレクトリーを指定して、このジョブ実行のファイル・システムから構成マップまたはシークレットの内容を削除します。 1 つの --mount-rm オプションにつき 1 つのマウント・ディレクトリーを指定します (例: --mount-rm /etc/configmap-a --mount-rm /etc/secret-b)。 この値はオプション です。

--mount-secret, --mount-sec

シークレットの内容をこのジョブ実行のファイル・システムに追加します。そのためには、マウント・ディレクトリーとシークレットの名前をMOUNT_DIRECTORY=SECRET_NAMEという形式で指定します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

-n, --name

このジョブ実行の名前。 参照されているジョブに関連するジョブ構成がない場合、この値は必須です。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 53 文字以下でなければならず、使用できるのは小文字、数字、ハイフン (-) です。

この値はオプション です。

--no-wait, --nw

ジョブ実行を再実行依頼し、このジョブ実行のインスタンスが完了するのを待機しません。 --no-wait オプションを指定した場合は、ジョブ実行の再実行依頼が開始して、待機は行われません。 ジョブ実行状況を確認するには、jobrun get コマンドを使用します。 この値はオプション です。 デフォルト値は trueです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--retrylimit, -r

このジョブ実行に失敗のマークを付けるまでに、ジョブ実行のインスタンスを再実行する回数。 ゼロ以外の終了コードを返したジョブ実行の配列インデックスは、再実行されます。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 3です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

--service-account-clear, --sac

サービス・アカウントをクリアします。 この値はオプション です。 デフォルト値はfalseです。

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

このジョブ実行のインスタンスに対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

ジョブ実行を再実行依頼し、このジョブ実行のインスタンスが完了するのを待機します。 --wait オプションを指定した場合、ジョブ実行の再実行依頼の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、ジョブ実行の完了を待機します。 ジョブ実行が --wait-timeout で指定された期間内に完了しない場合、ジョブ実行の再実行依頼は失敗します。 この値はオプション です。 デフォルト値はfalseです。

--wait-timeout, --wto

インスタンスがこのジョブ実行を完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

以下の例では、インスタンス myjobrun について 4-5 ジョブ実行を再実行しています。 再実行されるジョブ実行の名前は myjobresubmit です。

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

出力例

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

コマンド・オプション

--argument, --arg, -a

このジョブ実行の引数を設定します。 引数は --argument オプション 1 つにつき 1 つ指定します (例: -a argA -a argB)。 この値はオプション です。

--array-indices, --ai

このジョブ実行に使用する配列インデックスを指定します。 ハイフン (-) またはコンマ (,) で区切ったインデックスのリストまたは範囲を指定します (例: 0,3,6,9 や 1-5,7-8,10など)。 最大値は 999999 です。 このオプションは、 --array-size オプションが指定されていない場合にのみ指定できる。 この値はオプション です。 デフォルト値は0です。

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

このジョブ実行に使用するインスタンス数を指定します。 このオプションを使用すると、システムが配列インデックスに変換します。 例えば、instances を 5 に指定すると、システムが array-indices を 0 - 4 に変換します。 このオプションを指定できるのは、--array-indices オプションが指定されていない場合のみです。 この値はオプション です。 デフォルト値は1です。

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

JOB_ARRAY_SIZE 環境変数のカスタム値を指定する。 デフォルトでは、 JOB_ARRAY_SIZE 環境変数には、 array-size の値か、 array-indices で指定されたインデックスの数が設定される。 JOB_ARRAY_SIZE 環境変数の値は、構成された配列サイズには影響しません。 このオプションを使用して、一部のジョブ・インスタンスのみがサブミットまたは再サブミットされるジョブ再実行シナリオに対して、一定の配列サイズ値を適用します。 この値はオプション です。

--command, --cmd, -c

このジョブ実行のコマンドを設定します。 コマンドは --command オプション 1 つにつき 1 つ指定します (例: --cmd cmdA --cmd cmdB)。 この値は、コンテナー・イメージ内に指定されているデフォルトのコマンドをオーバーライドします。 この値はオプション です。

--cpu

このジョブ実行の各配列インデックスのために設定する CPU の量。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は1です。

--env, -e

このジョブ実行の環境変数を設定します。 形式は NAME=VALUE でなければなりません。 この操作は、新規の環境変数を追加するか、または既存の環境変数をオーバーライドします。 環境変数は --env オプション 1 つにつき 1 つ指定します (例: -e envA -e envB)。 この値はオプション です。

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

以下のいずれかの方法を使用して、この構成マップに保管されているキーと値のペアから環境変数を設定します。

• configmapName という名前の構成マップ内のすべてのキーに対応する環境変数を追加するには、値 configmapName を使用します。 構成マップを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=CONFIGMAP_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_CONFIGMAP>です。 例えば、構成マップconfigmapName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=configmapNameを使用します。 構成マップconfigmapNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、key1 という名前の構成マップ内の 1 つのキー configmapName に対応する環境変数を追加するには、値 configmapName:key1 を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、configmapNameという名前の構成マップ内の単一キーkey1にmyKeyという名前の環境変数を追加するには、値configmapName:myKey=key1を使用します。

この値はオプション です。

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

以下のいずれかの方法で、シークレットに格納されているキーと値のペアから環境変数を設定する：

• secretName という名前のシークレット内のすべてのキーに対応する環境変数を追加するには、値 secretName を使用します。 シークレットを参照するときに接頭部を指定することにより、環境変数名を変更できます。 接頭部を指定するには、値PREFIX=SECRET_NAMEを使用します。 結果の各環境変数の形式は、<PREFIX><NAME_OF_KEY_IN_SECRET>です。 例えば、シークレットsecretName内のキーのすべての変数名の接頭部をCUSTOM_に設定するには、値CUSTOM_=secretNameを使用します。 シークレットsecretNameに KEY_A が含まれている場合、環境変数名はCUSTOM_KEY_Aです。
• 個々のキーの環境変数を追加するには、NAME:KEY_A,KEY_Bという形式を使用します。 例えば、secretNameという名前のシークレットに単一キーkey1の環境変数を追加するには、値secretName:key1を使用します。 参照されるキーに別の名前を割り当てるには、NAME:NEW_NAME=KEY_Aという形式を使用します。 例えば、secretNameという名前のシークレット内の単一キーkey1に対して myKeyという名前の環境変数を追加するには、値secretName:myKey=key1を使用します。

この値はオプション です。

--ephemeral-storage, --es

このジョブ実行のための一時ストレージの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 この値はオプション です。 デフォルト値は 400Mです。

--force, -f

指定された構成マップおよびシークレットの参照の存在を検証しません。 構成マップ参照は、--env-from-configmap オプションを使用して指定します。 シークレット参照は、--env-from-secret または --registry-secret オプションを使用して指定します。 この値はオプション です。 デフォルト値はfalseです。

--image, -i

このジョブ実行に使用するイメージの名前。 形式は REGISTRY/NAMESPACE/REPOSITORY:TAG です。REGISTRY と TAG はオプションです。 REGISTRY を指定しない場合、そのデフォルトは docker.io です。 TAG を指定しない場合、そのデフォルトは latest です。 --job オプションを指定しない場合は、--name と --image の値が必須となります。 この値はオプション です。

--job, -j

ジョブ構成の名前。 ジョブ構成を表示するには、job list コマンドを使用します。 --job 値を指定する場合は、オプションで --name 値を指定できます。 --job 値を指定しない場合は、--name 値と --image 値を指定しなければなりません。 この値はオプション です。

--maxexecutiontime, --met

このジョブ実行の最長実行時間 (秒単位)。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 7200です。

--memory, -m

このジョブ実行に割り当てるメモリーの量。 メガバイトの場合は M、ギガバイトの場合は G を使用します。 有効な値については、サポートされるメモリーと CPU の組み合わせを参照してください。 この値はオプション です。 デフォルト値は4Gです。

--mode

ジョブ実行のモード。 有効な値は task および daemon です。 task モードでは、 maxexecutiontime と retrylimit のオプションが適用される。 daemon モードでは、タイムアウトがなく、失敗したインスタンスは無期限に再起 動されるため、 maxexecutiontime と retrylimit オプションは使用できない。 この値はオプション です。 デフォルト値は task。

--mount-configmap, --mount-cm

MOUNT_DIRECTORY=CONFIGMAP_NAMEの形式でマウント・ディレクトリーと構成マップの名前を指定して、このジョブ実行のファイル・システムに構成マップの内容を追加します。 マウントされる構成マップはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 構成マップ内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-configmap オプションにつき 1 つのマウント構成を指定します (例: --mount-configmap /etc/config-a=config-a --mount-configmap /etc/config-b=config-b)。 この値はオプション です。

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

永続データ・ストアをマウントします。 フォーマットは、MOUNT_DIRECTORY=STORAGE_NAME [:SUBPATH] である。 SUBPATHはオプションである。 このオプションは、複数回指定できます。 この値はオプション です。

--mount-secret, --mount-sec

シークレットの内容をこのジョブ実行のファイル・システムに追加します。そのためには、マウント・ディレクトリーとシークレットの名前をMOUNT_DIRECTORY=SECRET_NAMEという形式で指定します。 マウントされるシークレットはそれぞれ、固有のマウント・ディレクトリーを使用しなければなりません。 シークレット内のキー/値のペアごとに、指定したマウント・ディレクトリーにファイルが追加されます。このとき、キー/値のペアのキーがそのファイル名になり、値がそのファイルの内容になります。 1 つの --mount-secret オプションにつき 1 つのマウント構成を指定します (例: --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b)。 この値はオプション です。

-n, --name

このジョブ実行の名前。 --job の値を指定しない場合、--name と --image の値が必須です。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 53 文字以下でなければならず、使用できるのは小文字、数字、ハイフン (-) です。

この値はオプション です。

--no-wait, --nw

ジョブ実行を実行依頼し、このジョブ実行のインスタンスが完了するのを待機しません。 --no-wait オプションを指定した場合は、ジョブ実行の実行依頼が開始して、待機は行われません。 ジョブ実行状況を確認するには、jobrun get コマンドを使用します。 この値はオプション です。 デフォルト値は trueです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--registry-secret, --rs

レジストリー・シークレットの名前。 レジストリー・シークレットは、コンテナー・イメージのダウンロード時にプライベート・レジストリーでの認証に使用されます。 この値はオプション です。

--retrylimit, -r

このジョブ実行に失敗のマークを付けるまでに、ジョブ実行のインスタンスを再実行する回数。 ゼロ以外の終了コードを返したジョブ実行の配列インデックスは、再実行されます。 このオプションは mode が task の場合のみ指定できる。 この値はオプション です。 デフォルト値は 3です。

--service-account, --sa

サービス・アカウントの名前。 サービス・アカウントは、インスタンスで実行されるプロセスの ID を提供します。 組み込みサービス・アカウントの場合、短縮名 manager、none、reader、および writer を使用できます。 接頭部 Kubernetes Config Context が付いたフルネームを使用することもできます。これは、project current コマンドで判別できます。 この値はオプション です。

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

このジョブ実行のインスタンスに対する計算リソース・トークンのマウントを有効にします。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

ジョブ実行を実行依頼し、このジョブ実行のインスタンスが完了するのを待機します。 --wait オプションを指定した場合、ジョブ実行の実行依頼の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、ジョブ実行の完了を待機します。 ジョブ実行が --wait-timeout で指定された期間内に完了しない場合、ジョブ実行の実行依頼は失敗します。 この値はオプション です。 デフォルト値はfalseです。

--wait-timeout, --wto

インスタンスがこのジョブ実行を完了するまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

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

出力例

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

コマンド・オプション

--cos-access-secret, --cos-sec

必須。 COS インスタンスにアクセスするための認証情報を含む秘密の名前。 この値は必須です。

--cos-bucket-name, --cos-bucket

必須。 COSバケツの名前。 この値は必須です。

--name, -n

必須。 永続データストアの名前。 プロジェクト内で固有の名前を使用します。 この値は必須です。

--cos-bucket-location, --cos-loc

COSバケットの場所。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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

コマンド・オプション

--name, -n

必須。 永続データストアの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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

コマンド・オプション

--name, -n

必須。 永続データストアの名前。 この値は必須です。

--output, -o

出力フォーマット。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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  

コマンド・オプション

--output, -o

出力フォーマット。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

このコマンドは、プロジェクト内のすべての永続データストアを一覧表示します。

ibmcloud ce persistentdatastore list

出力例

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  

コマンド・オプション

-n, --name

プロジェクトの名前。 リージョンで固有の名前を使用します。 この名前は 128 文字以下でなければならず、次の文字を使用できます。

• すべての Unicode 文字または英数字。
• 次の特殊文字: スペース ( )、ピリオド (.)、コロン (:)、アンダースコアー (_)、ハイフン (-)。

この値は必須です。

--endpoint, -e

プロジェクトのエンドポイント。 有効な値は public および private です。 --endpointオプションが明示的に指定されていない場合、動作はシステムによって決定されます。 IBM Cloud CLI がprivate.cloud.ibm.comに接続されている場合、Code Engineプロジェクトは--endpointがprivateであるかのように動作します。 IBM Cloud CLI がcloud.ibm.comに接続されている場合、Code Engineプロジェクトは--endpointがpublicであるかのように動作します。 この値はオプション です。

--no-select, --ns

プロジェクトが作成された後、そのプロジェクトを現行コンテキストとして選択しないでください。 このオプションを選択しない場合は、自動的にプロジェクトが選択されます。 この値はオプション です。 デフォルト値はfalseです。

--no-wait, --nw

プロジェクトを作成し、このプロジェクトが作成されるのを待機しません。 no-wait オプションを指定した場合は、プロジェクトの作成が開始され、待機は行われません。 プロジェクトの状況を確認するには、project get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--tag, -t

プロジェクトに割り当てるラベル。 ラベルは 128 文字以下でなければならず、文字、数字、スペース ()、ピリオド (.)、コロン (:)、下線 (_)、およびハイフン (-) を使用できます。--tagオプションごとに 1 つのラベルを指定します (例: --tag tagA --tag tagB)。 この値はオプション です。

--wait, -w

プロジェクトを作成し、このプロジェクトが作成されるのを待機します。 --wait オプションを指定した場合、プロジェクトの作成の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、プロジェクトが作成されるのを待機します。 指定した --wait-timeout の期間内にプロジェクトが作成されない場合、プロジェクトの作成は失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

プロジェクトが作成されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

ibmcloud ce project create --name myproject  

出力例

Creating project 'myproject'...
OK

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce project current  

出力例

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

コマンド・オプション

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--hard

プロジェクトをただちに削除します。 --hard オプションを指定しない場合、7 日以内であれば project restore コマンドまたは reclamation restore コマンドを使用してプロジェクトを復元できます。 この値はオプション です。 デフォルト値はfalseです。

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--no-wait, --nw

プロジェクトを削除し、このプロジェクトが削除されるのを待機しません。 no-wait オプションを指定した場合は、プロジェクトの削除が開始され、待機は行われません。 プロジェクトの状況を確認するには、project get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

プロジェクトを削除し、このプロジェクトが削除されるのを待機します。 --wait オプションを指定した場合、プロジェクトの削除の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、プロジェクトが削除されるのを待機します。 指定した --wait-timeout の期間内にプロジェクトが削除されない場合、プロジェクトの削除は失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

プロジェクトが削除されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

ibmcloud ce project delete --name myproject -f

出力例

Deleting project 'myproject'...
OK

コマンド・オプション

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce project get --name myproject

出力例

Getting project 'myproject'...
OK

Name:                       myproject
ID:                         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
Status:                     active
Selected:                   true
Tags:                       tag1, tag2
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
    Category                                  Used      Limit
    App revisions                             1         100
    Apps                                      1         100
    Build runs                                0         100
    Builds                                    0         100
    Configmaps                                2         100
    CPU                                       1.025     64
    Ephemeral storage                         902625Ki  256G
    Instances (active)                        1         250
    Instances (total)                         2         2500
    Job runs                                  1         100
    Jobs                                      1         100
    Memory                                    4400M     256G
    Secrets                                   5         100
    Subscriptions (cron)                      0         100
    Subscriptions (IBM Cloud Object Storage)  0         100

コマンド・オプション

--all-resource-groups, --all

すべてのリソース・グループのプロジェクトを表示します。 デフォルトでは、プロジェクトは現在のリソース・グループからのみ表示されます。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--regions, -r

表示するプロジェクトを指定のリージョンに制限します。 1 つ以上のリージョン名を指定してください (例: us-south,eu-de)。 この値はオプション です。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce project list

出力例

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

コマンド・オプション

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--no-wait, --nw

プロジェクトを復元し、このプロジェクトが復元されるのを待機しません。 no-wait オプションを指定した場合は、プロジェクトの復元が開始され、待機は行われません。 プロジェクトの状況を確認するには、project get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

プロジェクトを復元し、このプロジェクトが復元されるのを待機します。 --wait オプションを指定した場合、プロジェクトの復元の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、プロジェクトが復元されるのを待機します。 指定した --wait-timeout の期間内にプロジェクトが復元されない場合、プロジェクトの復元は失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

プロジェクトが復元されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

この例では、myprojectされた状況の soft deleted プロジェクトをアクティブ状態に復元します。 project list コマンドを使用すると、すべてのプロジェクトと状況のリストを表示できます。

ibmcloud ce project restore --name myproject

出力例

Restoring project 'myproject'...
OK

コマンド・オプション

--endpoint, -e

プロジェクトのエンドポイント。 有効な値は public および private です。 --endpointオプションが明示的に指定されていない場合、動作はシステムによって決定されます。 IBM Cloud CLI がprivate.cloud.ibm.comに接続されている場合、Code Engineプロジェクトは--endpointがprivateであるかのように動作します。 IBM Cloud CLI がcloud.ibm.comに接続されている場合、Code Engineプロジェクトは--endpointがpublicであるかのように動作します。 この値はオプション です。

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--kubecfg, -k

プロジェクトを Kubernetes 構成ファイルに追加します。 KUBECONFIG環境変数を設定することで、デフォルトの Kubernetes 構成ファイルをオーバーライドできます。 この値はオプション です。 デフォルト値はfalseです。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce project select --name myproject

出力例

Selecting project 'myproject'...
OK

コマンド・オプション

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--tag, -t

プロジェクトに割り当てるラベル。 ラベルは 128 文字以下でなければならず、文字、数字、スペース ()、ピリオド (.)、コロン (:)、下線 (_)、およびハイフン (-) を使用できます。--tagオプションごとに 1 つのラベルを指定します (例: --tag tagA --tag tagB)。 この値はオプション です。

--tag-rm, --trm

プロジェクトに割り当てられたラベルを削除します。 ラベルは --tag-rm オプション 1 つにつき 1 つ指定します (例: --tag-rm tagA --tag-rm tagB)。 この値はオプション です。

例

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

出力例

Getting project 'myproject'...
OK

コマンド・オプション

--binding-resource-group, --brg

このプロジェクトのサービス・バインディングの認証で使用するリソース・グループの名前。 サービス ID は、このリソース・グループ内のすべてのサービスに対するOperator役割およびManager役割を使用して作成されます。 このアカウント内のすべてのリソース・グループを指定するには、"*" を使用します。 この値はオプション です。

--binding-resource-group-id, --brgid

このプロジェクトのサービス・バインディングの認証に使用するリソース・グループの ID。 サービス ID は、このリソース・グループ内のすべてのサービスに対するOperator役割およびManager役割を使用して作成されます。 この値はオプション です。

--binding-service-id, --bsid

このプロジェクトのサービス・バインディングの認証で使用するサービス ID の ID。 このサービス ID には、Operator役割と 1 つ以上のサービス・インスタンス、サービス・タイプ、またはリソース・グループに対する適切なサービス役割が付与されている必要があります。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

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

出力例

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

コマンド・オプション

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--no-wait, --nw

プロジェクト回収を削除し、このプロジェクト回収が削除されるのを待機しません。 no-wait オプションを指定した場合は、プロジェクト回収の削除が開始され、待機は行われません。 プロジェクト回収の状況を確認するには、reclamation get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

プロジェクト回収を削除し、このプロジェクト回収が削除されるのを待機します。 --wait オプションを指定した場合、プロジェクト回収の削除の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、プロジェクト回収が削除されるのを待機します。 指定した --wait-timeout の期間内にプロジェクト回収が削除されない場合、プロジェクト回収の削除は失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

プロジェクト回収が削除されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

この例では、myproject 状況の soft deleted プロジェクトを永久に削除します。 このコマンドで --force オプションを使用すると、確認なしで削除が強制されます。 reclamation list コマンドを使用して、soft deleted 状態のすべてのプロジェクトのリストを表示できます。

ibmcloud ce reclamation delete --name myproject --f

出力例

Hard deleting project 'myproject'...
OK

コマンド・オプション

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce reclamation get --name myproject

出力例

Getting project reclamation
OK

Name:                   myproject
Reclamation ID:         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
Status:                 soft deleted
Region:                 us-south
Resource Group:         default
Age:                    27m
Created:                Thu, 09 Sep 2021 13:24:15 -0400
Updated:                Thu, 09 Sep 2021 13:33:45 -0400
Time to Hard Deletion:  6d23h

コマンド・オプション

--all-resource-groups, --all

すべてのリソース・グループのプロジェクト回収を表示します。 デフォルトでは、プロジェクト回収は現在のリソース・グループからのみ表示されます。 この値はオプション です。 デフォルト値はfalseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--regions, -r

表示するプロジェクト回収を指定のリージョンに制限します。 1 つ以上のリージョン名を指定してください (例: us-south,eu-de)。 この値はオプション です。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce reclamation list

出力例

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

コマンド・オプション

--id, --guid

プロジェクトの ID。 --name を指定しない場合は、この値が必須です。

--name, -n

プロジェクトの名前。 --id を指定しない場合は、この値が必須です。

--no-wait, --nw

プロジェクト回収を復元し、このプロジェクト回収が復元されるのを待機しません。 no-wait オプションを指定した場合は、プロジェクト回収の復元が開始され、待機は行われません。 プロジェクト回収の状況を確認するには、reclamation get コマンドを使用します。 この値はオプション です。 デフォルト値は falseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--wait, -w

プロジェクト回収を復元し、このプロジェクト回収が復元されるのを待機します。 --wait オプションを指定した場合、プロジェクト回収の復元の際に、--wait-timeout オプションで設定された最大時間 (秒単位) まで、プロジェクト回収が復元されるのを待機します。 指定した --wait-timeout の期間内にプロジェクト回収が復元されない場合、プロジェクト回収の復元は失敗します。 この値はオプション です。 デフォルト値はtrueです。

--wait-timeout, --wto

プロジェクト回収が復元されるまで待機する時間の長さ (秒単位)。 --wait オプションを指定する場合、この値は必須です。 --no-wait オプションを指定した場合、この値は無視されます。 デフォルト値は600です。

例

この例では、myprojectされた状況の soft deleted プロジェクトをアクティブ状態に復元します。 reclamation list コマンドを使用して、soft deleted 状態のすべてのプロジェクトのリストを表示できます。

ibmcloud ce reclamation restore --name myproject

出力例

Restoring project 'myproject'...
OK

コマンド・オプション

-n, --name

イメージのレジストリー・アクセス権限のシークレットの名前。 プロジェクト内で固有の名前を使用します。

• 名前の先頭と末尾は小文字の英数字でなければなりません。
• 名前は 253 文字以下でなければならず、使用できるのは小文字、数字、ピリオド (.)、ハイフン (-) です。

この値は必須です。

--email, -e

レジストリー・サーバーにアクセスするための E メール・アドレス。 この値はオプション です。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--password, -p

レジストリー・サーバーにアクセスするためのパスワード。 --password オプション、 --password-from-file オプション、--password-from-json-file オプションがいずれも指定されていない場合は、パスワードの入力を求めるプロンプトが出されます。 この値はオプション です。

--password-from-file, --pf

レジストリー・サーバーにアクセスするためのパスワードが入っているファイルのパス。 ファイルの最初の行がパスワードに使用されます。 --password オプション、 --password-from-file オプション、--password-from-json-file オプションがいずれも指定されていない場合は、パスワードの入力を求めるプロンプトが出されます。 この値はオプション です。

--password-from-json-file, --pfj

レジストリー・サーバーにアクセスするためのパスワードが入っている JSON ファイルのパス。 apikey フィールドはパスワード用に使用されます。 --password オプション、 --password-from-file オプション、--password-from-json-file オプションがいずれも指定されていない場合は、パスワードの入力を求めるプロンプトが出されます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--server, -s

レジストリー・サーバーの URL。 この値はオプション です。 デフォルト値はus.icr.ioです。

--username, -u

レジストリー・サーバーにアクセスするためのユーザー名。 この値はオプション です。 デフォルト値はiamapikeyです。

例

以下の例では、myregistry にある Container Registry インスタンスへのイメージ・レジストリー・アクセス権限 us.icr.io を作成し、ユーザー名 iamapikey および IAM の API キー (パスワード) を使用しています。

ibmcloud ce registry create --name myregistry --server us.icr.io --username iamapikey --password API_KEY   

出力例

Creating image registry access secret myregistry...

OK

コマンド・オプション

--name, -n

イメージのレジストリー・アクセス権限のシークレットの名前。 この値は必須です。

--force, -f

確認なしで削除を強制します。 この値はオプション です。 デフォルト値はfalseです。

--ignore-not-found, --inf

見つからなかった場合でも、失敗しません。 この値はオプション です。 デフォルト値はfalseです。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce registry delete --name myregistry -f   

出力例

Deleting image registry access secret myregistry...

OK

コマンド・オプション

--name, -n

イメージのレジストリー・アクセス権限のシークレットの名前。 この値は必須です。

--decode, -d

Data 出力をデコードして詳細に示します。 このオプションを指定しない場合、Data 詳細は base64 でエンコードされます。 この値はオプション です。 デフォルト値は falseです。

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

例

ibmcloud ce registry get --name myregistry   

出力例

Getting image registry access secret myregistry...
OK

Name:        myregistry
Project:     myproject
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Created:     2021-02-23T09:10:01-05:00
Data:
---
.dockerconfigjson: abcdabcdabcdabcdabcdnVzZXJuYW1lIjoiaWFtYXBpa2V5IiwicGFzc3dvcmQiOiJoQllTSTc5Uk8yQUIxSDV3RUs2UzhScV9uNzE4NkQ1eWt1M1FOUk85aFpfaCIsImVtYWlsIjoiYUBiLmMiLCabcdabcdabcdabcdabcdT21oQ1dWTkpOemxTVHpKQlFqRklOWGRGU3paVE9GSnhYMjQzTVRnMlJEVjabcdabcdabcdabcdabcdbG9XbDlvIn19fQ==

コマンド・オプション

--output, -o

コマンド出力のフォーマットを指定します。 有効な値は、json、yaml、jsonpath=JSONPATH_EXPRESSION、およびjsonpath-as-json=JSONPATH_EXPRESSIONです。 jsonpath を使用すると、JSON 出力のエレメントのパスを指定できます。 この値はオプション です。

--quiet, -q

このオプションは、コマンドの出力を減らす場合に指定します。 この値はオプション です。 デフォルト値はfalseです。

--sort-by, -s

リストのソート基準とする列を指定します。 有効な値は name および age です。 この値はオプション です。 デフォルト値は nameです。

例

ibmcloud ce registry list   

出力例

Listing image registry access secrets...

OK

Name        Age
myregistry  19m22s