IBM Cloud Code Engine CLI

이러한 명령을 실행하여 IBM Cloud® Code Engine을 구성하는 엔티티를 관리하십시오. Code Engine에 대한 자세한 정보는 Code Engine 시작하기를 참조하십시오.

IBM Cloud Code Engine 명령을 실행하려면 ibmcloud code-engine 또는 ibmcloud ce를 사용하십시오.

전제조건

  • IBM Cloud CLI를 설치하십시오.

  • 다음 명령을 실행하여 Code Engine CLI를 설치하십시오.

    ibmcloud plugin install code-engine
    

Application 명령

애플리케이션 또는 앱은 코드를 실행하여 HTTP 요청을 제공합니다. 기존 HTTP 요청 외에 IBM Cloud® Code Engine은 WebSocket을 통신 프로토콜로 사용하는 애플리케이션도 지원합니다. 앱의 실행 중인 인스턴스 수는 들어오는 요청과 사용자의 구성 설정에 따라 자동으로 확장되거나 축소(0개까지)됩니다. 앱에는 하나 이상의 개정이 포함되어 있습니다. 개정은 앱 구성 특성의 불변 버전을 나타냅니다. 앱 구성 특성을 업데이트할 때마다 앱 개정이 새로 작성됩니다.

명령을 사용하려면 프로젝트application의 컨텍스트 내에 있어야 합니다.

앱 작업에 대한 자세한 정보는 애플리케이션 배치를 참조하십시오.

application 명령에 application 또는 app를 사용할 수 있습니다. application 명령에 대한 CLI 도움말을 보려면 ibmcloud ce app -h를 실행하십시오.

애플리케이션 개정을 관리하려면 ibmcloud ce revision 명령을 참조하십시오.

ibmcloud ce application bind

IBM Cloud 서비스 인스턴스를 애플리케이션에 바인드합니다.

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

명령 옵션

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

ibmcloud ce application create

애플리케이션을 작성합니다.

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

명령 옵션

-n, --name

애플리케이션의 이름. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자로 시작해야 합니다.
  • 이름은 소문자 영숫자로 끝나야 합니다.
  • 이름은 63자 이하여야 하며 소문자, 숫자, 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--argument, --arg, -a
애플리케이션에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 컨테이너 이미지 내에 지정된 기본값을 대체합니다. 이 값은 선택사항입니다.
--build-commit, --commit, --bcm, --cm, --revision

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. 빌드 커밋 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

빌드팩 파일 또는 Dockerfile이 포함되어 있는 저장소의 디렉토리입니다. 빌드 컨텍스트 디렉터리 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

Dockerfile의 경로입니다. 이름이 Dockerfile이 아닌 경우에만 이 옵션을 지정하십시오. 빌드 도커파일 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 Dockerfile입니다.

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

컨테이너 이미지를 빌드하기 위한 소스 코드가 들어 있는 개인 저장소에 액세스하기 위한 자격 증명을 포함하는 SSH 본인확인정보의 이름입니다. 이 SSH 비밀번호를 만들려면 secret create --format SSH 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. 이 옵션은 --build-source 옵션이 Git 리포지토리의 URL 로 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 medium입니다.

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

Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예: https://github.com/IBM/CodeEngine 또는 .). 이 값은 선택사항입니다.

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

이미지를 빌드하는 데 사용할 전략입니다. 유효값은 dockerfilebuildpacks입니다. 빌드 전략 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 명시되지 않은 경우, --build-source 가 지정되어 있고 소스 코드가 로컬 컴퓨터에 있는 경우 빌드 전략은 Code Engine 에 따라 결정됩니다. 이 값은 선택사항입니다. 기본값은 dockerfile입니다.

--build-timeout, --bto

빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 시간 초과 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 600입니다.

--cluster-local, --cl

프로젝트 전용 엔드포인트를 사용하여 애플리케이션을 배치합니다. 프로젝트 전용 엔드포인트를 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 동일한 프로젝트에서 실행 중인 다른 Code Engine 컴포넌트에서만 네트워크 액세스가 가능합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--command, --cmd, -c

애플리케이션에 대한 명령을 설정합니다. --command 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--concurrency, --cn

동시에 처리할 수 있는 인스턴스당 최대 요청 수입니다. 이 값은 선택사항입니다. 기본값은 100입니다.

--concurrency-target, --ct

하나 이상의 추가 인스턴스가 작성되는 인스턴스당 동시 요청의 임계값입니다. 동시 요청 수를 기준으로 인스턴스를 스케일링 업하려면 이 값을 사용하십시오. --concurrency-target이 지정되지 않은 경우 이 옵션은 기본적으로 --concurrency 옵션의 값으로 설정됩니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--cpu

애플리케이션 인스턴스에 대해 설정된 CPU 양입니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 1입니다.

--env, -e

애플리케이션의 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 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

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 또는 --mount-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret, --mount-secret 또는 --registry-secret 옵션을 사용하여 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--image, -i

이 애플리케이션에 사용되는 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. REGISTRY를 지정하지 않으면 기본값은 docker.io입니다. TAG를 지정하지 않으면 기본값은 latest입니다. --build-source 옵션을 지정하지 않은 경우 image 옵션은 필수입니다. 이 값은 선택사항입니다.

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

이 애플리케이션에 사용할 수 있는 최대 인스턴스 수입니다. 이 값을 0으로 설정하면 필요에 따라 애플리케이션이 스케일링됩니다. 애플리케이션 스케일링은 애플리케이션 프로젝트의 리소스 할당량에 따라 인스턴스에 의해서만 제한됩니다. Code Engine의 한계 및 할당량을 참조하십시오. 이 값은 선택사항입니다. 기본값은 10입니다.

--memory, -m

애플리케이션 인스턴스에 대해 설정된 메모리 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 4G입니다.

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

이 애플리케이션에 사용할 수 있는 최소 인스턴스 수입니다. 이 옵션은 필요하지 않을 때 실행 중인 인스턴스가 없도록 하는 데 유용합니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--mount-configmap, --mount-cm

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 애플리케이션 컨테이너의 파일 시스템에 configmap 컨텐츠를 추가하십시오. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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 형식으로 제공하여 애플리케이션 컨테이너의 파일 시스템에 시크릿 컨텐츠를 추가하십시오. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--port, -p

애플리케이션이 청취하는 포트입니다. 형식은 [NAME:]PORT입니다. 여기서 [NAME:]은 선택적입니다. [NAME:]을 지정할 경우 올바른 값은 h2c 또는 http1입니다. [NAME:]을 지정하지 않거나 http1일 경우 포트는 HTTP/1.1을 사용합니다. [NAME:]h2c일 경우 포트는 암호화되지 않은 HTTP/2를 사용합니다. 기본적으로 Code Engine은 앱이 포트 8080에서 수신 연결을 청취한다고 가정합니다. 애플리케이션이 포트 8080 이외의 포트에서 청취해야 하는 경우 포트를 지정하려면 --port를 사용하십시오. 이 값은 선택사항입니다.

--probe-live, --pl

NAME=VALUE 형식으로 이 애플리케이션에 대한 활성 상태 프로브를 구성하십시오. 유효한 NAME 옵션은 다음과 같습니다: type, port, path, interval, initial-delay, timeout, failure-threshold 입니다. 이 옵션은 여러 번 지정할 수 있습니다. type 속성은 필수이며 유효한 값은 tcphttp 입니다. 예: --probe-live type=tcp --probe-live port=8080. 프로브 작업에 대한 자세한 내용은 프로브 작업에 대한 자세한 내용은 앱에 대한 프로브 구성을 참조하세요. 이 값은 선택사항입니다.

--probe-ready, --pr

NAME=VALUE 형식으로 이 애플리케이션에 대한 준비 상태 프로브를 구성하십시오. 유효한 NAME 옵션은 다음과 같습니다: type, port, path, interval, initial-delay, timeout, failure-threshold 입니다. 이 옵션은 여러 번 지정할 수 있습니다. type 속성은 필수이며 유효한 값은 tcphttp 입니다. 예: --probe-ready type=tcp --probe-ready port=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, readerwriter를 사용할 수 있습니다. Kubernetes Config Context 명령으로 결정될 수 있는 project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다.

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

이 애플리케이션의 컨테이너에 컴퓨팅 리소스 토큰을 마운트하도록 설정하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--user, -u

애플리케이션을 실행하는 데 사용되는 사용자 ID(UID)입니다. 이 값은 애플리케이션 Dockerfile 파일에 설정된 사용자 ID를 대체합니다. ID는 컨테이너의 운영 체제 요구사항을 준수해야 합니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--visibility, -v

애플리케이션에 대한 가시성입니다. 유효한 값은 public, privateproject 입니다. 가시성을 public으로 설정하면 앱이 공용 인터넷 또는 Code Engine 프로젝트 내의 컴포넌트로부터 요청을 수신할 수 있습니다. 가시성을 private으로 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 가상 사설 엔드포인트(VPE)를 사용하는 다른 IBM Cloud 또는 동일한 프로젝트에서 실행 중인 다른 Code Engine 컴포넌트에서만 네트워크 액세스가 가능합니다. 프로젝트에서 애플리케이션 비공개 가시성을 지원하는 경우에만 가시성을 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이 표시됩니다.

ibmcloud ce application delete

애플리케이션을 삭제하십시오.

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

명령 옵션

--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'

ibmcloud ce application events

애플리케이션 인스턴스의 시스템 이벤트를 표시합니다. 시스템 이벤트는 최대 60분까지 유지됩니다.

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

명령 옵션

--application, --app, -a, --name, -n
지정된 애플리케이션의 모든 인스턴스에 대한 이벤트를 표시합니다. --instance를 지정하지 않은 경우에는 이 값이 필수입니다.
--instance, -i
특정 애플리케이션 인스턴스의 이름입니다. 인스턴스 이름을 찾으려면 app get 명령을 사용하십시오. --application을 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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
    [...]

ibmcloud ce application get

애플리케이션 세부사항을 표시합니다.

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

명령 옵션

--name, -n
애플리케이션의 이름. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSION, jsonpath-as-json=JSONPATH_EXPRESSION, url, project-url입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce application list

프로젝트에 있는 모든 애플리케이션을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce application logs

애플리케이션 인스턴스의 로그를 표시합니다.

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

명령 옵션

--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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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/

ibmcloud ce application restart

실행 중인 애플리케이션 인스턴스를 다시 시작합니다.

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

명령 옵션

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

ibmcloud ce application unbind

애플리케이션에서 IBM Cloud 서비스 인스턴스 바인드 해제

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

명령 옵션

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

ibmcloud ce application update

애플리케이션을 업데이트합니다. 애플리케이션을 업데이트하면 개정이 작성됩니다. 애플리케이션을 호출하면 트래픽이 개정으로 라우팅됩니다.

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

명령 옵션

--name, -n

애플리케이션의 이름. 이 값은 필수입니다.

--argument, --arg, -a

애플리케이션에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 선택사항입니다.

--arguments-clear, --ac

애플리케이션 인수를 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--build-clear, --bc

이 애플리케이션에서 빌드의 연관을 제거하십시오. '빌드 지우기' 옵션은 앱에 현재 연결된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. 빌드 커밋 옵션은 ‘ --build-source ’ 옵션이 이 app update 명령어에서 Git 저장소의 URL 로 설정되어 있거나, 현재 애플리케이션에 Git 저장소 소스에서 연결된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다.

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

가져오기를 위해 소스 저장소에서 커미트, 태그 또는 분기를 지웁니다. 애플리케이션에 현재 연관된 빌드가 있는 경우, commit clear 옵션을 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

빌드팩 파일 또는 Dockerfile이 포함되어 있는 저장소의 디렉토리입니다. --build-source 옵션이 이 app update 명령에 설정되어 있거나 애플리케이션에 현재 연관된 빌드가 있는 경우 build context directory 옵션이 허용됩니다. 이 값은 선택사항입니다.

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

Dockerfile의 경로입니다. 이름이 Dockerfile이 아닌 경우에만 이 옵션을 지정하십시오. 이 app update 명령어에서 --build-source 옵션이 설정되어 있거나, 해당 애플리케이션에 현재 연관된 빌드가 있는 경우에만 build dockerfile 옵션이 허용됩니다. 이 값은 선택사항입니다. 기본값은 Dockerfile입니다.

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

컨테이너 이미지를 빌드하기 위한 소스 코드가 들어 있는 개인 저장소에 액세스하기 위한 자격 증명을 포함하는 SSH 본인확인정보의 이름입니다. 이 SSH 비밀번호를 만들려면 secret create --format SSH 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. 이 옵션은 --build-source 옵션이 이 application update 명령어에서 Git 저장소의 URL 로 설정되어 있거나, 현재 애플리케이션에 Git 저장소 소스에서 생성된 빌드가 연결되어 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다.

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

SSH 본인확인정보를 지웁니다. 현재 애플리케이션에 연관된 빌드가 있는 경우 이 옵션을 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 이 app update 명령어에서 ‘ --build-source ’ 옵션이 설정되어 있거나, 해당 애플리케이션에 현재 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 medium입니다.

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

Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예: https://github.com/IBM/CodeEngine 또는 .). 이 값은 선택사항입니다.

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

이미지를 빌드하는 데 사용할 전략입니다. 유효값은 dockerfilebuildpacks입니다. 빌드 전략 옵션은 이 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 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--commands-clear, --cc

애플리케이션 명령을 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--concurrency, --cn

동시에 처리할 수 있는 인스턴스당 최대 요청 수입니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--concurrency-target, --ct

하나 이상의 추가 인스턴스가 작성되는 인스턴스당 동시 요청의 임계값입니다. 동시 요청 수를 기준으로 인스턴스를 스케일링 업하려면 이 값을 사용하십시오. --concurrency-target이 지정되지 않은 경우 이 옵션은 기본적으로 --concurrency 옵션의 값으로 설정됩니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--cpu

애플리케이션 인스턴스에 대해 설정된 CPU 양입니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 0입니다.

--env, -e

애플리케이션의 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 key1에 대해 myKey 환경 변수를 추가하려면 configmapName:myKey=key1 값을 사용하십시오.

이 값은 선택사항입니다.

--env-from-configmap-rm, --env-cm-rm
configmap 이름을 사용하여 전체 configmap에 대한 환경 변수 참조를 제거합니다. configmap에 대한 개별 키 참조를 제거하려면 --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

configmap 또는 시크릿에서 키-값 쌍의 키에 대한 환경 변수 참조를 제거합니다. 개별 키 참조 및 리터럴 값을 제거하려면 키 이름을 지정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.

--ephemeral-storage, --es

애플리케이션 인스턴스에 대해 설정할 임시 스토리지 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 이 값은 선택사항입니다.

--force, -f

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 또는 --mount-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret, --mount-secret 또는 --registry-secret 옵션을 사용하여 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--image, -i

이 애플리케이션에 사용되는 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. 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

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 애플리케이션 컨테이너의 파일 시스템에 configmap 컨텐츠를 추가하십시오. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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

configmap 또는 시크릿이 마운트된 디렉토리를 지정하여 애플리케이션 컨테이너의 파일 시스템에서 configmap 또는 시크릿의 컨텐츠를 제거하십시오. --mount-rm 옵션당 하나의 마운트 디렉토리를 지정하십시오. 예를 들면, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b입니다. 이 값은 선택사항입니다.

--mount-secret, --mount-sec

마운트 디렉토리와 시크릿 이름을 MOUNT_DIRECTORY=SECRET_NAME 형식으로 제공하여 애플리케이션 컨테이너의 파일 시스템에 시크릿 컨텐츠를 추가하십시오. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--port, -p

애플리케이션이 청취하는 포트입니다. 형식은 [NAME:]PORT입니다. 여기서 [NAME:]은 선택적입니다. [NAME:]을 지정할 경우 올바른 값은 h2c 또는 http1입니다. [NAME:]을 지정하지 않거나 http1일 경우 포트는 HTTP/1.1을 사용합니다. [NAME:]h2c일 경우 포트는 암호화되지 않은 HTTP/2를 사용합니다. 기본적으로 Code Engine은 앱이 포트 8080에서 수신 연결을 청취한다고 가정합니다. 애플리케이션이 포트 8080 이외의 포트에서 청취해야 하는 경우 포트를 지정하려면 --port를 사용하십시오. 이 값은 선택사항입니다.

--probe-live, --pl

NAME=VALUE 형식으로 이 애플리케이션에 대한 활성 상태 프로브를 구성하십시오. 유효한 NAME 옵션은 다음과 같습니다: type, port, path, interval, initial-delay, timeout, failure-threshold 입니다. 이 옵션은 여러 번 지정할 수 있습니다. type 속성은 필수이며 유효한 값은 tcphttp 입니다. 예: --probe-live type=tcp --probe-live port=8080. 프로브 작업에 대한 자세한 내용은 프로브 작업에 대한 자세한 내용은 앱에 대한 프로브 구성을 참조하세요. 이 값은 선택사항입니다.

--probe-live-clear, --plr

활성 상태 프로브를 제거하십시오. 이 옵션은 앱에 현재 활성도 프로브가 있는 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--probe-ready, --pr

NAME=VALUE 형식으로 이 애플리케이션에 대한 준비 상태 프로브를 구성하십시오. 유효한 NAME 옵션은 다음과 같습니다: type, port, path, interval, initial-delay, timeout, failure-threshold 입니다. 이 옵션은 여러 번 지정할 수 있습니다. type 속성은 필수이며 유효한 값은 tcphttp 입니다. 예: --probe-ready type=tcp --probe-ready port=8080. 프로브 작업에 대한 자세한 내용은 프로브 작업에 대한 자세한 내용은 앱에 대한 프로브 구성을 참조하세요. 이 값은 선택사항입니다.

--probe-ready-reset, --prr

준비 상태 프로브를 기본 구성으로 재설정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--rebuild

소스로부터 이미지를 다시 빌드합니다. 애플리케이션에 현재 연관된 빌드가 있는 경우 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, readerwriter를 사용할 수 있습니다. 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, privateproject 입니다. 가시성을 public으로 설정하면 앱이 공용 인터넷 또는 Code Engine 프로젝트 내의 컴포넌트로부터 요청을 수신할 수 있습니다. 가시성을 private으로 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 가상 사설 엔드포인트(VPE)를 사용하는 다른 IBM Cloud 또는 동일한 프로젝트에서 실행 중인 다른 Code Engine 컴포넌트에서만 네트워크 액세스가 가능합니다. 프로젝트에서 애플리케이션 비공개 가시성을 지원하는 경우에만 가시성을 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

베타 명령

Code Engine 베타 명령은 일반적으로 사용할 수 없습니다. 이 명령 그룹은 일부 얼리어답터들이 쉽게 탐색할 수 있도록 잠재적인 미래 기능에 대한 액세스를 제공합니다.

명령을 사용하려면 프로젝트beta의 컨텍스트 내에 있어야 합니다.

beta 명령에 대한 CLI 도움말을 보려면 ibmcloud ce beta -h``을 실행하십시오.

ibmcloud ce beta

Code Engine 베타 명령은 일반적으로 사용할 수 없습니다. 이 명령 그룹은 일부 얼리어답터들이 쉽게 탐색할 수 있도록 잠재적인 미래 기능에 대한 액세스를 제공합니다.

명령을 사용하려면 프로젝트beta의 컨텍스트 내에 있어야 합니다.

beta 명령에 대한 CLI 도움말을 보려면 ibmcloud ce beta -h``을 실행하십시오.

ibmcloud ce beta COMMAND

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.

Build 명령

빌드 또는 이미지 빌드는 소스 코드에서 컨테이너 이미지를 작성하는 데 사용할 수 있는 메커니즘입니다. Code Engine은 Dockerfile 및 클라우드 네이티브 빌드팩에서의 빌드를 지원합니다. 빌드 구성을 작성, 업데이트 및 삭제하고 세부사항을 표시하려면 build 명령을 사용하십시오. 빌드 구성을 작성한 후에는 빌드 구성에 따라 buildrun 명령을 한 개 이상 제출할 수 있습니다.

명령을 사용하려면 프로젝트build의 컨텍스트 내에 있어야 합니다.

빌드 작업에 대한 자세한 정보는 컨테이너 이미지 빌드를 참조하십시오.

build 명령에 build 또는 bd를 사용할 수 있습니다. build 명령에 대한 CLI 도움말을 보려면 ibmcloud ce build -h를 실행하십시오.

ibmcloud ce build create

빌드를 작성합니다.

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

명령 옵션

-n, --name

빌드 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 63자 이하여야 하며 소문자 영숫자 및 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--build-type, --bt
빌드 유형입니다. 유효값은 gitlocal입니다. 빌드 유형이 local인 경우 --source, --commit--git-repo-secret 옵션은 올바르지 않습니다. 이 값은 선택사항입니다. 기본값은 git입니다.
--commit, --cm, --revision

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. commit 옵션은 --build-type 옵션이 git인 경우 허용되고, --build-type 옵션이 local인 경우 허용되지 않습니다. 이 값은 선택사항입니다.

--context-dir, --cdr

빌드팩 파일 또는 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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--registry-secret, --rs

레지스트리에 액세스하는 데 사용되는 레지스트리 키입니다. registry create 명령을 실행하여 레지스트리 시크릿을 추가할 수 있습니다. 이 값은 선택사항입니다.

--size, --sz

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 이 값은 선택사항입니다. 기본값은 medium입니다.

--source, --src

소스 코드가 포함된 Git 저장소의 URL입니다(예: https://github.com/IBM/CodeEngine). source 옵션은 --build-type 옵션이 git인 경우 필수이며, --build-type 옵션이 local인 경우에는 허용되지 않습니다. 이 값은 선택사항입니다.

--strategy, --str

이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은 dockerfilebuildpacks 입니다. 함수의 경우, 유효한 값은 codebundle-[RUNTIME-ID] 형식을 따릅니다. 예를 들어 런타임 ID가 nodejs-24 인 함수에 대한 코드 번들을 빌드하려는 경우 codebundle-nodejs-24 을 빌드 전략으로 사용합니다. ibmcloud ce fn runtimes 명령을 실행하여 지원되는 함수 런타임의 ID를 찾을 수 있습니다. 이 값은 선택사항입니다. 기본값은 dockerfile입니다.

--timeout, --to

빌드 성공 또는 실패 전 경과 시간(초)입니다. 이 값은 선택사항입니다. 기본값은 600입니다.

다음 예에서는 helloworld-build에 있는 소스 Dockerfile에서 https://github.com/IBM/CodeEngine 전략 및 hello 크기의 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

ibmcloud ce build delete

빌드를 삭제합니다.

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

명령 옵션

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

ibmcloud ce build get

빌드 세부사항을 표시합니다.

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

명령 옵션

--name, -n
빌드 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce build list

프로젝트에 있는 모든 빌드를 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce build update

빌드를 업데이트합니다.

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

명령 옵션

--name, -n
빌드 이름입니다. 이 값은 필수입니다.
--commit, --cm, --revision
가져올 소스 저장소의 커미트, 태그 또는 분기입니다. 이 값은 선택사항입니다.
--commit-clear, --cmc
가져오기를 위해 소스 저장소에서 커미트, 태그 또는 분기를 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--context-dir, --cdr
빌드팩 파일 또는 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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--registry-secret, --rs
레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.
--size, --sz
사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 이 값은 선택사항입니다.
--source, --src
소스 코드가 포함된 Git 저장소의 URL입니다(예: https://github.com/IBM/CodeEngine). 이 값은 선택사항입니다.
--strategy, --str
이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은 dockerfilebuildpacks 입니다. 함수의 경우, 유효한 값은 codebundle-[RUNTIME-ID] 형식을 따릅니다. 예를 들어 런타임 ID가 nodejs-24 인 함수에 대한 코드 번들을 빌드하려는 경우 codebundle-nodejs-24 을 빌드 전략으로 사용합니다. 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

Buildrun 명령

빌드 또는 이미지 빌드는 소스 코드에서 컨테이너 이미지를 작성하는 데 사용할 수 있는 메커니즘입니다. Code Engine은 Dockerfile 및 클라우드 네이티브 빌드팩에서의 빌드를 지원합니다. 빌드 실행을 제출 및 삭제하고 세부사항을 표시하려면 buildrun 명령을 사용하십시오.

명령을 사용하려면 프로젝트buildrun의 컨텍스트 내에 있어야 합니다.

빌드 및 빌드 실행 작업에 대한 자세한 정보는 컨테이너 이미지 빌드를 참조하십시오.

buildrun 명령에 buildrun 또는 br를 사용할 수 있습니다. buildrun 명령에 대한 CLI 도움말을 보려면 ibmcloud ce br -h를 실행하십시오.

ibmcloud ce buildrun cancel

빌드 실행을 취소합니다.

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

명령 옵션

--name, -n
빌드 실행의 이름입니다. 이 값은 필수입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce buildrun cancel --name mybuildrun

출력 예

Canceling build run 'mybuildrun'...
OK

ibmcloud ce buildrun delete

빌드 실행을 삭제합니다.

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

명령 옵션

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

ibmcloud ce buildrun events

빌드 실행의 시스템 이벤트를 표시합니다. 시스템 이벤트는 최대 60분까지 유지됩니다.

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

명령 옵션

--buildrun, -b, --br, --name, -n
빌드 실행의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce buildrun get

빌드 실행의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
빌드 실행의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce buildrun list

프로젝트에 있는 모든 빌드 실행을 나열합니다.

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

명령 옵션

--build, -b
지정된 빌드에서만 빌드 실행을 표시하려면 이 옵션을 사용하십시오. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce buildrun logs

빌드 실행의 로그를 표시합니다.

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

명령 옵션

--buildrun, -b, --br, --name, -n
빌드 실행의 이름입니다. 이 값은 필수입니다.
--follow, -f
빌드 실행의 로그를 따릅니다. 이 옵션을 사용하여 빌드 실행의 로그를 스트리밍할 수 있습니다. --follow 옵션을 지정하는 경우 Ctrl+C를 입력하여 이 로그 명령을 종료해야 합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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"}}

ibmcloud ce buildrun submit

빌드 실행을 제출합니다.

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

명령 옵션

--build, -b, --bd

사용할 빌드 구성의 이름입니다. 이 값은 선택사항입니다.

--commit, --cm, --revision

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. --source 옵션이 Git 저장소의 URL로 설정된 경우 build commit 옵션이 허용되고, --source 옵션이 Git 저장소의 URL로 설정되지 않은 경우 허용되지 않습니다. 이 값은 선택사항입니다.

--context-dir, --cdr

빌드팩 파일 또는 Dockerfile이 포함되어 있는 저장소의 디렉토리입니다. --build 옵션이 설정되지 않은 경우 빌드 컨텍스트 디렉토리 옵션이 허용되고 --build 옵션이 설정된 경우 허용되지 않습니다. 이 값은 선택사항입니다.

--dockerfile, --df

Dockerfile의 경로입니다. 이름이 Dockerfile이 아닌 경우에만 이 옵션을 지정하십시오. --build 옵션이 설정되지 않은 경우 build dockerfile 옵션이 허용되고 --build 옵션이 설정된 경우 허용되지 않습니다. 이 값은 선택사항입니다. 기본값은 Dockerfile입니다.

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

컨테이너 이미지를 빌드하기 위한 소스 코드가 들어 있는 개인 저장소에 액세스하기 위한 자격 증명을 포함하는 SSH 본인확인정보의 이름입니다. 이 SSH 비밀번호를 만들려면 secret create --format SSH 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. 이 옵션은 --build-source 옵션이 Git 리포지토리의 URL 로 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

--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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--registry-secret, --rs

레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. --build 옵션이 설정되어 있지 않은 경우 레지스트리 비밀 옵션이 허용되며, --build 옵션이 설정되어 있는 경우 허용 되지 않습니다. 이 값은 선택사항입니다.

--service-account, --sa

서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인 manager, none, readerwriter를 사용할 수 있습니다. Kubernetes Config Context 명령으로 결정될 수 있는 project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다.

--size, --sz

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. --build 옵션이 설정되어 있지 않은 경우 build size 옵션이 허용되며, --build 옵션이 설정되어 있는 경우 허용 되지 않습니다. 이 값은 선택사항입니다. 기본값은 medium입니다.

--source, --src

Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예: https://github.com/IBM/CodeEngine 또는 .). --build 옵션이 설정된 경우, 관련 빌드의 --build-type 옵션이 local이면 source 옵션이 필수이고 관련 빌드의 --build-type 옵션이 git이면 허용되지 않습니다. --build 옵션이 설정되지 않은 경우 source 옵션은 선택사항입니다. 이 값은 선택사항입니다. 기본값은 .입니다.

--strategy, --str

이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은 dockerfilebuildpacks 입니다. 함수의 경우, 유효한 값은 codebundle-[RUNTIME-ID] 형식을 따릅니다. 예를 들어 런타임 ID가 nodejs-24 인 함수에 대한 코드 번들을 빌드하려는 경우 codebundle-nodejs-24 을 빌드 전략으로 사용합니다. 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

Configmap 명령

configmap은 민감하지 않은 데이터 정보를 배치에 포함하는 방법을 제공합니다. ConfigMap의 값을 환경 변수로 참조하면, 배포에서 특정 정보를 분리하여 앱, 작업 또는 함수의 이식성을 유지할 수 있습니다. configmap에는 키-값 쌍의 정보가 포함되어 있습니다. configmap을 작성, 업데이트 및 삭제하고 세부사항을 표시하려면 configmap 명령을 사용하십시오.

명령을 사용하려면 프로젝트configmap의 컨텍스트 내에 있어야 합니다.

구성 맵 작업에 대한 자세한 내용은 구성 맵 작업을 참조하세요.

configmap 명령에 configmap 또는 cm를 사용할 수 있습니다. configmap 명령에 대한 CLI 도움말을 보려면 ibmcloud ce configmap -h를 실행하십시오.

ibmcloud ce configmap create

configmap을 작성합니다.

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

명령 옵션

-n, --name

configmap의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--from-env-file, -e
KEY=VALUE 형식과 일치하는 하나 이상의 행이 포함된 파일에서 configmap을 작성합니다. 파일 경로를 값으로 제공해야 합니다. 지정된 파일의 각 행은 키-값 쌍으로 추가됩니다. 지정된 파일에서 비어 있거나 #으로 시작하는 행은 무시됩니다. --from-literal 또는 --from-file을 지정하지 않은 경우에는 이 값이 필수입니다.
--from-file, -f

파일에서 configmap을 작성합니다. 파일 경로를 값으로 제공해야 합니다. --from-literal 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다.

--from-literal, -l

키-값 쌍에서 configmap을 작성합니다. KEY=VALUE 형식이어야 합니다. --from-file 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

다음 예에서는 configmap-fromliteralcolor=blue라는 두 개의 키 쌍 값을 사용하여 size=large이라는 configmap을 작성합니다.

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 예

다음 예에서는 여러 파일의 값을 사용하여 configmap-fromfile이라는 configmap을 작성합니다.

ibmcloud ce configmap create --name configmap-fromfile  --from-file ./color.txt --from-file ./size.txt
여러 파일의 값을 사용하는 configmap의 출력 예
Creating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

ibmcloud ce configmap delete

configmap을 삭제합니다.

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

명령 옵션

--name, -n
configmap의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

출력 예

Deleting Configmap 'configmap-fromliteral'...
OK

ibmcloud ce configmap get

configmap의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
configmap의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce configmap list

프로젝트에 있는 모든 configmap을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce configmap list

출력 예

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

ibmcloud ce configmap update

configmap을 업데이트합니다.

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

명령 옵션

--name, -n
configmap의 이름입니다. 이 값은 필수입니다.
--from-env-file, -e
KEY=VALUE 형식과 일치하는 하나 이상의 행이 포함된 파일에서 configmap을 업데이트합니다. 파일 경로를 값으로 제공해야 합니다. 지정된 파일의 각 행은 키-값 쌍으로 추가됩니다. 지정된 파일에서 비어 있거나 #으로 시작하는 행은 무시됩니다. --from-literal 또는 --from-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다.
--from-file, -f
파일에서 configmap을 업데이트합니다. 파일 경로를 값으로 제공해야 합니다. --from-literal 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다.
--from-literal, -l
키-값 쌍에서 configmap을 업데이트합니다. KEY=VALUE 형식이어야 합니다. --from-file 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--rm
키 이름을 지정하여 configmap에서 개별 키-값 쌍을 제거합니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.

다음 예에서는 사용자 이름 및 비밀번호 값 쌍을 사용하여 configmap-fromliteral이라는 configmap을 업데이트합니다.

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 예

다음 예에서는 파일의 값을 사용하여 configmap-fromfile이라는 configmap을 업데이트합니다.

ibmcloud ce configmap update --name configmap-fromfile  --from-file ./username.txt --from-file ./password.txt
한 파일의 값을 사용하는 configmap의 출력 예
Updating configmap 'configmap-fromfile'...
OK
Run 'ibmcloud ce configmap get -n configmap-fromfile' to see more details.

연결 명령

IBM Cloud® Code Engine 연결 기능은 Code Engine 프로젝트에서 워크로드의 다양한 네트워크 연결 측면을 구성할 수 있도록 지원합니다.

  • 아웃바운드 연결에 허용되는 대상 IP 주소 범위를 지정하여 도달 가능한 엔드포인트를 정의하세요
  • IBM Cloud VPC 비공개 경로 서비스에 연결합니다.
  • 보안 그룹을 포함한 VPC 서브넷 풀 참조를 정의하여 Code Engine 플릿 워커의 네트워크 배치를 구성하세요.

명령을 사용하려면 프로젝트connectivity의 컨텍스트 내에 있어야 합니다.

connectivity 명령에 connectivity 또는 conn를 사용할 수 있습니다. connectivity 명령에 대한 CLI 도움말을 보려면 ibmcloud ce connectivity -h를 실행하십시오.

ibmcloud ce connectivity outbound

IBM Cloud® Code Engine 아웃바운드 연결 기능은 Code Engine 프로젝트에 대해 도달 가능한 엔드포인트를 정의하는 기능을 지원합니다.

  • 아웃바운드 연결에 허용된 대상 IP 주소 범위를 CIDR 표기법으로 사용합니다.
  • Code Engine 콘솔 또는 CLI를 사용하여 Code Engine 프로젝트를 IBM Cloud VPC 비공개 경로 서비스에 연결합니다.

명령을 사용하려면 프로젝트connectivity outbound의 컨텍스트 내에 있어야 합니다.

아웃바운드 연결 명령으로 작업하는 방법에 대한 자세한 내용은 Code Engine 에서 아웃바운드 연결 명령으로 작업하기를 참조하세요.

connectivity outbound 명령에 connectivity outbound 또는 conn outbound를 사용할 수 있습니다. connectivity outbound 명령에 대한 CLI 도움말을 보려면 ibmcloud ce connectivity outbound -h를 실행하십시오.

ibmcloud ce connectivity outbound COMMAND

ibmcloud ce connectivity outbound create

허용되는 아웃바운드 목적지를 작성합니다.

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

명령 옵션

--n, --cidr-name, --name
필수. 허용되는 아웃바운드 목적지의 이름입니다. 이 값은 필수입니다.
--cidr, -c
CIDR 형식의 유효한 IP 주소 범위를 입력하십시오(예: 1.2.3.0/24). 이 값은 선택사항입니다.
--force, -f
확인 없이 작성을 강제 실행합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--format, --fo
허용되는 아웃바운드 목적지의 형식입니다. 유효한 값은 [cidr, cidr_block, pps, private_path_gateway_service] 입니다. 지정하지 않으면 기본값은 cidr 입니다. 이 값은 선택사항입니다. 기본값은 cidr_block입니다.
--pps-crn, --private-path-service-crn
연결하려는 대상 개인용 경로 서비스의 CRN을 제공하십시오. 이 값은 선택사항입니다.
--pps-isolation-policy, --pip
개인용 경로 연결 격리 정책. 유효한 값은 [dedicated, shared] 입니다. 명시되지 않은 경우, 기본값은 shared 입니다. 이 값은 선택사항입니다. 기본값은 shared입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

허용된 아웃바운드 목적지를 삭제합니다.

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

명령 옵션

--n, --cidr-name, --name
필수. 허용되는 아웃바운드 목적지의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

허용되는 아웃바운드 목적지의 세부사항을 표시합니다.

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

명령 옵션

--n, --cidr-name, --name
필수. 허용되는 아웃바운드 목적지의 이름입니다. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 유효한 값은 'json', 'yaml', 'jsonpath=JSONPATH_EXPRESSION' 및 'jsonpath-as-json=JSONPATH_EXPRESSION'입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

허용되는 모든 아웃바운드 목적지를 나열합니다.

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

명령 옵션

--format
허용되는 아웃바운드 목적지의 표시를 지정된 형식으로 제한하십시오. 쉼표로 구분된 목록으로 하나 이상의 형식을 제공하십시오. 유효한 값은 [cidr, cidr_block, pps, private_path_gateway_service] 입니다. 이 값은 선택 사항 입니다. 기본값은 cidr_block,private_path_service_gateway입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

허용되는 아웃바운드 목적지를 업데이트합니다.

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

명령 옵션

--n, --cidr-name, --name
필수. 허용되는 아웃바운드 목적지의 이름입니다. 이 값은 필수입니다.
--cidr, -c
CIDR 형식의 유효한 IP 주소 범위를 입력하십시오(예: 1.2.3.0/24). 이 값은 선택사항입니다.
--force, -f
확인 없이 업데이트를 강제 실행합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--pps-isolation-policy, --pip
개인용 경로 연결 격리 정책. 유효한 값은 [dedicated, shared] 입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

ibmcloud ce connectivity subnetpool

IBM Cloud® Code Engine 서브넷 풀 연결 기능은 보안 그룹을 포함한 VPC 서브넷 풀 참조를 관리할 수 있도록 지원합니다. 플릿은 항상 VPC에 연결되며, 플릿을 만들 때 서브넷 풀을 참조하여 Code Engine 플릿 워커를 어느 네트워크 영역에 배포할지 지정할 수 있습니다. 서브넷 풀을 생성하여 워크로드를 처리할 VPC 서브넷과 가용성 영역을 지정합니다. 예를 들어, 영역 eu-de-1 에 단일 서브넷이 있는 서브넷 풀을 만들거나 eu-de 에 3개의 영역 모두에 걸쳐 여러 개의 서브넷이 있는 서브넷 풀을 만들 수 있습니다. 또한 워크로드를 연결할 보안 그룹을 지정할 수도 있습니다.

IBM Cloud® Virtual Private Cloud(VPC)는 고객 계정에 연결된 가상 네트워크입니다. 가상 인프라 및 네트워크 트래픽 세분화를 세부적으로 제어하여 동적으로 확장할 수 있는 기능을 갖춘 클라우드 보안을 제공합니다. VPC의 서브넷은 비공개 연결을 제공합니다. VPC의 서브넷은 선택적 퍼블릭 게이트웨이를 통해 공용 인터넷에 연결할 수 있습니다. 보안 그룹을 사용하여 네트워크 트래픽을 제어함으로써 VPC와 워크로드를 안전하게 보호할 수 있습니다. 자세한 내용은 네트워킹 정보VPC의 보안 을 참조하세요.

명령을 사용하려면 프로젝트connectivity subnetpool의 컨텍스트 내에 있어야 합니다.

서브넷풀 연결 명령으로 작업하는 방법에 대한 자세한 내용은 Code Engine 에서 서브넷풀 연결로 작업하기 를 참조하세요.

connectivity subnetpool 명령에 connectivity 또는 conn를 사용할 수 있습니다. connectivity subnetpool 명령에 대한 CLI 도움말을 보려면 ibmcloud ce connectivity subnetpool -h 을 실행하세요.

ibmcloud ce connectivity subnetpool COMMAND

ibmcloud ce connectivity subnetpool create

서브넷 풀을 작성합니다.

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

명령 옵션

--name, -n
필수. 서브넷 풀의 이름. 프로젝트 내에서 고유한 이름을 사용하십시오. 이 값은 필수입니다.
--subnet-crn, --crn
풀에 대해 유효한 서브넷 CRN을 제공하십시오. S1=crn:v1:example 형식이어야 함 이 값은 필수입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--security-group-crn, --sg-crn
풀에 대해 유효한 보안 그룹 CRN을 제공하십시오. 이 값은 선택사항입니다.

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

출력 예

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

ibmcloud ce connectivity subnetpool delete

서브넷 풀을 삭제합니다.

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

명령 옵션

--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--id
서브넷 풀의 ID. 이 값은 선택사항입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--name, -n
서브넷 풀의 이름. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

출력 예

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

ibmcloud ce connectivity subnetpool get

서브넷 풀의 세부사항을 표시합니다.

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

명령 옵션

--id
서브넷 풀의 ID. 이 값은 선택사항입니다.
--name, -n
서브넷 풀의 이름. 이 값은 선택사항입니다.
--output, -o
결과 형식입니다. 유효한 값은 'json', 'yaml', 'jsonpath=JSONPATH_EXPRESSION' 및 'jsonpath-as-json=JSONPATH_EXPRESSION'입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

출력 예

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

ibmcloud ce connectivity subnetpool list

프로젝트의 모든 서브넷 풀을 나열합니다.

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

명령 옵션

--output, -o
결과 형식입니다. 유효한 값은 'json', 'yaml', 'jsonpath=JSONPATH_EXPRESSION' 및 'jsonpath-as-json=JSONPATH_EXPRESSION'입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효한 값은 'name'과 'age'입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce connectivity subnetpool list

출력 예

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

도메인 매핑 명령

도메인 매핑을 사용하면 프로젝트 내의 Code Engine 애플리케이션 및 함수에 대한 URL 경로를 제공합니다. Code Engine 를 사용하면, 기본적으로 애플리케이션을 배포하거나 함수를 생성할 때마다 이러한 매핑이 자동으로 생성됩니다. 하지만 Code Engine 를 사용하여 사용자 지정 도메인( URL )을 Code Engine 애플리케이션이나 함수에 매핑함으로써, 해당 도메인으로 들어오는 요청을 애플리케이션이나 함수로 라우팅할 수 있습니다. domainmapping 명령어를 사용하여 도메인 매핑을 생성, 세부 정보 확인, 업데이트 및 삭제할 수 있습니다.

Code Engine 에서 사용자 지정 도메인 매핑을 설정하면 프로젝트에서 FQDN(정규화된 도메인 이름)과 Code Engine 애플리케이션 간의 1-to-1 매핑을 정의하게 됩니다. CLI에서 사용자 지정 도메인 매핑을 구성하고 작업하려면 domainmapping 명령을 사용하세요.

명령을 사용하려면 프로젝트domainmapping의 컨텍스트 내에 있어야 합니다.

도메인 매핑 작업에 대한 자세한 내용은 앱에 대한 사용자 지정 도메인 매핑 구성을 참조하세요.

domainmapping 명령에 domainmapping 또는 dm를 사용할 수 있습니다. domainmapping 명령에 대한 CLI 도움말을 보려면 ibmcloud ce domainmapping -h를 실행하십시오.

ibmcloud ce domainmapping create

사용자 정의 도메인 맵핑을 작성합니다.

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

명령 옵션

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

ibmcloud ce domainmapping delete

사용자 정의 도메인 맵핑을 삭제합니다.

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

명령 옵션

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

ibmcloud ce domainmapping get

사용자 정의 도메인 맵핑의 세부사항을 표시합니다.

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

명령 옵션

--domain-name, --dn, -n, --name
도메인 매핑의 이름 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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  

ibmcloud ce domainmapping list

프로젝트의 도메인 맵핑을 나열합니다.

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

명령 옵션

--all, -a
사용자 정의 및 시스템 도메인 맵핑을 포함하여 프로젝트의 모든 도메인 맵핑을 표시합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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    

사용자 정의 도메인 매핑과 자동 생성된 시스템 도메인 매핑을 모두 포함하여 애플리케이션의 모든 도메인 매핑 목록을 보려면 --all 옵션과 함께 ibmcloud ce domainmapping list 명령으로 지정합니다.

ibmcloud ce domainmapping update

사용자 정의 도메인 맵핑을 업데이트합니다.

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

명령 옵션

--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'...

실험 명령

Code Engine 실험용 명령은 일반적으로 사용할 수 없습니다. 이 명령 그룹은 일부 얼리어답터들이 쉽게 탐색할 수 있도록 잠재적인 미래 기능에 대한 액세스를 제공합니다.

명령을 사용하려면 프로젝트experimental의 컨텍스트 내에 있어야 합니다.

experimental 명령에 experimental 또는 exp를 사용할 수 있습니다. experimental 명령에 대한 CLI 도움말을 보려면 ibmcloud ce exp -h를 실행하십시오.

ibmcloud ce experimental

Code Engine 실험용 명령은 일반적으로 사용할 수 없습니다. 이 명령 그룹은 일부 얼리어답터들이 쉽게 탐색할 수 있도록 잠재적인 미래 기능에 대한 액세스를 제공합니다.

명령을 사용하려면 프로젝트experimental의 컨텍스트 내에 있어야 합니다.

experimental 명령에 experimental 또는 exp를 사용할 수 있습니다. experimental 명령에 대한 CLI 도움말을 보려면 ibmcloud ce exp -h를 실행하십시오.

ibmcloud ce experimental COMMAND

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.

함대 명령

서버리스 Fleet를 관리합니다.

ibmcloud ce fleet cancel

서버리스 Fleet를 취소하십시오.

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

명령 옵션

--id, --fid, --fleet-id
필수. 서버리스 Fleet의 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  

ibmcloud ce fleet create

서버리스 Fleet를 실행하십시오.

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

명령 옵션

--image, -i
필수. 태스크를 처리하는 데 사용되는 컨테이너 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. REGISTRY를 지정하지 않으면 기본값은 docker.io입니다. TAG를 지정하지 않으면 기본값은 latest입니다. 이 값은 필수입니다.
--tasks-state-store, --ts-state
필수. Fleet의 태스크 상태를 저장하는 영구 데이터 저장소를 지정하십시오. 이 값은 필수입니다.
--argument, --arg, -a
태스크에서 실행할 명령에 필요한 명령 인수를 설정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--command, --cmd, -c
태스크에서 실행할 명령을 설정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--cpu, --cp
태스크에 설정할 CPU의 양입니다. 이 값은 선택사항입니다. 기본값은 1입니다.
--env, -e
태스크에 전달될 환경 변수를 설정하십시오. 이름=값 형식이어야 합니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--env-from-configmap, --env-cm
이 구성 맵에 저장된 키-값 쌍에서 환경 변수를 설정합니다. 전체 구성 맵을 참조하려면 NAME을 제공하고, 각 키에 PREFIX 접두부가 있는 전체 구성 맵을 참조하려면 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
Fleet의 이름입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--registry-secret, --rs
레지스트리 본인확인정보의 이름입니다. 레지스트리 시크릿은 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. ibmcloud ce registry create 를 실행하여 레지스트리 시크릿을 생성합니다. 이 값은 선택사항입니다.
--retrylimit, -r
태스크를 실패로 표시하기 전에 태스크를 재실행할 횟수. 이 값은 선택사항입니다. 기본값은 3입니다.
--subnetpool-id, --spi
Fleet 네트워크 배치에 사용할 서브넷 풀 ID입니다. 이 값은 선택사항입니다.
--subnetpool-name, --spn
Fleet 네트워크 배치에 사용할 서브넷 풀 이름입니다. 이 값은 선택사항입니다.
--task-indexes, --ti
처리할 작업 인덱스를 지정하십시오. 예를 들어, 0,3,6,9, 1-5,7-8,10 등이 있습니다. 색인 항목을 1,000개 이하로 지정하십시오. --tasks 가 지정된 경우 이 옵션을 지정할 수 없습니다. 이 값은 선택사항입니다.
--tasks, --ts
Fleet에서 처리할 태스크 수를 지정하십시오. 작업 사양 옵션이 지정되지 않은 경우, 이 옵션이 사용되며 기본값은 1 입니다.
--tasks-from-cos-bucket, --ts-bucket
COS 버킷 내 파일의 위치를 지정하십시오. 각 파일에 대해 태스크는 Fleet에 의해 처리되어야 합니다. 이 값은 선택사항입니다.
--tasks-from-cos-object, --ts-cos
COS 버킷에 있는 JSONL 파일의 위치를 지정하십시오. 이 파일은 Fleet가 처리할 태스크를 정의합니다. 이 값은 선택사항입니다.
--tasks-from-local-file, --ts-file
로컬 JSONL 파일 위치를 지정하십시오. 이 파일은 Fleet가 처리할 태스크를 정의합니다. 이 값은 선택사항입니다.
--worker-profile, --profile, --prof
지원되는 작업자 프로파일 환경 설정을 제공하십시오. 이 값은 선택사항입니다.

ibmcloud ce fleet create --image icr.io/codeengine/helloworld --subnetpool-name my-pool --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

ibmcloud ce fleet delete

서버리스 Fleet를 삭제합니다.

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

명령 옵션

--id, --fid, --fleet-id
필수. 서버리스 Fleet의 ID입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait, -w
서버리스 Fleet를 삭제하고 Fleet가 삭제될 때까지 기다리십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait-timeout, --wto
서버리스 Fleet가 삭제될 때까지 대기할 시간(초 단위). 이 값은 선택사항입니다. 기본값은 180입니다.

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

출력 예

Deleting serverless fleet...
OK

ibmcloud ce fleet get

서버리스 Fleet의 세부사항을 표시하십시오.

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

명령 옵션

--id, --fid, --fleet-id
필수. 서버리스 Fleet의 ID입니다. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-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 pools:    
    Name:                my-pool-
    Number of subnets:   1  
                         
    Subnet CRN:          crn:v1:bluemix:public:is:eu-de-1:a/abcdefabcdefabcdefabcd1234567890::subnet:1a1a-2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f   
    Security Group CRN:  crn:v1:bluemix:public:is:eu-de:a/abcdefabcdefabcdefabcd1234567890::security-group:2b2b-3c3c3c3c-4d4d-5e5e-6f6f-7g7g7g7g7g7g  
Environment Variables:    
  Type     Name   Value  
  Literal  FOO    bar

ibmcloud ce fleet list

프로젝트의 모든 서버리스 Fleet를 나열하십시오.

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

명령 옵션

--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-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  

ibmcloud ce fleet task

서버리스 Fleet 태스크를 관리합니다.

ibmcloud ce fleet task COMMAND [--quiet]

명령 옵션

--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce fleet task get

서버리스 Fleet 태스크의 세부사항을 표시하십시오.

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

명령 옵션

--fleet-id, --fid
필수. 해당 태스크가 속한 Fleet의 UUID입니다. 이 값은 필수입니다.
--task-id, --tid, --id
필수. 태스크의 UUID. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--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의 모든 태스크를 나열합니다.

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

명령 옵션

--fleet-id, --fid
필수. 해당 태스크가 속한 Fleet의 UUID입니다. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--pagination-token, --pt
이 페이지 매김 토큰부터 시작하는 태스크의 다음 페이지를 표시하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--show-all-columns, --sac
CreatedFinished 열을 추가로 표시합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, --sb
목록을 정렬할 때 사용할 기준 열을 지정합니다. 올바른 값은 id, index, status입니다. 이 값은 선택사항입니다. 기본값은 index입니다.
--status, --st
지정된 상태의 태스크를 표시합니다. 유효한 값은 canceled, failed, pending, runningsucceeded 입니다. 이 값은 선택사항입니다.

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

ibmcloud ce fleet worker

서버리스 Fleet 작업자를 관리합니다.

ibmcloud ce fleet worker COMMAND [--quiet]

명령 옵션

--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce fleet worker delete

서버리스 Fleet 작업자를 삭제하십시오.

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

명령 옵션

--fleet-id, --fid
필수. 해당 작업자가 속한 Fleet의 ID입니다. 이 값은 필수입니다.
--name, -n, --worker-name
필수. 서버리스 Fleet 작업자의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--hard
서버리스 Fleet 작업자를 즉시 삭제합니다. 'hard' 옵션을 지정하지 않으면, 이 작업자가 처리한 'running' 태스크는 최종 상태에 도달할 때까지 계속 처리되며, 그 후에야 작업자가 삭제됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait, -w
서버리스 Fleet 작업자를 삭제하고 작업자가 삭제될 때까지 기다리십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait-timeout, --wto
서버리스 Fleet 작업자가 삭제될 때까지 대기하는 시간(초)입니다. 이 값은 선택사항입니다. 기본값은 180입니다.

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 작업자의 세부사항을 표시하십시오.

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

명령 옵션

--fleet-id, --fid
필수. 해당 작업자가 속한 Fleet의 ID입니다. 이 값은 필수입니다.
--name, -n, --worker-name
필수. 서버리스 Fleet 작업자의 이름입니다. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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의 모든 작업자를 나열합니다.

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

명령 옵션

--fleet-id, --fid, --id
필수. 해당 작업자가 속한 Fleet의 ID입니다. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 namestatus입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

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

ibmcloud ce fleet worker profiles

서버리스 Fleet에 지원되는 작업자 프로파일을 나열합니다.

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

명령 옵션

--output, -o
결과 형식입니다. 유효한 값은 'json', 'yaml', 'jsonpath=JSONPATH_EXPRESSION' 및 'jsonpath-as-json=JSONPATH_EXPRESSION'입니다. 이 값은 선택사항입니다.
--profile-family, --pf
지정된 작업자 프로파일 그룹에 속하는 프로파일을 표시합니다. 유효한 값은 [b, balanced, c, compute, m, memory, g, gpu, f, flex] 입니다. 이 값은 선택 사항 입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--region, -r
지정된 지역에서 지원되는 작업자 프로파일을 표시합니다. 이 값은 선택사항입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 올바른 값은 name, cpu, diskmemory입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

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

출력 예

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

함수 명령

함수는 HTTP 요청에 의해 호출될 때 작업을 수행하는 상태 비저장 코드 스니펫입니다. IBM Code Engine 함수를 사용하면 확장 가능한 서버리스 방식으로 비즈니스 로직을 실행할 수 있습니다. IBM Code Engine 함수는 짧은 지연 시간과 신속한 스케일아웃 시나리오를 지원하기 위해 최적화된 런타임 환경을 제공합니다. 함수 코드는 특정 Node.js 또는 Python 버전이 포함된 관리형 런타임에서 작성할 수 있습니다.

명령을 사용하려면 프로젝트function의 컨텍스트 내에 있어야 합니다.

함수 작업에 대한 자세한 내용은 함수 작업을 참조하세요.

ibmcloud ce function bind

IBM Cloud 서비스 인스턴스를 함수에 바인딩합니다.

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

명령 옵션

--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 옵션을 지정하면, bind 함수는 --wait-timeout 옵션으로 설정된 최대 시간(초 단위) 동안 bind 함수가 성공적으로 완료될 때까지 대기합니다. bind 함수가 성공적으로 완료되지 않거나 지정된 --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

ibmcloud ce function create

함수를 작성하십시오.

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

명령 옵션

-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 옵션이 Git 리포지토리의 URL 로 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

--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 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍을 기반으로 환경 변수를 설정하십시오.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 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
지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. 이 값은 선택사항입니다. 기본값은 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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--scale-down-delay, --sdd

호출이 완료된 후 인스턴스가 활성 상태로 유지되는 시간(초)입니다. 이 옵션은 콜드 스타트 시간을 줄일 수 있습니다. 자세한 내용은 함수 인스턴스를 더 오래 살릴 수 있나요? 이 값은 선택사항입니다. 기본값은 1입니다.

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

함수 실행을 위해 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--visibility, -v

함수의 가시성입니다. 유효한 값은 public, privateproject 입니다. 프로젝트가 함수 전용 가시성을 지원하는 경우에만 가시성이 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 페이지가 표시됩니다.

ibmcloud ce function delete

함수를 삭제하십시오.

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

명령 옵션

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

ibmcloud ce function get

함수의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
기능의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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-22
  Timeout:            600  
  Source:             main.js  
                      
  Build Run Summary:  Succeeded  
  Build Run Status:   Succeeded  
  Build Run Reason:   All Steps have completed executing  
  Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' for details.  
Function Code:    
  Runtime:        nodejs-22 (managed)
  Bundle Secret:  ce-auto-icr-private-us-south  
  Code Bundle:    cr://icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla
  Main:           main()

ibmcloud ce function list

프로젝트의 모든 함수를 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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  

ibmcloud ce function runtimes

사용 가능한 함수 런타임을 나열합니다.

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

명령 옵션

--all, -A
더 이상 사용되지 않는 런타임을 포함하여 모든 런타임을 표시합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce fn runtimes

출력 예

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

ibmcloud ce function unbind

IBM Cloud 서비스 인스턴스를 함수에서 해제합니다.

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

명령 옵션

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

ibmcloud ce function update

함수를 업데이트하십시오.

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

명령 옵션

--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 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 key1에 대해 myKey 환경 변수를 추가하려면 configmapName:myKey=key1 값을 사용하십시오.

이 값은 선택사항입니다.

--env-from-configmap-rm, --env-cm-rm
configmap 이름을 사용하여 전체 configmap에 대한 환경 변수 참조를 제거합니다. configmap에 대한 개별 키 참조를 제거하려면 --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

configmap 또는 시크릿에서 키-값 쌍의 키에 대한 환경 변수 참조를 제거합니다. 개별 키 참조 및 리터럴 값을 제거하려면 키 이름을 지정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.

--force, -f

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--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, privateproject 입니다. 프로젝트가 함수 전용 가시성을 지원하는 경우에만 가시성이 private 가 될 수 있습니다. 이 값은 선택사항입니다.

--wait, -w

빌드 실행이 완료될 때까지 대기하십시오. 이 값은 선택사항입니다. 기본값은 true입니다.

--wait-timeout, --wto

함수가 준비될 때까지 대기할 시간(초 단위). --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 600입니다.

ibmcloud ce fn update --name myfunction --runtime nodejs-22 --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 페이지가 표시됩니다.

도움말 명령

Code Engine 도움말 명령은 명령 그룹별로 사용 가능한 명령에 대한 정보를 제공합니다.

ibmcloud ce help

Code Engine 도움말 명령은 명령 그룹별로 사용 가능한 명령에 대한 정보를 제공합니다.

ibmcloud ce help COMMAND

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.

작업 명령

작업은 실행 가능 코드의 하나 이상의 인스턴스를 병렬로 실행합니다. HTTP 요청을 처리하는 애플리케이션과 달리 작업이 한 번 실행되고 종료되도록 설계되었습니다. 작업을 작성할 때 작업이 실행될 때마다 사용될 워크로드 구성 정보를 지정할 수 있습니다. 작업에 대한 구성을 작성하려면 job 명령을 사용하십시오.

명령을 사용하려면 프로젝트job의 컨텍스트 내에 있어야 합니다.

작업에 대한 자세한 정보는 작업 실행을 참조하십시오.

job 명령에 대한 CLI 도움말을 보려면 ibmcloud ce job -h``을 실행하십시오.

ibmcloud ce job bind

작업에 IBM Cloud 서비스 인스턴스 바인드

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

명령 옵션

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

ibmcloud ce job create

작업을 작성합니다.

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

명령 옵션

-n, --name

작업 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 63자 이하여야 하며 소문자, 숫자, 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--argument, --arg, -a
작업 실행에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 선택사항입니다.
--array-indexes, --array-indices, --ai

작업 실행에 사용되는 배열 인덱스를 지정합니다. 예를 들어, 0,3,6,9, 1-5,7-8,10 등이 있습니다. 색인의 결과 세트는 1000개 항목으로 제한됩니다. 이 옵션은 array-size 가 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 0입니다.

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

작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어, instances5 으로 지정하면, 시스템은 이를 array-indexes0 - 4 으로 변환합니다. 이 옵션은 ‘ --array-indexes ’ 옵션이 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 1입니다.

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

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. 빌드 커밋 옵션은 --build-source 옵션이 Git 리포지토리의 URL 로 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

빌드팩 파일 또는 Dockerfile이 포함되어 있는 저장소의 디렉토리입니다. 빌드 컨텍스트 디렉터리 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

Dockerfile의 경로입니다. 이름이 Dockerfile이 아닌 경우에만 이 옵션을 지정하십시오. 빌드 도커파일 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 Dockerfile입니다.

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

컨테이너 이미지를 빌드하기 위한 소스 코드가 들어 있는 개인 저장소에 액세스하기 위한 자격 증명을 포함하는 SSH 본인확인정보의 이름입니다. 이 SSH 비밀번호를 만들려면 secret create --format SSH 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. 이 옵션은 --build-source 옵션이 Git 리포지토리의 URL 로 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다.

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

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 medium입니다.

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

Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예: https://github.com/IBM/CodeEngine 또는 .). 이 값은 선택사항입니다.

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

이미지를 빌드하는 데 사용할 전략입니다. 유효값은 dockerfilebuildpacks입니다. 빌드 전략 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 명시되지 않은 경우, --build-source 가 지정되어 있고 소스 코드가 로컬 컴퓨터에 있는 경우 빌드 전략은 Code Engine 에 따라 결정됩니다. 이 값은 선택사항입니다. 기본값은 dockerfile입니다.

--build-timeout, --bto

빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 시간 초과 옵션은 --build-source 옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은 600입니다.

--command, --cmd, -c

작업 실행에 대한 명령을 설정합니다. --command 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--cpu

작업 실행에 대해 설정할 CPU의 양입니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 1입니다.

--env, -e

작업 실행에 대한 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 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

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret 또는 --registry-secret 옵션을 사용하여 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--image, -i

작업 실행에 사용되는 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. REGISTRY를 지정하지 않으면 기본값은 docker.io입니다. TAG를 지정하지 않으면 기본값은 latest입니다. --build-source 옵션을 지정하지 않은 경우 image 옵션은 필수입니다. 이 값은 선택사항입니다.

--maxexecutiontime, --met

작업 실행의 최대 실행 시간(초)입니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 7200입니다.

--memory, -m

작업 실행에 대해 설정된 메모리의 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 4G입니다.

--mode

작업 실행 모드입니다. 유효값은 taskdaemon입니다. task 모드에서는 maxexecutiontimeretrylimit 옵션이 적용됩니다. daemon 모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로, --maxexecutiontime--retrylimit 옵션은 사용할 수 없습니다. 이 값은 선택사항입니다. 기본값은 task 입니다.

--mount-configmap, --mount-cm

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 작업 실행의 파일 시스템에 configmap의 컨텐츠를 추가합니다. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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 형식으로 제공하여 작업 실행의 파일 시스템에 시크릿의 컨텐츠를 추가합니다. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--registry-secret, --rs

레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.

--retrylimit, -r

작업이 실패로 표시되기 전에 작업 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업의 배열 인덱스가 다시 실행됩니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 3입니다.

--service-account, --sa

서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인 manager, none, readerwriter를 사용할 수 있습니다. 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 옵션을 지정한 경우 이 값이 무시됩니다. 대기 시간 초과 옵션은 --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

ibmcloud ce job delete

작업 및 연관된 작업 실행을 삭제합니다.

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

명령 옵션

--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 명령을 실행하여 작업을 삭제할 경우 이 작업을 참조하는 제출된 작업 실행도 모두 삭제됩니다.

ibmcloud ce job get

작업의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
작업 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce job list

프로젝트에 있는 모든 작업을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce job unbind

IBM Cloud 서비스 인스턴스를 작업에서 바인드 해제하여 기존 서비스 바인딩을 제거합니다.

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

명령 옵션

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

ibmcloud ce job update

작업을 업데이트합니다.

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

명령 옵션

--name, -n

작업 이름입니다. 이 값은 필수입니다.

--argument, --arg, -a

작업 실행에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 선택사항입니다.

--arguments-clear, --ac

작업 인수를 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

작업 실행에 사용되는 배열 인덱스를 지정합니다. 예를 들어, 0,3,6,9, 1-5,7-8,10 등이 있습니다. 색인의 결과 세트는 1000개 항목으로 제한됩니다. 이 옵션은 array-size 가 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

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

작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어, instances5 으로 지정하면, 시스템은 이를 array-indexes0 - 4 으로 변환합니다. 이 옵션은 ‘ --array-indexes ’ 옵션이 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 0입니다.

--build-clear, --bc

이 작업에서 빌드의 연관을 제거하십시오. '빌드 지우기' 옵션은 현재 해당 작업에 연결된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

가져올 소스 저장소의 커미트, 태그 또는 분기입니다. 빌드 커밋 옵션은 --build-source 옵션이 이 job update 명령어에서 Git 저장소의 URL 로 설정되어 있거나, 현재 작업에 Git 저장소 소스에서 가져온 빌드가 연결되어 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다.

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

가져오기를 위해 소스 저장소에서 커미트, 태그 또는 분기를 지웁니다. 'commit clear' 옵션은 현재 해당 작업에 연결된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

빌드팩 파일 또는 Dockerfile이 포함되어 있는 저장소의 디렉토리입니다. 빌드 컨텍스트 디렉터리 옵션은 이 job update 명령어에서 --build-source 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다.

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

Dockerfile의 경로입니다. 이름이 Dockerfile이 아닌 경우에만 이 옵션을 지정하십시오. --build-source 옵션이 이 job update 명령에 설정되어 있거나 작업에 현재 연관된 빌드가 있는 경우 build dockerfile 옵션이 허용됩니다. 이 값은 선택사항입니다. 기본값은 Dockerfile입니다.

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

컨테이너 이미지를 빌드하기 위한 소스 코드가 들어 있는 개인 저장소에 액세스하기 위한 자격 증명을 포함하는 SSH 본인확인정보의 이름입니다. 이 SSH 비밀번호를 만들려면 secret create --format SSH 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. 이 옵션은 --build-source 옵션이 이 job update 명령어에서 Git 저장소의 URL 로 설정되어 있거나, 현재 작업에 Git 저장소 소스에서 가져온 빌드가 연결되어 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다.

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

SSH 본인확인정보를 지웁니다. 현재 해당 작업에 연결된 빌드가 있는 경우 이 옵션을 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은 small, medium, large, xlargexxlarge 입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 이 job update 명령어에서 ‘ --build-source ’ 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 medium입니다.

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

Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예: https://github.com/IBM/CodeEngine 또는 .). 이 값은 선택사항입니다.

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

이미지를 빌드하는 데 사용할 전략입니다. 유효값은 dockerfilebuildpacks입니다. 빌드 전략 옵션은 이 job update 명령어에서 --build-source 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 지정하지 않으면 --build-source가 지정되고 소스가 로컬 시스템에 있는 경우 빌드 전략이 Code Engine에 의해 결정됩니다. 이 값은 선택사항입니다. 기본값은 dockerfile입니다.

--build-timeout, --bto

빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 타임아웃 옵션은 이 job update 명령어에 --build-source 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 600입니다.

--command, --cmd, -c

작업 실행에 대한 명령을 설정합니다. --command 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--commands-clear, --cc

작업 명령을 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--cpu

작업 실행에 대해 설정할 CPU의 양입니다. 이 값은 작업에 지정된 --cpu 값을 업데이트합니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 0입니다.

--env, -e

작업 실행에 대한 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: --env envA=A --env envB=B). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 key1에 대해 myKey 환경 변수를 추가하려면 configmapName:myKey=key1 값을 사용하십시오.

이 값은 선택사항입니다.

--env-from-configmap-rm, --env-cm-rm
configmap 이름을 사용하여 전체 configmap에 대한 환경 변수 참조를 제거합니다. configmap에 대한 개별 키 참조를 제거하려면 --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

configmap 또는 시크릿에서 키-값 쌍의 키에 대한 환경 변수 참조를 제거합니다. 개별 키 참조 및 리터럴 값을 제거하려면 키 이름을 지정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.

--ephemeral-storage, --es

작업 실행에 대해 설정할 임시 스토리지의 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 이 값은 선택사항입니다.

--force, -f

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret 또는 --registry-secret 옵션을 사용하여 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--image, -i

작업 실행에 사용되는 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. REGISTRY를 지정하지 않으면 기본값은 docker.io입니다. TAG를 지정하지 않으면 기본값은 latest입니다. 이 값은 선택사항입니다.

--maxexecutiontime, --met

작업 실행의 최대 실행 시간(초)입니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 7200입니다.

--memory, -m

작업 실행에 대해 설정된 메모리의 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다.

--mode

작업 실행 모드입니다. 유효값은 taskdaemon입니다. task 모드에서는 maxexecutiontimeretrylimit 옵션이 적용됩니다. daemon 모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로, --maxexecutiontime--retrylimit 옵션은 사용할 수 없습니다. 이 값은 선택사항입니다.

--mount-configmap, --mount-cm

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 작업 실행의 파일 시스템에 configmap의 컨텐츠를 추가합니다. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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

configmap 또는 시크릿이 마운트된 디렉토리를 지정하여 작업 실행의 파일 시스템에서 configmap 또는 시크릿의 컨텐츠를 제거합니다. --mount-rm 옵션당 하나의 마운트 디렉토리를 지정하십시오. 예를 들면, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b입니다. 이 값은 선택사항입니다.

--mount-secret, --mount-sec

마운트 디렉토리와 시크릿 이름을 MOUNT_DIRECTORY=SECRET_NAME 형식으로 제공하여 작업 실행의 파일 시스템에 시크릿의 컨텐츠를 추가합니다. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --mount-secret /etc/secret-a=secret--a --mount-secret /etc/secret-b=secret-b입니다. 이 값은 선택사항입니다.

--no-wait, --nw

빌드 실행이 완료될 때까지 대기하지 않습니다. --no-wait 옵션을 지정하면 대기하지 않고 빌드 실행이 시작됩니다. 빌드 실행 상태를 확인하려면 buildrun get 명령을 사용하십시오. 대기 없음 옵션은 이 job update 명령어에서 --build-source 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--rebuild

소스로부터 이미지를 다시 빌드합니다. 현재 해당 작업에 연관된 빌드가 있는 경우, 재빌드 옵션을 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--registry-secret, --rs

레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.

--registry-secret-clear, --rsc

레지스트리 본인확인정보를 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--retrylimit, -r

작업이 실패로 표시되기 전에 작업 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업의 배열 인덱스가 다시 실행됩니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 3입니다.

--service-account, --sa

서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인 manager, none, readerwriter를 사용할 수 있습니다. 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 명령에 설정되어 있거나 작업에 현재 연관된 빌드가 있는 경우 wait-timeout 옵션이 허용됩니다. 기본값은 600입니다.

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

출력 예

Updating job 'hellojob'...
OK

Jobrun 명령

작업은 실행 가능 코드의 하나 이상의 인스턴스를 병렬로 실행합니다. HTTP 요청을 처리하는 애플리케이션과 달리 작업이 한 번 실행되고 종료되도록 설계되었습니다. 작업을 작성할 때 작업이 실행될 때마다 사용될 워크로드 구성 정보를 지정할 수 있습니다. jobrun 명령을 사용하여 작업 인스턴스를 실행할 수 있습니다.

명령을 사용하려면 프로젝트jobrun의 컨텍스트 내에 있어야 합니다.

작업 및 작업 실행에 대한 자세한 정보는 작업 실행을 참조하십시오.

jobrun 명령에 대한 CLI 도움말을 보려면 ibmcloud ce jobrun -h``을 실행하십시오.

ibmcloud ce jobrun delete

작업 실행을 삭제합니다.

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

명령 옵션

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

ibmcloud ce jobrun events

작업 실행 인스턴스의 시스템 이벤트를 표시합니다. 시스템 이벤트는 최대 60분까지 유지됩니다.

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

명령 옵션

--instance, -i
특정 작업 실행 인스턴스의 이름입니다. 인스턴스 이름을 찾으려면 jobrun get 명령을 사용하십시오. --jobrun을 지정하지 않은 경우에는 이 값이 필수입니다.
--jobrun, -j, --name, -n
지정된 작업 실행의 모든 인스턴스에 대한 이벤트를 표시합니다. --instance를 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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"

지정된 작업 실행 인스턴스에 대한 시스템 이벤트 정보 예

--instance 옵션을 ibmcloud ce jobrun events 명령과 함께 사용하여 지정된 작업 실행 인스턴스에 대한 시스템 이벤트 정보를 표시할 수도 있습니다. 실행 중인 작업 실행 인스턴스를 포함하여 작업 실행에 대한 세부사항을 표시하려면 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

ibmcloud ce jobrun get

작업 실행의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
작업 실행의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce jobrun list

프로젝트에 있는 모든 작업 실행을 나열합니다.

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

명령 옵션

--job, -j
지정된 작업에서만 작업 실행을 표시하려면 이 옵션을 사용하십시오. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

나열된 작업 실행의 이름은 작업 실행의 이름과 작업 실행의 현재 개정을 표시합니다.

ibmcloud ce jobrun logs

작업 실행 인스턴스의 로그를 표시합니다.

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

명령 옵션

--follow, -f
작업 실행 인스턴스의 로그를 따릅니다. 이 옵션을 사용하여 작업 실행 인스턴스의 로그를 스트리밍할 수 있습니다. --follow 옵션을 지정하는 경우 Ctrl+C를 입력하여 이 로그 명령을 종료해야 합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--instance, -i
특정 작업 실행 인스턴스의 이름입니다. 인스턴스 이름을 찾으려면 jobrun get 명령을 사용하십시오. --jobrun을 지정하지 않은 경우에는 이 값이 필수입니다.
--jobrun, -j, --name, -n
지정된 작업 실행의 모든 인스턴스에 대한 로그를 표시합니다. --instance를 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce jobrun restart

실행 중인 작업 실행 인스턴스를 다시 시작합니다.

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

명령 옵션

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

ibmcloud ce jobrun resubmit

이전 작업 실행의 구성에 따라 작업 실행을 다시 제출합니다.

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

명령 옵션

--jobrun, -j

이 작업 실행이 기준으로 하는 이전 작업 실행의 이름입니다. 이 값은 필수입니다.

--argument, --arg, -a

이 작업 실행에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 선택사항입니다.

--arguments-clear, --ac

작업 실행 인수를 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

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

이 작업 실행에 사용되는 인스턴스의 인덱스를 지정합니다. 예를 들어, 0,3,6,9, 1-5,7-8,10 등이 있습니다. 색인의 결과 세트는 1000개 항목으로 제한됩니다. 이 옵션은 array-size 가 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

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

이 작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어, instances5 으로 지정하면, 시스템은 이를 array-indexes0 - 4 으로 변환합니다. 이 옵션은 ‘ --array-indexes ’ 옵션이 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 0입니다.

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

JOB_ARRAY_SIZE 환경 변수에 대한 사용자 지정 값을 지정합니다. 기본적으로 JOB_ARRAY_SIZE 환경 변수는 array-size 값이나 array-indexes``에서 지정한 인덱스 수 중 하나로 설정됩니다. JOB_ARRAY_SIZE 환경 변수의 값은 구성된 배열 크기에 영향을 주지 않습니다. 일부 작업 인스턴스만 제출되거나 다시 제출되는 작업 재실행 시나리오에 대해 일정한 배열 크기 값을 적용하려면 이 옵션을 사용합니다. 이 값은 선택사항입니다.

--command, --cmd, -c

이 작업 실행에 대한 명령을 설정합니다. --command 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--commands-clear, --cc

작업 실행 명령을 지웁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--cpu

이 작업 실행에 대한 각 배열 인덱스에 대해 설정된 CPU 양입니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 0입니다.

--env, -e

이 작업 실행에 대한 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: -e envA -e envB). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 key1에 대해 myKey 환경 변수를 추가하려면 configmapName:myKey=key1 값을 사용하십시오.

이 값은 선택사항입니다.

--env-from-configmap-rm, --env-cm-rm
configmap 이름을 사용하여 전체 configmap에 대한 환경 변수 참조를 제거합니다. configmap에 대한 개별 키 참조를 제거하려면 --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

configmap 또는 시크릿에서 키-값 쌍의 키에 대한 환경 변수 참조를 제거합니다. 개별 키 참조 및 리터럴 값을 제거하려면 키 이름을 지정하십시오. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.

--ephemeral-storage, --es

이 작업 실행에 대한 임시 스토리지의 크기입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 이 값은 선택사항입니다.

--force, -f

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret 옵션으로 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--maxexecutiontime, --met

이 작업 실행의 최대 실행 시간(초)입니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 7200입니다.

--memory, -m

이 작업 실행에 지정할 메모리 양입니다. 메가바이트의 경우 M을 사용하고 기가바이트의 경우 G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다.

--mode

작업 실행 모드입니다. 유효값은 taskdaemon입니다. task 모드에서는 maxexecutiontimeretrylimit 옵션이 적용됩니다. daemon 모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로, maxexecutiontimeretrylimit 옵션은 사용할 수 없습니다. 이 값은 선택사항입니다.

--mount-configmap, --mount-cm

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 이 작업 실행의 파일 시스템에 configmap의 컨텐츠를 추가합니다. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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

configmap 또는 시크릿이 마운트된 디렉토리를 지정하여 이 작업 실행의 파일 시스템에서 configmap 또는 시크릿의 컨텐츠를 제거합니다. --mount-rm 옵션당 하나의 마운트 디렉토리를 지정하십시오. 예를 들면, --mount-rm /etc/configmap-a --mount-rm /etc/secret-b입니다. 이 값은 선택사항입니다.

--mount-secret, --mount-sec

마운트 디렉토리와 시크릿 이름을 MOUNT_DIRECTORY=SECRET_NAME 형식으로 제공하여 이 작업 실행의 파일 시스템에 시크릿의 컨텐츠를 추가합니다. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--retrylimit, -r

작업 실행이 실패로 표시되기 전에 이 작업 실행의 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업 실행의 배열 인덱스가 다시 실행됩니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 3입니다.

--service-account, --sa

서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인 manager, none, readerwriter를 사용할 수 있습니다. 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

ibmcloud ce jobrun submit

작업을 기준으로 작업 실행을 제출합니다.

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

명령 옵션

--argument, --arg, -a

이 작업 실행에 대한 인수를 설정합니다. --argument 옵션당 한 개의 인수를 지정하십시오(예: -a argA -a argB). 이 값은 선택사항입니다.

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

이 작업 실행에 사용되는 인스턴스의 인덱스를 지정합니다. 예를 들어, 0,3,6,9, 1-5,7-8,10 등이 있습니다. 색인의 결과 세트는 1000개 항목으로 제한됩니다. 이 옵션은 array-size 가 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 0입니다.

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

이 작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어, instances5 으로 지정하면, 시스템은 이를 array-indexes0 - 4 으로 변환합니다. 이 옵션은 ‘ --array-indexes ’ 옵션이 지정되지 않은 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 1입니다.

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

JOB_ARRAY_SIZE 환경 변수에 대한 사용자 지정 값을 지정합니다. 기본적으로 JOB_ARRAY_SIZE 환경 변수는 array-size 값이나 array-indexes``에서 지정한 인덱스 수 중 하나로 설정됩니다. JOB_ARRAY_SIZE 환경 변수의 값은 구성된 배열 크기에 영향을 주지 않습니다. 일부 작업 인스턴스만 제출되거나 다시 제출되는 작업 재실행 시나리오에 대해 일정한 배열 크기 값을 적용하려면 이 옵션을 사용합니다. 이 값은 선택사항입니다.

--command, --cmd, -c

이 작업 실행에 대한 명령을 설정합니다. --command 옵션당 한 개의 명령을 지정하십시오(예: --cmd cmdA --cmd cmdB). 이 값은 컨테이너 이미지 내에 지정된 기본 명령을 대체합니다. 이 값은 선택사항입니다.

--cpu

이 작업 실행에 대한 각 배열 인덱스에 대해 설정된 CPU 양입니다. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은 1입니다.

--env, -e

이 작업 실행에 대한 환경 변수를 설정합니다. NAME=VALUE 형식이어야 합니다. 이 조치는 새 환경 변수를 추가하거나 기존 환경 변수를 대체합니다. --env 옵션당 한 개의 환경 변수를 지정하십시오(예: -e envA -e envB). 이 값은 선택사항입니다.

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

다음 방법 중 하나를 사용하여 이 configmap에 저장된 키-값 쌍에서 환경 변수를 설정합니다.

  • configmapName이라는 configmap에서 모든 키에 대한 환경 변수를 추가하려면 configmapName 값을 사용하십시오. configmap을 참조할 때 접두부를 지정하여 환경 변수 이름을 수정할 수 있습니다. 접두부를 지정하려면 PREFIX=CONFIGMAP_NAME을 값으로 사용하십시오. 생성되는 각 환경 변수의 형식은 <PREFIX><NAME_OF_KEY_IN_CONFIGMAP>입니다. 예를 들어, configmap configmapName에 있는 키의 모든 변수 이름에 대한 접두부를 CUSTOM_으로 설정하려면 CUSTOM_=configmapName을 값으로 사용하십시오. configmap configmapName에 KEY_A가 포함된 경우 환경 변수 이름은 CUSTOM_KEY_A입니다.
  • 개별 키에 대한 환경 변수를 추가하려면 NAME:KEY_A,KEY_B 형식을 사용하십시오. 예를 들어 key1이라는 configmap에서 단일 키 configmapName에 대한 환경 변수를 추가하려면 configmapName:key1 값을 사용하십시오. 참조된 키에 다른 이름을 지정하려면 NAME:NEW_NAME=KEY_A 형식을 사용하십시오. 예를 들어, configmapName이라는 configmap의 단일 키 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

지정된 configmap 및 시크릿 참조가 있는지 확인하지 마십시오. configmap 참조는 --env-from-configmap 옵션으로 지정됩니다. 시크릿 참조는 --env-from-secret 또는 --registry-secret 옵션을 사용하여 지정됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--image, -i

이 작업 실행에 사용되는 이미지의 이름입니다. 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서, REGISTRYTAG는 선택사항입니다. 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

작업 실행 모드입니다. 유효값은 taskdaemon입니다. task 모드에서는 maxexecutiontimeretrylimit 옵션이 적용됩니다. daemon 모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로, maxexecutiontimeretrylimit 옵션은 사용할 수 없습니다. 이 값은 선택사항입니다. 기본값은 task 입니다.

--mount-configmap, --mount-cm

마운트 디렉토리와 configmap 이름을 MOUNT_DIRECTORY=CONFIGMAP_NAME 형식으로 제공하여 이 작업 실행의 파일 시스템에 configmap의 컨텐츠를 추가합니다. 마운트된 각 configmap은 고유한 마운트 디렉토리를 사용해야 합니다. configmap에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-configmap 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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 형식으로 제공하여 이 작업 실행의 파일 시스템에 시크릿의 컨텐츠를 추가합니다. 마운트된 각 시크릿은 고유한 마운트 디렉토리를 사용해야 합니다. 시크릿에서 각 키-값 쌍의 경우 파일은 지정된 마운트 디렉토리에 추가됩니다. 여기서, 파일 이름은 키이고 파일의 컨텐츠는 키-값 쌍의 값입니다. --mount-secret 옵션당 하나의 마운트 구성을 지정하십시오. 예를 들면, --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_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--registry-secret, --rs

레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.

--retrylimit, -r

작업 실행이 실패로 표시되기 전에 이 작업 실행의 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업 실행의 배열 인덱스가 다시 실행됩니다. 이 옵션은 mode task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은 3입니다.

--service-account, --sa

서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인 manager, none, readerwriter를 사용할 수 있습니다. 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

퍼시스턴트데이터스토어 명령

영구 데이터 저장소를 관리합니다.

ibmcloud ce persistentdatastore create

영구 데이터 저장소를 작성합니다.

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

명령 옵션

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

ibmcloud ce persistentdatastore delete

영구 데이터 저장소를 삭제합니다.

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

명령 옵션

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

ibmcloud ce persistentdatastore get

영구 데이터 저장소의 세부사항을 표시합니다.

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

명령 옵션

--name, -n
필수. 영구 데이터 저장소의 이름. 이 값은 필수입니다.
--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-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  

ibmcloud ce persistentdatastore list

프로젝트 내 모든 영구 데이터 저장소를 나열합니다.

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

명령 옵션

--output, -o
결과 형식입니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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  

Project 명령

프로젝트를 현재 컨텍스트로 작성, 나열, 삭제 및 선택하려면 project 명령을 사용하십시오.

프로젝트는 애플리케이션, 함수, 작업, 플릿, 빌드 등 Code Engine 의 엔티티들을 묶은 것입니다. 프로젝트는 Kubernetes 네임스페이스를 기반으로 합니다. 프로젝트 이름은 IBM Cloud® 리소스 그룹, 사용자 계정 및 지역 내에서 고유해야 합니다. 프로젝트는 리소스를 관리하고 해당 엔티티에 대한 액세스 권한을 부여하는 데 사용됩니다.

이 프로젝트는 다음과 같은 기능을 제공합니다:

  • 엔티티 이름을 위한 고유한 네임스페이스.
  • 프로젝트 리소스에 대한 인바운드 액세스 관리.
  • 백업 서비스, 레지스트리 및 저장소에 대한 외부 접근 관리.
  • 전송 계층 서비스( TLS )에 대해 자동으로 생성된 인증서입니다.

프로젝트 작업에 대한 자세한 정보는 프로젝트 관리를 참조하십시오.

project 명령에 project 또는 proj를 사용할 수 있습니다. project 명령에 대한 CLI 도움말을 보려면 ibmcloud ce proj -h를 실행하십시오.

ibmcloud ce project create

프로젝트를 작성하십시오.

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

명령 옵션

-n, --name

프로젝트 이름입니다. 사용자 지역에 고유한 이름을 사용하십시오. 이름은 128자 이하여야 하며 다음을 포함할 수 있습니다.

  • 유니코드 또는 영숫자 문자
  • 다음 특수 문자만: 공백( ), 마침표(.), 콜론(:), 밑줄(_), 하이픈(-)

이 값은 필수입니다.

--endpoint, -e
프로젝트의 엔드포인트입니다. 유효값은 publicprivate입니다. --endpoint 옵션을 명시적으로 지정하지 않은 경우 동작은 시스템에 의해 결정됩니다. IBM Cloud CLI가 private.cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는 --endpointprivate인 것처럼 동작합니다. IBM Cloud CLI가 cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는 --endpointpublic인 것처럼 동작합니다. 이 값은 선택사항입니다.
--no-select, --ns

해당 프로젝트가 작성된 후에는 프로젝트를 현재 컨텍스트로 선택하지 마십시오. 이 옵션을 선택하지 않으면 프로젝트가 자동으로 선택됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--no-wait, --nw

프로젝트를 작성하며 프로젝트가 작성될 때까지 대기하지 않습니다. no-wait 옵션을 지정할 경우 프로젝트 작성이 시작되며 대기하지 않습니다. 프로젝트 상태를 확인하려면 project get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--tag, -t

프로젝트에 지정할 레이블. 레이블은 128자 이하여야 하며 문자, 숫자, 공백(), 마침표(.), 콜론(:), 밑줄(_) 및 하이픈(-)을 포함할 수 있습니다. --tag 옵션당 하나의 레이블을 지정하십시오(예: --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

ibmcloud ce project current

현재 대상으로 지정된 프로젝트의 세부사항을 표시합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce project delete

프로젝트를 삭제합니다.

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

명령 옵션

--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--hard
프로젝트를 즉시 삭제합니다. --hard 옵션을 지정하지 않으면 project restore 또는 reclamation restore 명령을 사용하여 7일 내에 프로젝트를 복원할 수 있습니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce project get

단일 프로젝트의 세부사항을 표시합니다.

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

명령 옵션

--id, --guid
프로젝트의 ID입니다. --name를 지정하지 않은 경우에는 이 값이 필수입니다.
--name, -n
프로젝트 이름입니다. --id를 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce project get --name myproject

출력 예

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

ibmcloud ce project list

모든 프로젝트를 나열합니다.

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

명령 옵션

--all-resource-groups, --all
모든 리소스 그룹의 프로젝트를 표시합니다. 기본적으로 프로젝트는 현재 리소스 그룹에서만 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--regions, -r
프로젝트 표시를 지정된 지역으로 제한합니다. 하나 이상의 지역 이름을 제공하십시오(예: us-south,eu-de). 이 값은 선택사항입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce project restore

프로젝트를 복원합니다.

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

명령 옵션

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

ibmcloud ce project select

프로젝트를 현재 컨텍스트로 선택합니다. 프로젝트가 active 상태여야 선택할 수 있습니다.

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

명령 옵션

--endpoint, -e
프로젝트의 엔드포인트입니다. 유효값은 publicprivate입니다. --endpoint 옵션을 명시적으로 지정하지 않은 경우 동작은 시스템에 의해 결정됩니다. IBM Cloud CLI가 private.cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는 --endpointprivate인 것처럼 동작합니다. IBM Cloud CLI가 cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는 --endpointpublic인 것처럼 동작합니다. 이 값은 선택사항입니다.
--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

ibmcloud ce project tag

단일 프로젝트의 태그를 관리합니다.

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

명령 옵션

--id, --guid
프로젝트의 ID입니다. --name를 지정하지 않은 경우에는 이 값이 필수입니다.
--name, -n
프로젝트 이름입니다. --id를 지정하지 않은 경우에는 이 값이 필수입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--tag, -t
프로젝트에 지정할 레이블. 레이블은 128자 이하여야 하며 문자, 숫자, 공백(), 마침표(.), 콜론(:), 밑줄(_) 및 하이픈(-)을 포함할 수 있습니다. --tag 옵션당 하나의 레이블을 지정하십시오(예: --tag tagA --tag tagB). 이 값은 선택사항입니다.
--tag-rm, --trm
프로젝트에 지정된 레이블을 제거하십시오. --tag-rm 옵션마다 하나의 레이블을 지정하십시오(예: --tag-rm tagA --tag-rm tagB). 이 값은 선택사항입니다.

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

출력 예

Getting project 'myproject'...
OK

ibmcloud ce project update

선택된 프로젝트를 업데이트합니다.

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

명령 옵션

--binding-resource-group, --brg
이 프로젝트의 서비스 바인딩의 인증에 사용할 리소스 그룹의 이름입니다. 이 리소스 그룹에 있는 모든 서비스에 대해 OperatorManager 역할이 있는 서비스 ID가 작성됩니다. 이 계정에 있는 모든 리소스 그룹을 지정하려면 "*"를 사용하십시오. 이 값은 선택사항입니다.
--binding-resource-group-id, --brgid
이 프로젝트의 서비스 바인딩에 대한 인증에 사용할 자원 그룹의 ID. 이 리소스 그룹에 있는 모든 서비스에 대해 OperatorManager 역할이 있는 서비스 ID가 작성됩니다. 이 값은 선택사항입니다.
--binding-service-id, --bsid
이 프로젝트의 서비스 바인딩에 대한 인증에 사용할 서비스 ID의 ID입니다. 이 서비스 ID에는 Operator 역할, 그리고 하나 이상의 서비스 인스턴스, 서비스 유형 또는 리소스 그룹에 적합한 서비스 역할이 있어야 합니다. 이 값은 선택사항입니다.
--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

Reclamation 명령

Code Engine 프로젝트 재확보를 관리합니다. 소프트 삭제된 프로젝트는 reclamation restore 명령을 사용하여 7일 내에 복원할 수 있습니다.

ibmcloud ce reclamation delete

프로젝트 재확보를 삭제합니다.

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

명령 옵션

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

ibmcloud ce reclamation get

단일 프로젝트 재확보의 세부사항을 표시합니다.

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

명령 옵션

--id, --guid
프로젝트의 ID입니다. --name를 지정하지 않은 경우에는 이 값이 필수입니다.
--name, -n
프로젝트 이름입니다. --id를 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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

ibmcloud ce reclamation list

프로젝트 재확보를 모두 나열합니다.

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

명령 옵션

--all-resource-groups, --all
모든 리소스 그룹의 프로젝트 재확보를 표시합니다. 기본적으로 프로젝트 재확보는 현재 리소스 그룹에서만 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--regions, -r
프로젝트 재확보 표시를 지정된 지역으로 제한합니다. 하나 이상의 지역 이름을 제공하십시오(예: us-south,eu-de). 이 값은 선택사항입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 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

ibmcloud ce reclamation restore

프로젝트 재확보를 복원합니다. 소프트 삭제된 프로젝트는 reclamation restore 명령을 사용하여 7일 내에 복원할 수 있습니다.

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

명령 옵션

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

Registry 명령

컨테이너 레지스트리 또는 레지스트리는 컨테이너 이미지를 저장하는 서비스입니다. 예를 들어, IBM Cloud Container Registry 및 Docker Hub가 컨테이너 레지스트리입니다. 컨테이너 레지스트리는 공용 또는 개인용일 수 있습니다. 공용 컨테이너 레지스트리에 액세스하려면 인증 정보가 필요하지 않습니다. 반대로, 개인용 레지스트리에 액세스하려면 인증 정보가 필요합니다.

명령을 사용하려면 프로젝트registry의 컨텍스트 내에 있어야 합니다.

레지스트리 액세스에 대한 자세한 정보는 개인용 컨테이너 레지스트리에 대한 액세스 권한 추가를 참조하십시오.

registry 명령에 대한 CLI 도움말을 보려면 ibmcloud ce registry -h``을 실행하십시오.

CLI 버전 1.42.0 부터는 CLI에서 비밀 번호를 정의하고 작업하는 것이 secret 명령 그룹으로 통합됩니다. 참조 ibmcloud ce secret 명령을 참조하세요. --format 옵션을 사용하여 basic_auth, generic, hmac, ssh, tls 또는 registry 과 같은 비밀 카테고리를 지정합니다. 명령 그룹을 계속 사용할 수 있지만 registry 명령 그룹을 계속 사용할 수 있지만, 통합된 secret 명령 그룹을 활용하세요. 컨테이너 레지스트리에 액세스하기 위한 비밀번호를 만들려면 ibmcloud ce secret create --format registry 명령을 사용합니다. Code Engine 에서 비밀 번호로 작업하는 방법에 대해 자세히 알아보려면 비밀 번호로 작업하기 를 참조하세요.

ibmcloud ce registry create

이미지 레지스트리 액세스 시크릿을 작성합니다.

ibmcloud ce registry create --name NAME (--password PASSWORD | --password-from-file PASSWORD_FILE | --password-from-json-file) [--email EMAIL] [--output OUTPUT] [--quiet] [--server SERVER] [--username USERNAME]

명령 옵션

-n, --name

이미지 레지스트리 액세스 시크릿의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--email, -e
레지스트리 서버에 액세스하는 데 필요한 이메일 주소입니다. 이 값은 선택사항입니다.
--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--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라는 이미지 레지스트리 액세스를 us.icr.io에 있는 Container Registry 인스턴스에 작성하며 사용자 이름으로 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

ibmcloud ce registry delete

이미지 레지스트리 액세스 시크릿을 삭제합니다.

ibmcloud ce registry delete --name NAME [--force] [--ignore-not-found] [--quiet]

명령 옵션

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

ibmcloud ce registry get

이미지 레지스트리 액세스 시크릿의 세부사항을 표시합니다.

ibmcloud ce registry get --name NAME [--decode] [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
이미지 레지스트리 액세스 시크릿의 이름입니다. 이 값은 필수입니다.
--decode, -d
세부사항에서 디코딩된 대로Data 출력을 표시합니다. 이 옵션을 지정하지 않으면 Data 세부사항이 base64로 인코딩됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--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==

ibmcloud ce registry list

프로젝트에 있는 모든 이미지 레지스트리 액세스 시크릿을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce registry list   

출력 예

Listing image registry access secrets...
OK
Name        Age
myregistry  19m22s

ibmcloud ce registry update

이미지 레지스트리 액세스 시크릿을 업데이트합니다.

ibmcloud ce registry update --name NAME [--email EMAIL] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--quiet] [--server SERVER] [--username USERNAME]

명령 옵션

--name, -n
이미지 레지스트리 액세스 시크릿의 이름입니다. 이 값은 필수입니다.
--email, -e
레지스트리 서버에 액세스하는 데 필요한 이메일 주소입니다. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--password, -p
레지스트리 서버에 액세스하는 데 필요한 비밀번호입니다. 이 값은 선택사항입니다.
--password-from-file, --pf
레지스트리 서버에 액세스하는 데 필요한 비밀번호를 포함하고 있는 파일의 경로입니다. 파일의 첫 번째 행은 비밀번호에 사용됩니다. 이 값은 선택사항입니다.
--password-from-json-file, --pfj
레지스트리 서버에 액세스하는 데 필요한 비밀번호를 포함하고 있는 JSON 파일의 경로입니다. apikey 필드는 비밀번호에 사용됩니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--server, -s
레지스트리 서버의 URL입니다. 이 값은 선택사항입니다.
--username, -u
레지스트리 서버에 액세스하는 데 필요한 사용자 이름입니다. 이 값은 선택사항입니다.

다음 예제는 myregistry라는 이미지 레지스트리 액세스에 대한 비밀번호를 업데이트합니다.

ibmcloud ce registry update --name myregistry --password NEW_API_KEY  

출력 예

Getting image registry access secret 'myregistry'...
Updating image registry access secret 'myregistry'...
OK

Repo 명령

코드 저장소(예: GitHub 또는 GitLab)에는 소스 코드가 저장됩니다. Code Engine을 사용하면 개인용 코드 저장소에 대한 액세스 권한을 추가한 후 빌드에서 해당 저장소를 참조할 수 있습니다.

명령을 사용하려면 프로젝트repo의 컨텍스트 내에 있어야 합니다.

저장소 액세스에 대한 자세한 정보는 개인용 코드 저장소 액세스를 참조하십시오.

repo 명령에 대한 CLI 도움말을 보려면 ibmcloud ce repo -h``을 실행하십시오.

CLI 버전 1.42.0 부터는 CLI에서 비밀 번호를 정의하고 작업하는 것이 secret 명령 그룹으로 통합됩니다. 참조 ibmcloud ce secret 명령을 참조하세요. --format 옵션을 사용하여 basic_auth, generic, hmac, ssh, tls 또는 registry 과 같은 비밀 카테고리를 지정합니다. 명령 그룹을 계속 사용할 수 있지만 repo 명령 그룹을 계속 사용할 수 있지만, 통합된 secret 명령 그룹을 활용하세요. GitHub 또는 GitLab, 같은 Git 리포지토리에 인증하는 등 SSH 키를 사용하여 서비스에 액세스하기 위한 비밀번호를 만들려면 다음과 같이 ibmcloud ce secret create --format ssh 명령을 사용합니다. SSH 비밀번호는 Git 리포지토리 액세스 비밀번호로도 사용됩니다. Code Engine 에서 비밀 번호로 작업하는 방법에 대해 자세히 알아보려면 비밀 번호로 작업하기 를 참조하세요.

ibmcloud ce repo create

Git 저장소 액세스 시크릿을 작성합니다.

ibmcloud ce repo create --name SECRET_NAME --key-path SSH_KEY_PATH --host HOST_ADDRESS [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

명령 옵션

--host, --ho

호스트 주소입니다(예: github.com). 이 값은 필수입니다.

--key-path, --kp

암호화되지 않은 SSH 개인 키 파일의 경로입니다. 개인용 SSH 개인 키를 사용할 경우 이 파일은 보통 $HOME/.ssh/id_rsa(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\id_rsa(Windows)에 있습니다. 이 값은 필수입니다.

-n, --name

Git 저장소 액세스 시크릿의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--known-hosts-path, --khp
알려진 호스트 파일의 경로입니다. 이 값은 개인 키가 이전에 액세스한 호스트(특히 GitHub 또는 GitLab 호스트)에서 인증하는 데만 사용되도록 하는 보안 기능입니다. 이 파일은 보통 $HOME/.ssh/known_hosts(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\known_hosts(Windows)에 있습니다. 이 값은 선택사항입니다.
--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

다음 명령은 github.com 호스트에 대해 github라는 Git 액세스 시크릿을 작성하고 /<filepath>/.ssh/id_rsa에 있는 SSH 키를 사용하여 인증합니다. 이때 <filepath>는 시스템 경로입니다.

ibmcloud ce repo create -n github --key-path /<filepath>/.ssh/id_rsa --host github.com  

출력 예

Creating Git access secret github...
OK

ibmcloud ce repo delete

Git 저장소 액세스 시크릿을 삭제합니다.

ibmcloud ce repo delete --name NAME [--force] [--ignore-not-found] [--quiet]

명령 옵션

--name, -n
Git 저장소 액세스 시크릿의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce repo delete --name github

출력 예

Are you sure you want to delete the Git access secret github? [y/N]> y
Deleting Git access secret github...
OK

ibmcloud ce repo get

Git 저장소 액세스 시크릿의 세부사항을 표시합니다.

ibmcloud ce repo get --name NAME [--decode] [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
Git 저장소 액세스 시크릿의 이름입니다. 이 값은 필수입니다.
--decode, -d
세부사항에서 디코딩된 대로Data 출력을 표시합니다. 이 옵션을 지정하지 않으면 Data 세부사항이 base64로 인코딩됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce repo get -n github

출력 예

Getting Git access secret github...
OK
Name:        github  
Project:     myproject  
Project ID:  01234567-abcd-abcd-abcd-abcdabcd1111
Age:         30s  
Created:     2021-03-14T14:05:56-05:00  
Host:        github.com
Data:          
---
ssh-privatekey:
ABCDABCDABCDABCDABCDU1NIIFBSSVZBVEUgS0VZLS0tLS0KYjABCDABCDABCDABCDhrdGRqRUFBQUFBQ21GbGN6STFOaABCDABCDABCDABCDABCDABCDE
...

ibmcloud ce repo list

프로젝트에 있는 모든 Git 저장소 액세스 시크릿을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce repo list

출력 예

Listing Git access secrets...
OK
Name    Age  
github  13m0s  

ibmcloud ce repo update

Git 저장소 액세스 시크릿을 업데이트합니다.

ibmcloud ce repo update --name SECRET_NAME [--host HOST] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
Git 저장소 액세스 시크릿의 이름입니다. 이 값은 필수입니다.
--host, --ho
호스트 주소입니다(예: github.com). 이 값은 선택사항입니다.
--key-path, --kp
암호화되지 않은 SSH 개인 키 파일의 경로입니다. 개인용 SSH 개인 키를 사용할 경우 이 파일은 보통 $HOME/.ssh/id_rsa(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\id_rsa(Windows)에 있습니다. 이 값은 선택사항입니다.
--known-hosts-path, --khp
알려진 호스트 파일의 경로입니다. 이 값은 개인 키가 이전에 액세스한 호스트(특히 GitHub 또는 GitLab 호스트)에서 인증하는 데만 사용되도록 하는 보안 기능입니다. 이 파일은 보통 $HOME/.ssh/known_hosts(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\known_hosts(Windows)에 있습니다. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

다음 명령은 github라는 Git 액세스 시크릿을 업데이트하여 새 호스트를 사용합니다.

ibmcloud ce repo update  -n github --host NEW_HOST  

출력 예

Getting Git access secret 'github'...
Updating Git access secret 'github'...
OK

개정 명령

애플리케이션 또는 앱은 코드를 실행하여 HTTP 요청을 제공합니다. 기존 HTTP 요청 외에 IBM Cloud® Code Engine은 WebSocket을 통신 프로토콜로 사용하는 애플리케이션도 지원합니다. 앱에는 하나 이상의 개정이 포함되어 있습니다. 개정은 앱 구성 특성의 불변 버전을 나타냅니다. 앱 구성 특성을 업데이트할 때마다 앱 개정이 새로 작성됩니다.

revision 명령을 사용하여 애플리케이션 개정을 관리하십시오.

명령을 사용하려면 프로젝트revision의 컨텍스트 내에 있어야 합니다.

앱의 개정 작업에 대한 자세한 정보는 애플리케이션 배치를 참조하십시오.

revision 명령에 revision 또는 rev를 사용할 수 있습니다. revision 명령에 대한 CLI 도움말을 보려면 ibmcloud ce revision -h를 실행하십시오.

ibmcloud ce revision delete

애플리케이션 개정을 삭제합니다.

ibmcloud ce revision delete --name REVISION_NAME [--force] [--ignore-not-found] [--quiet]

명령 옵션

--name, -n
애플리케이션 개정의 이름. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce revision delete -n newapp-mytest-00004 -f

출력 예

Deleting application revision 'newapp-mytest-00004'...
OK

ibmcloud ce revision events

애플리케이션 개정 인스턴스의 시스템 이벤트를 표시합니다. 시스템 이벤트는 최대 60분까지 유지됩니다.

ibmcloud ce revision events (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--output OUTPUT] [--quiet]

명령 옵션

--instance, -i
특정 애플리케이션 인스턴스의 이름입니다. 인스턴스 이름을 찾으려면 rev get 명령을 사용하십시오. --revision을 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--revision, --rev, -r, --name, -n
지정된 애플리케이션 개정판의 모든 인스턴스에 관한 이벤트를 표시합니다. --instance를 지정하지 않은 경우에는 이 값이 필수입니다.

ibmcloud ce revision events -n myapp-00001

출력 예

Code Engine은 활성 앱 개정판 외에 애플리케이션의 최신 비활성 개정판만 보유합니다. 이전 개정판은 보유하지 않습니다.

Getting application revision 'newapp-mytest-00002'...
Getting events for all instances of application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp:
Type     Reason     Age                Source                Messages
Normal   Scheduled  65s                default-scheduler     Successfully assigned bz8i2yh012p/newapp-mytest-00002-deployment-7c87cfbf66-xnwkp to 10.243.0.60
Normal   Pulling    63s                kubelet, 10.243.0.60  Pulling image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123"
Normal   Created    60s                kubelet, 10.243.0.60  Created container queue-proxy
Normal   Created    60s                kubelet, 10.243.0.60  Created container user-container
Normal   Started    60s                kubelet, 10.243.0.60  Started container user-container
Normal   Pulled     60s                kubelet, 10.243.0.60  Container image "icr.io/obs/codeengine/knative-serving/knative.dev/serving/cmd/queue:v0.20.0-rc11@sha256:3fedfa9d9cdd74e85d11d4167043f13902074946caf415d16ff537620f04931a" already present on machine
Normal   Pulled     60s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/codeengine/codeengine@sha256:b3150372958ab68eea5356a8cab31069ca5293c45959d64f6aaabbccddeeff123" in 2.67237432s
Normal   Started    60s                kubelet, 10.243.0.60  Started container queue-proxy
Normal   Pulling    60s                kubelet, 10.243.0.60  Pulling image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7"
Normal   Pulled     59s                kubelet, 10.243.0.60  Successfully pulled image "icr.io/obs/codeengine/istio/proxyv2:1.9.1-rc7" in 666.211288ms
Normal   Created    59s                kubelet, 10.243.0.60  Created container istio-proxy
Normal   Started    59s                kubelet, 10.243.0.60  Started container istio-proxy

ibmcloud ce revision get

애플리케이션 개정의 세부사항을 표시합니다.

ibmcloud ce revision get --name REVISION_NAME [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
애플리케이션 개정의 이름. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce revision get --name newapp-mytest-00002

출력 예

Getting application revision 'newapp-mytest-00002'...
Getting application 'newapp-mytest'...
OK
Name:            newapp-mytest-00002
ID:              abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:    myproject
Project ID:      01234567-abcd-abcd-abcd-abcdabcd1111
Age:             27d
Created:         2021-05-05T11:50:00-04:00
Status Summary:  Revision is ready
Environment Variables:
    Type                      Name               Value
    ConfigMap full reference  mycolorconfigmap
    Literal                   TARGET             Sunshine
Image:                  icr.io/codeengine/codeengine
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Port:                   8080
Runtime:
    Concurrency:    100
    Maximum Scale:  10
    Minimum Scale:  0
    Timeout:        300
Conditions:
    Type                OK     Age    Reason
    Active              false  5d22h  NoTraffic : The target is not receiving traffic.
    ContainerHealthy    true   5d22h
    Ready               true   5d22h
    ResourcesAvailable  true   5d22h

ibmcloud ce revision list

프로젝트에서 모든 애플리케이션 개정을 나열합니다.

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

명령 옵션

--application, --app, -a
이 옵션은 지정된 애플리케이션의 개정만을 표시할 때 사용합니다. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce revision list

출력 예

Code Engine은 활성 앱 개정판 외에 애플리케이션의 최신 비활성 개정판만 보유합니다. 이전 개정판은 보유하지 않습니다.

Listing all application revisions...
OK
Name                   Application      Status  URL  Latest  Tag  Traffic  Age    Conditions  Reason
myapp-hc3u8-2           myapp            Ready                              16d    3 OK / 4
myapp-hc3u8-3           myapp            Ready        true         100%    2d8h    3 OK / 4  
newapp-mytest-00004     newapp-mytest    Ready                              4d20h  3 OK / 4
newapp-mytest-00005     newapp-mytest    Ready        true         100%     2d20h  3 OK / 4

ibmcloud ce revision logs

애플리케이션 개정판 인스턴스의 로그를 표시합니다.

ibmcloud ce revision logs (--instance REVISION_INSTANCE | --revision REVISION_NAME) [--all-containers] [--follow] [--output OUTPUT] [--quiet] [--tail TAIL] [--timestamps]

명령 옵션

--all-containers, --all
지정된 애플리케이션 개정판 인스턴스의 모든 컨테이너 로그를 표시합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--follow, -f
애플리케이션 개정판 인스턴스의 로그를 확인하십시오. 애플리케이션 개정판 인스턴스의 로그를 스트리밍하려면 이 옵션을 사용하십시오. --follow 옵션을 지정하는 경우 Ctrl+C를 입력하여 이 로그 명령을 종료해야 합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--instance, -i
특정 애플리케이션 개정판 인스턴스의 이름입니다. 인스턴스 이름을 찾으려면 revision get 명령을 사용하십시오. --revision을 지정하지 않은 경우에는 이 값이 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--revision, --rev, -r, --name, -n
지정된 애플리케이션 개정판의 모든 인스턴스 로그를 표시합니다. --instance를 지정하지 않은 경우에는 이 값이 필수입니다.
--tail, -t
지정된 애플리케이션 개정판 인스턴스의 컨테이너 로그 표시를 컨테이너당 최대 최근 행 수로 제한합니다. 예를 들어, 지정된 애플리케이션 개정 인스턴스에 대한 컨테이너 로그의 마지막 3개 행을 표시하려면 --tail 3을 지정하십시오. 이 옵션이 지정되지 않은 경우, 지정된 애플리케이션 개정 인스턴스의 컨테이너 로그의 모든 행이 표시됩니다. 이 값은 선택사항입니다. 기본값은 -1입니다.
--timestamps, --ts
로그 출력에 각 행의 시간소인을 포함합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce revision logs -n myapp-00001

출력 예

Code Engine은 활성 앱 개정판 외에 애플리케이션의 최신 비활성 개정판만 보유합니다. 이전 개정판은 보유하지 않습니다.

Getting logs for all instances of application revision 'newapp-mytest-00002'...
Getting application revision 'newapp-mytest-00002'...
OK
newapp-mytest-00002-deployment-7c87cfbf66-xnwkp/user-container:
2021-07-15 20:40:56 Listening on port 8080

Secret 명령

시크릿은 비밀번호 또는 SSH 키와 같은 민감한 구성 정보를 배치에 포함하는 방법을 제공합니다. 시크릿에 저장된 값을 참조함으로써, 배포 과정에서 민감한 정보를 분리하여 앱, 함수 또는 작업의 이식성을 유지할 수 있습니다. 프로젝트에 대한 권한이 있는 사용자는 누구나 시크릿을 볼 수 있습니다. 시크릿 정보는 이러한 사용자와 공유될 수 있다는 점을 알고 있어야 합니다. 시크릿에는 키-값 쌍의 정보가 포함되어 있습니다.

명령을 사용하려면 프로젝트secret의 컨텍스트 내에 있어야 합니다.

비밀 번호로 작업하는 방법에 대한 자세한 내용은 비밀 번호로 작업하기를 참조하세요.

secret 명령에 대한 CLI 도움말을 보려면 ibmcloud ce secret -h``을 실행하십시오.

CLI 버전 1.42.0 부터는 CLI에서 비밀 번호를 정의하고 작업하는 것이 secret 명령 그룹으로 통합됩니다. --format 옵션을 사용하여 basic_auth, generic, hmac, ssh, tls 또는 registry 과 같은 비밀 카테고리를 지정합니다. --format 옵션의 기본값은 generic 입니다.

ibmcloud ce secret create

시크릿을 작성합니다.

ibmcloud ce secret create --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--format FORMAT] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

명령 옵션

--access-key-id, --akid

HMAC 신임 정보의 access_key_id를 지정하십시오. 이 값은 선택사항입니다.

--access-key-id-prompt

HMAC 신임 정보의 access_key_id를 요청하는 프롬프트가 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--cert-chain-file, --ccf

TLS 시크릿에 대해 인증 기관(CA)에서 제공한 인증서 체인이 포함된 파일을 지정하십시오. 파일 경로를 값으로 제공해야 합니다. 이 값은 tls 비밀에 필요합니다. 이 값은 선택사항입니다.

--email, --em

레지스트리 비밀을 위해 레지스트리 서버에 액세스할 수 있는 이메일 주소입니다. 이 값은 registry 비밀에만 적용됩니다. 이 값은 선택사항입니다.

--format, --fo

시크릿의 형식입니다. 유효한 값은 basic_auth, generic, hmac, registry, ssh 또는 tls 입니다. 이 값은 선택사항입니다. 기본값은 generic입니다.

--from-env-file, -e

KEY=VALUE 형식과 일치하는 하나 이상의 행이 포함된 파일에서 일반 시크릿을 작성합니다. 파일 경로를 값으로 제공해야 합니다. 지정된 파일의 각 행은 키-값 쌍으로 추가됩니다. 지정된 파일에서 비어 있거나 #으로 시작하는 행은 무시됩니다. --from-literal 또는 --from-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 generic 비밀에만 적용됩니다.

--from-file, -f

파일에서 일반 시크릿을 작성합니다. 파일 경로를 값으로 제공해야 합니다. --from-literal 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 generic 비밀에만 적용됩니다.

--from-json-file, --json

JSON 형식의 시크릿 값이 포함된 파일 경로입니다. 이 옵션은 비밀 형식에 대해 지원됩니다 hmac 이 값은 선택 사항입니다.

--from-literal, -l

키-값 쌍에서 일반 시크릿을 작성합니다. KEY=VALUE 형식이어야 합니다. --from-file 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 generic 비밀에만 적용됩니다.

--key-path, --kp

SSH 비밀을 위한 암호화되지 않은 SSH 개인 키 파일의 경로입니다. 개인용 SSH 개인 키를 사용할 경우 이 파일은 보통 $HOME/.ssh/id_rsa(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\id_rsa(Windows)에 있습니다. 이 값은 ssh 비밀에 필요합니다. 이 값은 선택사항입니다.

--known-hosts-path, --khp

SSH 비밀을 위한 알려진 호스트 파일의 경로입니다. 이 값은 개인 키가 이전에 액세스한 호스트(특히 GitHub 또는 GitLab 호스트)에서 인증하는 데만 사용되도록 하는 보안 기능입니다. 이 파일은 보통 $HOME/.ssh/known_hosts(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\known_hosts(Windows)에 있습니다. 이 값은 ssh 비밀에만 적용됩니다. 이 값은 선택사항입니다.

-n, --name

시크릿 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 선택사항입니다.

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--password, --pw

기본 인증 또는 레지스트리 비밀의 비밀번호입니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 이 값은 basic_authregistry 비밀에 필요합니다. 이 값은 선택사항입니다.

--password-from-file, --spf

기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 파일 경로입니다. 파일의 첫 번째 행은 비밀번호에 사용됩니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은 basic_authregistry 비밀에 필요합니다. 이 값은 선택사항입니다.

--password-from-json-file, --spfj

기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 JSON 파일의 경로입니다. apikey 필드는 비밀번호에 사용됩니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은 basic_authregistry 비밀에 필요합니다. 이 값은 선택사항입니다.

--private-key-file, --pkf

cert-chain-file 옵션을 사용하여, 지정된 인증서 체인과 일치하는 ‘ TLS ’ 시크릿의 개인 키가 포함된 파일을 지정하십시오. 파일 경로를 값으로 제공해야 합니다. 이 값은 tls 비밀에 필요합니다. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 옵션은 basic_auth, generic, registry, ssh, tls 비밀에 적용됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--secret-access-key, --sak

HMAC 신임 정보의 secret_access_key를 지정하십시오. 이 값은 선택사항입니다.

--secret-access-key-prompt

HMAC 신임 정보의 secret_access_key를 요청하는 프롬프트가 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--server, -s

레지스트리 비밀을 위한 레지스트리 서버의 URL. 이 옵션은 registry 비밀에 필요합니다. 이 값은 선택사항입니다. 기본값은 us.icr.io입니다.

--username, -u

기본 인증 또는 레지스트리 비밀번호에 사용할 사용자 이름입니다. 이 옵션은 basic_authregistry 비밀에 필요합니다. 이 값은 선택사항입니다.

기본 인증 비밀의 예

기본 인증 비밀번호에는 usernamepassword 키가 포함되어 있으며 기본 HTTP 인증이 필요한 서비스에 액세스할 때 사용됩니다.

기본 인증 비밀번호를 만들기 위한 CLI 도움말을 보려면 ibmcloud ce secret create --format basic_auth 을 실행하세요.

다음 예제에서는 mysecret-basicauth 라는 이름의 기본 인증 비밀을 만듭니다. 이 비밀 번호에는 사용자 이름 myusername 이 포함되어 있으며, 비밀번호 값은 로컬 컴퓨터의 파일에서 가져옵니다. 비밀번호가 파일이나 JSON 파일에서 제공되지 않은 경우 비밀번호 값을 입력하라는 메시지가 표시됩니다.

ibmcloud ce secret create --name mysecret-basicauth --format basic_auth --username myusername --password-from-file ./password.txt

기본 인증 비밀에 대한 출력 예시

Creating basic_auth secret 'mysecret-basicauth'...
OK

일반 비밀의 예

일반 시크릿은 단순한 키-값 쌍을 저장하며 Code Engine 은 정의된 키-값 쌍이나 시크릿의 의도된 용도에 대해 가정하지 않습니다.

일반 시크릿을 만들기 위한 CLI 도움말을 보려면 ibmcloud ce secret create 또는 ibmcloud ce secret create --format generic 을 실행하세요.

--format generic CLI의 secret create 명령으로 비밀을 만들 때 기본값은 입니다.

다음 예에서는 mysecret-generic 이라는 이름의 일반 비밀을 만들고 이 비밀의 값은 --from-literal 옵션을 사용하여 키-값 쌍에 지정합니다.

ibmcloud ce secret create --name mysecret-generic --format generic --from-literal "TARGET=My literal secret"

일반 시크릿의 출력 예시

Creating generic secret 'mysecret-generic'...
OK

파일에서 값을 가져오는 일반 비밀의 예시

다음 예에서는 파일의 값을 사용하여 mysecret-fromfile이라는 시크릿을 작성합니다. --from-file 옵션을 사용하여 파일을 가리키면 파일의 모든 콘텐츠가 키-값 쌍의 값이 됩니다.

ibmcloud ce secret create --name mysecret-genericfromfile  --from-file ./value1.txt --from-file ./value2.txt
파일에서 가져온 값을 사용하는 일반 비밀의 출력 예시
Creating secret mysecret-genericfromfile...
OK

HMAC 시크릿의 예

HMAC 비밀은 access_key_idsecret_access_key 키를 포함하며 인증이 필요하지만 IBM Cloud® Identity and Access Management API 키를 지원하지 않는 S3-compatible 도구 및 라이브러리와 함께 사용됩니다.

HMAC 시크릿을 만들기 위한 CLI 도움말을 보려면 ibmcloud ce secret create --format hmac 을 실행하세요.

다음 예에서는 mysecret-hmac 라는 이름의 HMAC 시크릿을 만듭니다. 이 비밀 번호에는 메시지가 표시될 때 입력한 access_key_idsecret_access_key 값이 포함됩니다. 두 옵션 중 하나라도 명령어 또는 JSON 파일에서 제공되지 않으면 해당 값을 입력하라는 메시지가 표시됩니다.

ibmcloud ce secret create --name mysecret-hmac --format hmac --access-key-id-prompt --secret-access-key-prompt

HMAC 시크릿의 출력 예시

Creating hmac_auth secret 'mysecret-hmac'...
OK

레지스트리 비밀의 예

레지스트리 비밀은 컨테이너 레지스트리에 액세스하기 위한 자격 증명을 저장합니다.

레지스트리 비밀 만들기에 대한 CLI 도움말을 보려면 ibmcloud ce secret create --format registry 을 실행하세요.

다음 예제에서는 us.icr.io 레지스트리 서버에 있는 IBM Cloud Container Registry 인스턴스에 mysecret-registry 라는 이름의 레지스트리 비밀을 만들고 usernamepassword 에 대한 자격 증명을 지정합니다.

ibmcloud ce secret create --name mysecret-registry --format registry --server us.icr.io --username iamapikey --password API_KEY

레지스트리 비밀에 대한 출력 예시

Creating registry secret `mysecret-registry`...
OK

SSH 비밀의 예

예를 들어 GitHub 또는 GitLab 와 같은 Git 저장소에 인증하는 것과 같이 SSH 키를 사용하여 서비스에 인증하기 위한 자격 증명을 저장합니다.

SSH 비밀번호를 만들기 위한 CLI 도움말을 보려면 ibmcloud ce secret create --format ssh 을 실행하세요.

다음 예에서는 known_hosts 파일에 포함된 호스트에 대해 mysecret-ssh 라는 이름의 SSH 비밀을 만들고 /<filepath>/.ssh/<key_name> 에 있는 암호화되지 않은 SSH 개인 키 파일로 인증합니다(여기서 <filepath> 은 시스템의 경로입니다). 이 명령에는 이름과 키 경로가 필요하며 알려진 호스트 파일 경로와 같은 다른 선택적 인자도 사용할 수 있습니다.

ibmcloud ce secret create --name mysecret-ssh --format ssh --key-path ~/.ssh/<key_name> --known-hosts-path  ~/.ssh/known_hosts

SSH 비밀번호의 출력 예시

Creating SSH secret `mysecret-ssh`...
OK

TLS 비밀의 예

전송 계층 보안( TLS ) 비밀에는 모든 중간 인증서를 포함하여 서명된 TLS 인증서와 인증 기관(CA)의 해당 개인 키가 포함되어 있습니다. 사용자 정의 도메인 매핑으로 작업할 때는 TLS 비밀 번호를 사용하세요.

TLS 비밀 생성에 대한 CLI 도움말을 보려면 ibmcloud ce secret create --format tls 을 실행하세요.

다음 예에서는 mysecret-tls 이라는 이름의 TLS 시크릿을 만듭니다. 사용자 지정 도메인에 해당하는 인증서 체인은 certificate.txt 파일에 포함되어 있고 일치하는 개인 키 파일은 privatekey.txt 파일에 포함되어 있습니다. 이 두 파일은 모두 로컬 워크스테이션의 루트 디렉터리에 있습니다.

ibmcloud ce secret create --name mysecret-tls  --format tls  --cert-chain-file certificate.txt --private-key-file privatekey.txt

TLS 비밀에 대한 출력 예시

Creating TLS secret `mysecret-tls`...
OK

ibmcloud ce secret delete

시크릿을 삭제합니다.

ibmcloud ce secret delete --name SECRET_NAME [--force] [--ignore-not-found] [--quiet]

명령 옵션

--name, -n
시크릿 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce secret delete --name mysecret-genericfromfile -f

출력 예

Deleting secret mysecret-genericfromfile...
OK

ibmcloud ce secret get

시크릿의 세부사항을 표시합니다.

ibmcloud ce secret get --name SECRET_NAME [--decode] [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
시크릿 이름입니다. 이 값은 필수입니다.
--decode, -d
세부사항에서 디코딩된 대로Data 출력을 표시합니다. 이 옵션을 지정하지 않으면 Data 세부사항이 base64로 인코딩됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce secret get --name mysecret-basicauth

출력 예

Getting secret 'mysecret-basicauth'...
OK
Name:          mysecret-basicauth
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Format:        basic_auth
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           66s
Created:       2021-03-10T18:44:18-05:00
Data:    
---
password: REDACTED
username: bXl1c2VybmFtZQ==

ibmcloud ce secret list

프로젝트의 모든 시크릿을 나열합니다.

ibmcloud ce secret list [--all] [--format FORMAT] [--output OUTPUT] [--quiet] [--sort-by SORT_BY]

명령 옵션

--all, -a
Code Engine 에서 관리하지 않는 basic_auth, generic, registry, ssh, tls, other 비밀을 포함한 모든 형식의 모든 비밀을 표시합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--format, --fo
본인확인정보 표시를 필터링하려면 이 옵션을 지정합니다. 유효한 값은 basic_auth, generic, registry, sshtls 입니다. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

이 명령은 프로젝트의 모든 시크릿을 나열합니다.

ibmcloud ce secret list

출력 예

Listing secrets...
OK
Name                          Format          Data  Age  
ce-auto-icr-private-us-south  registry        4     333d  
ce-auto-private-icr-us-south  registry        4     335d  
myregistry-seccmd             registry        4     3h31m  
mysecret-basicauth            basic_auth      2     7m37s  
mysecret-generic              generic         1     7m7s  
mysecret-genericfromfile      generic         2     2m29s  
mysecret-hmac                 hmac_auth       2     21m
mysecret-registry             registry        4     111s  
mysecret-ssh                  ssh_auth        2     42m  
mysecret-tls                  tls             2     3h47m

ibmcloud ce secret update

시크릿을 업데이트합니다.

ibmcloud ce secret update --name SECRET_NAME (--from-env-file FILE | --from-file FILE | --from-file KEY=FILE | --from-literal KEY=VALUE | --rm KEY) [--access-key-id ACCESS_KEY_ID] [--access-key-id-prompt] [--cert-chain-file CERT_CHAIN_FILE] [--email EMAIL] [--from-json-file FROM_JSON_FILE] [--key-path KEY_PATH] [--known-hosts-path KNOWN_HOSTS_PATH] [--output OUTPUT] [--password PASSWORD] [--password-from-file PASSWORD_FROM_FILE] [--password-from-json-file PASSWORD_FROM_JSON_FILE] [--private-key-file PRIVATE_KEY_FILE] [--quiet] [--secret-access-key SECRET_ACCESS_KEY] [--secret-access-key-prompt] [--server SERVER] [--username USERNAME]

명령 옵션

--name, -n
시크릿 이름입니다. 이 값은 필수입니다.
--access-key-id, --akid
HMAC 신임 정보의 access_key_id를 지정하십시오. 이 값은 선택사항입니다.
--access-key-id-prompt
HMAC 신임 정보의 access_key_id를 요청하는 프롬프트가 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--cert-chain-file, --ccf
TLS 시크릿에 대해 인증 기관(CA)에서 제공한 인증서 체인이 포함된 파일을 지정하십시오. 파일 경로를 값으로 제공해야 합니다. 이 값은 선택사항입니다.
--email, --em
레지스트리 비밀을 위해 레지스트리 서버에 액세스할 수 있는 이메일 주소입니다. 이 값은 선택사항입니다.
--from-env-file, -e
KEY=VALUE 형식과 일치하는 하나 이상의 행이 포함된 파일에서 일반 시크릿을 업데이트합니다. 파일 경로를 값으로 제공해야 합니다. 지정된 파일의 각 행은 키-값 쌍으로 추가됩니다. 지정된 파일에서 비어 있거나 #으로 시작하는 행은 무시됩니다. --from-literal 또는 --from-file을 지정하지 않은 경우에는 이 값이 필수입니다.
--from-file, -f
파일에서 일반 시크릿을 업데이트합니다. 파일 경로를 값으로 제공해야 합니다. --from-literal 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다.
--from-json-file, --json
JSON 형식의 시크릿 값이 포함된 파일 경로입니다. 이 옵션은 비밀 형식에 대해 지원됩니다 hmac 이 값은 선택 사항입니다.
--from-literal, -l
키-값 쌍에서 일반 시크릿을 업데이트합니다. KEY=VALUE 형식이어야 합니다. --from-file 또는 --from-env-file을 지정하지 않은 경우에는 이 값이 필수입니다. 이 옵션은 여러 번 지정할 수 있습니다.
--key-path, --kp
SSH 비밀을 위한 암호화되지 않은 SSH 개인 키 파일의 경로입니다. 개인용 SSH 개인 키를 사용할 경우 이 파일은 보통 $HOME/.ssh/id_rsa(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\id_rsa(Windows)에 있습니다. 이 값은 선택사항입니다.
--known-hosts-path, --khp
SSH 비밀을 위한 알려진 호스트 파일의 경로입니다. 이 값은 개인 키가 이전에 액세스한 호스트(특히 GitHub 또는 GitLab 호스트)에서 인증하는 데만 사용되도록 하는 보안 기능입니다. 이 파일은 보통 $HOME/.ssh/known_hosts(Mac OS 또는 Linux) 또는 %HOMEPATH%\.ssh\known_hosts(Windows)에 있습니다. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--password, --pw
기본 인증 또는 레지스트리 비밀의 비밀번호입니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 이 값은 선택사항입니다.
--password-from-file, --spf
기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 파일 경로입니다. 파일의 첫 번째 행은 비밀번호에 사용됩니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은 선택사항입니다.
--password-from-json-file, --spfj
기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 JSON 파일의 경로입니다. apikey 필드는 비밀번호에 사용됩니다. --password, --password-from-file 또는 --password-from-json-file 옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은 선택사항입니다.
--private-key-file, --pkf
cert-chain-file 옵션을 사용하여, 지정된 인증서 체인과 일치하는 ‘ TLS ’ 시크릿의 개인 키가 포함된 파일을 지정하십시오. 파일 경로를 값으로 제공해야 합니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--rm
키 이름을 지정하여 일반 시크릿에서 개별 키-값 쌍을 제거합니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--secret-access-key, --sak
HMAC 신임 정보의 secret_access_key를 지정하십시오. 이 값은 선택사항입니다.
--secret-access-key-prompt
HMAC 신임 정보의 secret_access_key를 요청하는 프롬프트가 표시됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--server, -s
레지스트리 비밀을 위한 레지스트리 서버의 URL. 이 값은 선택사항입니다. 기본값은 us.icr.io입니다.
--username, -u
기본 인증 또는 레지스트리 비밀번호에 사용할 사용자 이름입니다. 이 값은 선택사항입니다.

이 예에서는 업데이트된 인증서 및 개인 키로 TLS 비밀을 업데이트합니다.

ibmcloud ce secret update --name mysecret-tls --cert-chain-file certificate2.txt --private-key-file privatekey2.txt

출력 예

Updating secret mysecret-tls..
OK

Subscription cos 명령

분산 환경에서는 다른 컴포넌트(일반적으로 이벤트 생성자라고 함)에서 생성된 메시지(이벤트)에 애플리케이션 또는 작업이 반응하도록 하려는 경우가 많습니다. Code Engine에서는 애플리케이션 또는 작업이 이벤트 생성자를 구독하여 관심있는 이벤트를 수신할 수 있습니다. 이벤트 정보는 애플리케이션의 경우 POST HTTP 요청으로서, 작업의 경우 환경 변수로서 수신합니다.

Object Storage 이벤트 생성자는 오브젝트 스토리지 버킷의 오브젝트가 변경될 때 이벤트를 생성합니다. 예를 들어, 오브젝트가 버킷에 추가될 때 애플리케이션이 이벤트를 수신한 후 해당 변경사항을 기준으로 조치를 수행할 수 있으며, 이때 새 오브젝트를 이용할 수도 있습니다.

명령을 사용하려면 프로젝트subscription cos의 컨텍스트 내에 있어야 합니다.

IBM Cloud Object Storage 구독 작업에 대한 자세한 정보는 IBM Cloud Object Storage 이벤트 생성자 작업을 참조하십시오. Code Engine의 구독 작업에 대한 자세한 정보는 구독 시작하기를 참조하십시오.

subscription cos 명령에 subscription 또는 sub를 사용할 수 있습니다. subscription cos 명령에 대한 CLI 도움말을 보려면 ibmcloud ce sub cos -h를 실행하십시오.

ibmcloud ce subscription cos create

IBM Cloud Object Storage 이벤트 구독을 작성합니다.

ibmcloud ce subscription cos create --name COS_SOURCE_NAME --destination DESTINATION_REF --bucket BUCKET_NAME [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--bucket, -b

이벤트에 대한 버킷입니다. 대상 및 버킷은 프로젝트의 동일한 지역에 있어야 합니다. 이 값은 필수입니다.

--destination, -d

이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 필수입니다.

-n, --name

IBM Cloud Object Storage 이벤트 구독의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--destination-type, --dt
destination의 유형입니다. 올바른 값은 appjob입니다. 이 값은 선택사항입니다. 기본값은 app입니다.
--event-type, -e

감시할 이벤트 유형입니다. 유효한 값은 delete, writeall 입니다. 이 값은 선택사항입니다. 기본값은 all입니다.

--extension, --ext

대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.

--force, -f

IBM Cloud Object Storage 이벤트 구독을 강제로 작성합니다. 이 옵션은 지정된 대상의 유효성 검증을 건너뜁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--no-wait, --nw

IBM Cloud Object Storage 이벤트 구독을 작성하며 구독이 준비될 때까지 대기하지 않습니다. --no-wait 옵션을 지정할 경우 구독 작성이 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription cos get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--path

이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

--prefix, -p

IBM Cloud Object Storage 오브젝트의 접두부입니다. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--suffix, -s

IBM Cloud Object Storage 오브젝트의 접미부입니다. 접미부를 지정할 때 파일 유형을 고려하십시오. 이 값은 선택사항입니다.

--wait, -w

IBM Cloud Object Storage 이벤트 구독을 작성하며 구독이 준비될 때까지 대기합니다. --wait 옵션을 지정할 경우 구독이 준비될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 작성이 대기합니다. 구독이 지정된 --wait-timeout 기간 내에 완료되지 않으면 IBM Cloud Object Storage 이벤트 구독 작성이 실패합니다. 이 값은 선택사항입니다. 기본값은 true입니다.

--wait-timeout, --wto

IBM Cloud Object Storage 이벤트 구독이 준비될 때까지 대기하는 시간(초)입니다. --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 15입니다.

IBM Cloud Object Storage 구독은 Object Storage 버킷에 대한 변경사항을 청취합니다. 다음 예에서는 mycosevent 앱에 첨부된 mybucket이라는 버킷에 대해 myapp라는 COS 구독을 작성합니다. --destination-type 옵션은 destination의 유형을 지정하며, app 또는 job입니다. 이 예의 경우 --destination-type은 이 옵션의 기본값인 app입니다. 이벤트가 https://<base application URL>/events로 전송되도록 --path 옵션을 사용하여 /events 경로로 이벤트를 전송합니다.

ibmcloud ce subscription cos create --name mycosevent --destination myapp --bucket mybucket --destination-type app --path /events

출력 예

Creating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

ibmcloud ce subscription cos delete

IBM Cloud Object Storage 이벤트 구독을 삭제합니다.

ibmcloud ce subscription cos delete --name COS_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--name, -n
IBM Cloud Object Storage 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--no-wait, --nw
IBM Cloud Object Storage 이벤트 구독을 삭제하며 구독이 삭제될 때까지 대기하지 않습니다. --no-wait 옵션을 지정할 경우 구독 삭제가 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription cos get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait, -w
IBM Cloud Object Storage 이벤트 구독을 삭제하며 구독이 삭제될 때까지 대기합니다. --wait 옵션을 지정할 경우 구독이 삭제될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 삭제가 대기합니다. 이 명령은 애플리케이션이 삭제될 때 또는 --wait-timeout에 도달할 때마다 종료됩니다. 이 값은 선택사항입니다. 기본값은 true입니다.
--wait-timeout, --wto
IBM Cloud Object Storage 이벤트 구독이 삭제될 때까지 대기하는 시간(초)입니다. --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 15입니다.

ibmcloud ce subscription cos delete --name mycosevent -f

출력 예

Deleting COS source 'mycosevent'...
OK

ibmcloud ce subscription cos get

IBM Cloud Object Storage 이벤트 구독의 세부사항을 표시합니다. 표시되는 속성은 Name, Destination, Bucket, Event Type, Prefix, Suffix, Ready, Age입니다. 특정 세부사항을 보려면 | grep <attribute>를 첨부하십시오.

ibmcloud ce subscription cos get --name COS_SOURCE_NAME [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
IBM Cloud Object Storage 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce subscription cos get --name mycosevent

출력 예

Getting COS source 'mycosevent'...
OK
Name:          mycosevent
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           12s  
Created:       2021-03-14T13:28:45-05:00  
Destination:  App:myapp
Bucket:       mybucket
EventType:    all
Ready:        true  
Conditions:    
    Type            OK    Age  Reason  
    CosConfigured   true  10s    
    Ready           true  10s    
    ReadyForEvents  true  10s    
    SinkProvided    true  10s    
Events:        
    Type    Reason          Age  Source                Messages  
    Normal  CosSourceReady  11s  cossource-controller  CosSource is ready  

Readytrue이면 COS 구독은 COS 버킷의 변경사항에 따라 이벤트를 트리거할 준비가 된 것입니다.

ibmcloud ce subscription cos list

프로젝트에 있는 모든 IBM Cloud Object Storage 이벤트 구독을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce subscription cos list

출력 예

Listing COS sources...
OK
Name        Age  Ready  Bucket        EventType  Prefix  Suffix  Destination
mycosevent  20m  true   mycosbucket  all                         http://myapp.2706b22d-676b.svc.cluster.local

ibmcloud ce subscription cos update

IBM Cloud Object Storage 이벤트 구독을 업데이트합니다.

ibmcloud ce subscription cos update --name COS_SOURCE_NAME [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--event-type EVENT_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--prefix PREFIX] [--quiet] [--suffix SUFFIX]

명령 옵션

--name, -n
IBM Cloud Object Storage 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--destination, -d
이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 선택사항입니다.
--destination-type, --dt
destination의 유형입니다. 올바른 값은 appjob입니다. 이 값은 선택사항입니다.
--event-type, -e
감시할 이벤트 유형입니다. 유효한 값은 delete, writeall 입니다. 이 값은 선택사항입니다.
--extension, --ext
대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.
--extension-rm, --ext-rm
키 이름을 지정하여 대상으로 보낼 CloudEvents 확장을 제거하십시오. --ext-rm 옵션당 하나의 확장자를 지정합니다. 예: --ext-rm extA --ext-rm extB. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--path
이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.
--prefix, -p
IBM Cloud Object Storage 오브젝트의 접두부입니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--suffix, -s
IBM Cloud Object Storage 오브젝트의 접미부입니다. 접미부를 지정할 때 파일 유형(확장자)을 고려하십시오. 이 값은 선택사항입니다.

다음 예에서는 쓰기 이벤트만 청취하도록 mycosevent라는 COS 구독을 업데이트합니다.

ibmcloud ce subscription cos update --name mycosevent --event-type write

출력 예

Updating COS source 'mycosevent'...
Run 'ibmcloud ce subscription cos get -n mycosevent' to check the COS source status.
OK

Subscription cron 명령

분산 환경에서는 다른 컴포넌트(일반적으로 이벤트 생성자라고 함)에서 생성된 메시지(이벤트)에 애플리케이션 또는 작업이 반응하도록 하려는 경우가 많습니다. Code Engine에서는 애플리케이션 또는 작업이 이벤트 생성자를 구독하여 관심있는 이벤트를 수신할 수 있습니다. 이벤트 정보는 애플리케이션의 경우 POST HTTP 요청으로서, 작업의 경우 환경 변수로서 수신합니다.

cron 이벤트 생성자는 cron을 기반으로 하며 정기적으로 이벤트를 생성합니다. 잘 정의된 간격 또는 특정 시간에 조치를 수행해야 하는 경우 Cron 이벤트 생성자를 사용하십시오.

명령을 사용하려면 프로젝트subscription cron의 컨텍스트 내에 있어야 합니다.

IBM Cloud Object Storage 구독 작업에 대한 자세한 정보는 주기적 타이머(cron) 이벤트 생성자 작업을 참조하십시오. Code Engine의 구독 작업에 대한 자세한 정보는 구독 시작하기를 참조하십시오.

subscription cron 명령에 subscription 또는 sub를 사용할 수 있습니다. subscription cron 명령에 대한 CLI 도움말을 보려면 ibmcloud ce sub cron -h를 실행하십시오.

ibmcloud ce subscription cron create

Cron 이벤트 구독을 작성합니다.

ibmcloud ce subscription cron create --name CRON_SOURCE_NAME  --destination DESTINATION_REF [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--destination, -d

이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 필수입니다.

-n, --name

Cron 이벤트 구독의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--content-type, --ct
--data 또는 --data-base64 옵션의 매체 유형입니다. 예를 들어, application/json, application/x-www-form-urlencoded, text/htmltext/plain입니다. 이 값은 선택사항입니다.
--da, --data

대상으로 전송할 데이터입니다(예: '{ "message": "Hello world!" }'). --data 옵션을 지정하는 경우에는 --data-base64 옵션을 사용하지 마십시오.

이 값은 선택사항입니다.

--data-base64, --db
대상에 전송할, Base64로 인코딩된 데이터로 예를 들면 Q29kZSBFbmdpbmU=과 같습니다. --data-base64 옵션을 지정하는 경우에는 --data 옵션을 사용하지 마십시오. 이 값은 선택사항입니다.
--destination-type, --dt

destination의 유형입니다. 유효한 값은 app, functionjob 입니다. 이 값은 선택사항입니다. 기본값은 app입니다.

--extension, --ext

대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.

--force, -f

Cron 이벤트 구독을 강제로 작성합니다. 이 옵션은 지정된 대상의 유효성 검증을 건너뜁니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--no-wait, --nw

Cron 이벤트 구독을 작성하며 구독이 준비될 때까지 대기하지 않습니다. --no-wait 옵션을 지정할 경우 구독 작성이 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription cron get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--path

이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--schedule, -s

이벤트가 트리거되는 빈도를 crontab 형식으로 스케줄합니다. 예를 들어 2분 빈도의 경우 '*/2 * * * *'(문자열 형식)를 지정하십시오. 기본적으로 Cron 이벤트는 1분마다 트리거되며 UTC 시간대로 설정됩니다. 시간대를 수정하려면 --time-zone 옵션을 사용하십시오. 이 값은 선택사항입니다.

--time-zone, --tz

Cron 이벤트의 시간대를 설정하십시오(예: Asia/Tokyo). --schedule 옵션을 지정하는 경우에는 이 옵션을 사용하여 시간대를 지정하십시오. 올바른 시간대 값은 시간대 데이터베이스를 참조하십시오. 이 값은 선택사항입니다. 기본값은 UTC입니다.

--wait, -w

Cron 이벤트 구독을 작성하며 구독이 준비될 때까지 대기합니다. --wait 옵션을 지정할 경우 구독이 준비될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 작성이 대기합니다. 구독이 지정된 --wait-timeout 기간 내에 준비되지 않으면 Cron 이벤트 구독 작성이 실패합니다. 이 값은 선택사항입니다. 기본값은 true입니다.

--wait-timeout, --wto

Cron 이벤트 구독이 준비될 때까지 대기하는 시간(초)입니다. --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 15입니다.

다음 예에서는 mycronevent이라는 작업에 2분마다 Cron 이벤트를 전달하는 myjob라는 Cron 구독을 작성합니다.

ibmcloud ce subscription cron create --name mycronevent --destination myjob --schedule '*/2 * * * *' --destination-type job

출력 예

Creating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

ibmcloud ce subscription cron delete

Cron 이벤트 구독을 삭제합니다.

ibmcloud ce subscription cron delete --name CRON_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--name, -n
Cron 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--no-wait, --nw
Cron 이벤트 구독을 삭제하며 구독이 삭제될 때까지 대기하지 않습니다. --no-wait 옵션을 지정할 경우 구독 삭제가 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription cron get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait, -w
Cron 이벤트 구독을 삭제하며 구독이 삭제될 때까지 대기합니다. --wait 옵션을 지정할 경우 구독이 삭제될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 삭제가 대기합니다. 이 명령은 애플리케이션이 삭제될 때 또는 --wait-timeout에 도달할 때마다 종료됩니다. 이 값은 선택사항입니다. 기본값은 true입니다.
--wait-timeout, --wto
Cron 이벤트 구독이 삭제될 때까지 대기하는 시간(초)입니다. --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 15입니다.

ibmcloud ce subscription cron delete --name mycronevent -f

출력 예

Deleting cron source 'mycronevent'...
OK

ibmcloud ce subscription cron get

Cron 이벤트 구독의 세부사항을 표시합니다.

ibmcloud ce subscription cron get --name CRON_SOURCE_NAME [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
Cron 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce subscription cron get --name mycronevent

출력 예

Getting cron source 'mycronevent'...
OK
Name:          mycronevent  
ID:            abcdefgh-abcd-abcd-abcd-fb6be2347a14  
Project Name:  myproject  
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111  
Age:           18s  
Created:       2021-03-14T13:33:53-05:00  
Destination:  App:kapp  
Schedule:     */2 * * * *  
Time Zone:    UTC  
Ready:        true
Events:    
    Type     Reason           Age                Source                 Messages  
    Normal   FinalizerUpdate  19s                pingsource-controller  Updated "mycronevent" finalizers  

Readytrue이면 Cron 구독이 지정된 스케줄에 따라 이벤트를 트리거할 준비가 된 것입니다.

ibmcloud ce subscription cron list

프로젝트의 모든 Cron 이벤트 구독을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce subscription cron list

출력 예

Listing cron sources...
OK
Name         Age  Ready  Destination                                   Schedule     Data
mycronevent  96m  true   http://myapp.cd4200a7-5037.svc.cluster.local  */2 * * * *

ibmcloud ce subscription cron update

Cron 이벤트 구독을 업데이트합니다.

ibmcloud ce subscription cron update --name CRON_SOURCE_NAME [--content-type CONTENT_TYPE] [--data DATA] [--data-base64 DATA_BASE64] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--path PATH] [--quiet] [--schedule SCHEDULE] [--time-zone TIME_ZONE]

명령 옵션

--name, -n

Cron 이벤트 구독의 이름입니다. 이 값은 필수입니다.

--content-type, --ct

--data 또는 --data-base64 옵션의 매체 유형입니다. 예를 들어, application/json, application/x-www-form-urlencoded, text/htmltext/plain입니다. 이 값은 선택사항입니다.

--da, --data

대상으로 전송할 데이터입니다(예: '{ "message": "Hello world!" }'). --data 옵션을 지정하는 경우에는 --data-base64 옵션을 사용하지 마십시오.

이 값은 선택사항입니다.

--data-base64, --db
대상에 전송할, Base64로 인코딩된 데이터로 예를 들면 Q29kZSBFbmdpbmU=과 같습니다. --data-base64 옵션을 지정하는 경우에는 --data 옵션을 사용하지 마십시오. 이 값은 선택사항입니다.
--destination, -d

이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 선택사항입니다.

--destination-type, --dt

destination의 유형입니다. 유효한 값은 app, functionjob 입니다. 이 값은 선택사항입니다.

--extension, --ext

대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.

--extension-rm, --ext-rm

키 이름을 지정하여 대상으로 보낼 CloudEvents 확장을 제거하십시오. --ext-rm 옵션당 하나의 확장자를 지정합니다. 예: --ext-rm extA --ext-rm extB. 이 값은 선택사항입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--path

이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--schedule, -s

이벤트가 트리거되는 빈도를 crontab 형식으로 스케줄합니다. 예를 들어 2분 빈도의 경우 '*/2 * * * *'(문자열 형식)를 지정하십시오. 기본적으로 Cron 이벤트는 1분마다 트리거되며 UTC 시간대로 설정됩니다. 시간대를 수정하려면 --time-zone 옵션을 사용하십시오. 이 값은 선택사항입니다.

--time-zone, --tz

Cron 이벤트의 시간대를 설정하십시오(예: Asia/Tokyo). --schedule 옵션을 지정하는 경우에는 이 옵션을 사용하여 시간대를 지정하십시오. 올바른 시간대 값은 시간대 데이터베이스를 참조하십시오. 이 값은 선택사항입니다.

다음 예에서는 mycronevent이라는 작업에 1시간마다 Cron 이벤트를 전달하는 myjob라는 Cron 소스 구독을 업데이트합니다.

ibmcloud ce subscription cron update --name mycronevent --destination myjob --schedule '0 * * * *' --destination-type job

출력 예

Updating cron source 'mycronevent'...
Run 'ibmcloud ce subscription cron get -n mycronevent' to check the cron source status.
OK

구독 kafka 명령

분산 환경에서는 다른 컴포넌트(일반적으로 이벤트 생성자라고 함)에서 생성된 메시지(이벤트)에 애플리케이션 또는 작업이 반응하도록 하려는 경우가 많습니다. Code Engine에서는 애플리케이션 또는 작업이 이벤트 생성자를 구독하여 관심있는 이벤트를 수신할 수 있습니다. 이벤트 정보는 애플리케이션의 경우 POST HTTP 요청으로서, 작업의 경우 환경 변수로서 수신합니다.

Kafka 이벤트 프로듀서는 Kafka 인스턴스에 새 메시지가 표시되는지 감시합니다. 일련의 주제에 대한 Code Engine Kafka 구독을 만들면 앱 또는 작업은 주제 중 하나에 나타나는 각 새 메시지에 대해 별도의 이벤트를 수신합니다.

명령을 사용하려면 프로젝트subscription kafka의 컨텍스트 내에 있어야 합니다.

Kafka 이벤트 구독 작업에 대한 자세한 내용은 Kafka 이벤트 프로듀서 작업을 참조하세요. Code Engine의 구독 작업에 대한 자세한 정보는 구독 시작하기를 참조하십시오.

subscription kafka 명령에 subscription 또는 sub를 사용할 수 있습니다. subscription 명령에 대한 CLI 도움말을 보려면 ibmcloud ce sub kafka -h``을 실행하십시오.

ibmcloud ce subscription kafka create

Kafka 이벤트 구독을 생성합니다.

ibmcloud ce subscription kafka create --name KAFKA_SOURCE_NAME --destination DESTINATION_REF --topic TOPIC --broker BROKER [--consumer-group CONSUMER_GROUP] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--force] [--no-wait] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--username USERNAME] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--broker, -b

Kafka 소스에서 브로커를 설정합니다. 브로커는 소비자가 연결되는 Kafka 서버입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 필수입니다.

--destination, -d

이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 필수입니다.

-n, --name

Kafka 이벤트 구독의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오.

  • 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
  • 이름은 253자 이하여야 하며 소문자, 숫자, 마침표(.), 하이픈(-)을 포함할 수 있습니다.

이 값은 필수입니다.

--topic, -t
Kafka 소스에서 토픽을 설정합니다. 토픽은 소비할 메시지를 필터링하는 데 사용됩니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 필수입니다.
--consumer-group, --cg

이벤트의 소비자 그룹 이름입니다. 이 값은 선택사항입니다.

--destination-type, --dt

destination의 유형입니다. 올바른 값은 appjob입니다. 이 값은 선택사항입니다. 기본값은 app입니다.

--extension, --ext

대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.

--force, -f

Kafka 이벤트 구독을 강제로 생성합니다. 이 옵션을 사용하면 지정된 대상 및 비밀에 대한 유효성 검사가 생략됩니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--no-wait, --nw

Kafka 이벤트 구독을 생성하고, 구독이 준비될 때까지 기다리지 마십시오. --no-wait 옵션을 지정할 경우 구독 작성이 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription kafka get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.

--output, -o

명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.

--password, -p

Kafka 인스턴스 인증에 사용되는 비밀번호입니다. --password 옵션을 지정하는 경우, --secret 옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다.

--path

이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.

--quiet, -q

명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

--secret, -s

Kafka 인스턴스에 대한 인증에 사용되며, usernamepassword 키를 모두 포함하는 비밀의 이름입니다. --secret 옵션을 지정하는 경우, --username 또는 --password 옵션을 함께 지정해서는 안 됩니다. 이 값은 선택사항입니다.

--username, -u

Kafka 인스턴스 인증에 사용되는 사용자 이름입니다. --username 옵션을 지정하는 경우, 반드시 --password 옵션을 함께 지정해야 하며, --secret 옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다. 기본값은 token입니다.

--wait, -w

Kafka 이벤트 구독을 생성하고, 구독이 준비될 때까지 기다립니다. --wait 옵션을 지정할 경우 구독이 준비될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 작성이 대기합니다. 지정된 --wait-timeout 기간 내에 구독이 준비되지 않으면, Kafka 이벤트 구독 생성이 실패합니다. 이 값은 선택사항입니다. 기본값은 true입니다.

--wait-timeout, --wto

Kafka 이벤트 구독이 준비될 때까지 대기할 시간(초 단위). --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 120입니다.

다음 예제에서는 mykafkaevent 이라는 Kafka 이벤트 구독을 생성하여 Kafka 이벤트를 kafka-receiver-app 이라는 수신 앱으로 전달합니다. 주제에 대한 각 브로커에 대해 --broker 옵션을 지정합니다. --destination 옵션은 이벤트를 수신하는 Code Engine 리소스를 지정합니다. kafka-subscription-secret 에서 메시지 브로커에 액세스할 수 있는 자격 증명을 제공합니다.

ibmcloud ce subscription kafka create --name mykafkasubscription --destination kafka-receiver-app --secret kafka-subscription-secret --topic kafka-topic1 --broker broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker  broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093 --broker broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093

출력 예

Creating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

ibmcloud ce subscription kafka delete

Kafka 이벤트 구독을 삭제합니다.

ibmcloud ce subscription kafka delete --name KAFKA_SOURCE_NAME [--force] [--ignore-not-found] [--no-wait] [--quiet] [--wait] [--wait-timeout WAIT_TIMEOUT]

명령 옵션

--name, -n
Kafka 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--force, -f
확인 없이 강제로 삭제합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--ignore-not-found, --inf
찾을 수 없는 경우 실패하지 마십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--no-wait, --nw
Kafka 이벤트 구독을 삭제하고, 구독이 삭제될 때까지 기다리지 마십시오. --no-wait 옵션을 지정할 경우 구독 삭제가 시작되며 대기하지 않습니다. 구독 상태를 확인하려면 subscription kafka get 명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은 false입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--wait, -w
Kafka 이벤트 구독을 삭제하고, 구독이 삭제될 때까지 기다립니다. --wait 옵션을 지정할 경우 구독이 삭제될 때까지 --wait-timeout 옵션에 설정된 최대 시간(초) 동안 구독 삭제가 대기합니다. 이 명령은 애플리케이션이 삭제될 때 또는 --wait-timeout에 도달할 때마다 종료됩니다. 이 값은 선택사항입니다. 기본값은 true입니다.
--wait-timeout, --wto
Kafka 이벤트 구독이 삭제될 때까지 대기할 시간(초). --wait 옵션을 지정한 경우 이 값이 필수입니다. --no-wait 옵션을 지정한 경우 이 값이 무시됩니다. 기본값은 15입니다.

ibmcloud ce subscription kafka delete --name mykafkasubscription -f

출력 예

Deleting Kafka event subscription 'mykafkasubscription'...
OK

ibmcloud ce subscription kafka get

Kafka 이벤트 구독에 대한 세부 정보를 표시합니다.

ibmcloud ce subscription kafka get --name KAFKA_SOURCE_NAME [--output OUTPUT] [--quiet]

명령 옵션

--name, -n
Kafka 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce subscription kafka get --name mykafkasubscription

출력 예

Getting Kafka event subscription 'mykafkasubscription'...
OK
Name:          mykafkasubscription  
[...]
Destination Type:                 app
Destination:                      kafka-receiver-app2
Brokers:
broker-3-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-5-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-0-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-1-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-4-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
broker-2-abcdabcdabcdabcd.kafka.svc07.us-south.eventstreams.cloud.ibm.com:9093
Consumer Group:                   knative-kafka-source-a4072fe1-1dfa-4470-9d07-bf7a0ff8e340
Topics:
kafka-topic1
Secret key reference (user):      kafka-subscription-secret.username
Secret key reference (password):  kafka-subscription-secret.password
Ready:                            true
Conditions:
Type                     OK    Age  Reason
ConnectionEstablished    true  24s
InitialOffsetsCommitted  true  24s
Ready                    true  24s
Scheduled                true  24s
SinkProvided             true  24s
Events:
Type     Reason           Age  Source                  Messages
Normal   FinalizerUpdate  26s  kafkasource-controller  Updated "mykafkasubscription" finalizers

Readytrue 일 때, Kafka 구독은 지정된 일정에 따라 이벤트를 트리거할 준비가 된 것입니다.

ibmcloud ce subscription kafka list

프로젝트 내의 모든 ‘ Kafka ’ 이벤트 구독을 나열합니다.

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

명령 옵션

--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--sort-by, -s
목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은 nameage입니다. 이 값은 선택사항입니다. 기본값은 name입니다.

ibmcloud ce subscription kafka list

출력 예

Listing Kafka event subscriptions...
OK
Name                 Age  Ready  Destination Type  Destination          Path  Consumer Group                                             Reason  
mykafkasubscription  94s  true   app               kafka-receiver-app        knative-kafka-source-dc367965-15e4-44f3-bedf-25d453524a68

ibmcloud ce subscription kafka update

Kafka 이벤트 구독을 업데이트합니다.

ibmcloud ce subscription kafka update --name KAFKA_SOURCE_NAME [--broker BROKER] [--destination DESTINATION] [--destination-type DESTINATION_TYPE] [--extension EXTENSION] [--extension-rm EXTENSION_RM] [--output OUTPUT] [--password PASSWORD] [--path PATH] [--quiet] [--secret SECRET] [--topic TOPIC] [--username USERNAME]

명령 옵션

--name, -n
Kafka 이벤트 구독의 이름입니다. 이 값은 필수입니다.
--broker, -b
Kafka 소스에서 브로커를 설정합니다. 브로커는 소비자가 연결되는 Kafka 서버입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--destination, -d
이벤트를 수신할 애플리케이션 또는 작업 리소스의 이름입니다(예: myapp). 필요한 경우 --path 옵션을 사용하여 앱 대상을 추가로 규정하십시오. 이 값은 선택사항입니다.
--destination-type, --dt
destination의 유형입니다. 올바른 값은 appjob입니다. 이 값은 선택사항입니다.
--extension, --ext
대상으로 보낼 CloudEvents 확장을 설정합니다. NAME=VALUE 형식이어야 합니다. 이 작업은 새 CloudEvents 확장을 추가하거나 기존 CloudEvent 속성을 재정의합니다. --extension 옵션당 하나의 확장자를 지정합니다. 예, --ext extA=A --ext extB=B. 이 값은 선택사항입니다.
--extension-rm, --ext-rm
키 이름을 지정하여 대상으로 보낼 CloudEvents 확장을 제거하십시오. --ext-rm 옵션당 하나의 확장자를 지정합니다. 예: --ext-rm extA --ext-rm extB. 이 값은 선택사항입니다.
--output, -o
명령 출력 형식을 지정합니다. 올바른 값은 json, yaml, jsonpath=JSONPATH_EXPRESSIONjsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면 jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--password, -p
Kafka 인스턴스 인증에 사용되는 비밀번호입니다. --password 옵션을 지정하는 경우, --secret 옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다.
--path
이벤트가 전달될 destination 애플리케이션 내의 경로입니다(예: /events). 기본 경로는 destination 애플리케이션의 루트 URL입니다. 이 옵션은 destination-typeapp인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다.
--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.
--secret, -s
Kafka 인스턴스에 대한 인증에 사용되며, usernamepassword 키를 모두 포함하는 비밀의 이름입니다. --secret 옵션을 지정하는 경우, --username 또는 --password 옵션을 함께 지정해서는 안 됩니다. 이 값은 선택사항입니다.
--topic, -t
Kafka 소스에서 토픽을 설정합니다. 토픽은 소비할 메시지를 필터링하는 데 사용됩니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 값은 선택사항입니다.
--username, -u
Kafka 인스턴스 인증에 사용되는 사용자 이름입니다. --username 옵션을 지정하는 경우, 반드시 --password 옵션을 함께 지정해야 하며, --secret 옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다. 기본값은 token입니다.

다음 예는 kafka-topic1 대신 kafka-topic2 을 사용하도록 Kafka 이벤트 구독을 업데이트하는 예제입니다.

ibmcloud ce subscription kafka update --name mykafkasubscription --topic kafka-topic2

출력 예

Updating Kafka event subscription 'mykafkasubscription'...
Run 'ibmcloud ce subscription kafka get -n mykafkasubscription' to check the Kafka event subscription status.
OK

Version 명령

code-engine 명령행 인터페이스의 버전을 표시합니다.

ibmcloud ce version

code-engine 명령행 인터페이스의 버전을 표시합니다.

ibmcloud ce version [--quiet]

명령 옵션

--quiet, -q
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은 false입니다.

ibmcloud ce version

출력 예

version:  v1.17.0
commit:   3ab130b746f4784c9ff8d3da7bb05b6e7acda6d5