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,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은--build-source옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은medium입니다. --build-source,--source,--bsrc,--src-
Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예:
https://github.com/IBM/CodeEngine또는.). 이 값은 선택사항입니다. --build-strategy,--strategy,--bstr,--str-
이미지를 빌드하는 데 사용할 전략입니다. 유효값은
dockerfile및buildpacks입니다. 빌드 전략 옵션은--build-source옵션이 설정된 경우에만 허용됩니다. 명시되지 않은 경우,--build-source가 지정되어 있고 소스 코드가 로컬 컴퓨터에 있는 경우 빌드 전략은 Code Engine 에 따라 결정됩니다. 이 값은 선택사항입니다. 기본값은dockerfile입니다. --build-timeout,--bto-
빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 시간 초과 옵션은
--build-source옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은600입니다. --cluster-local,--cl-
프로젝트 전용 엔드포인트를 사용하여 애플리케이션을 배치합니다. 프로젝트 전용 엔드포인트를 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 동일한 프로젝트에서 실행 중인 다른 Code Engine 컴포넌트에서만 네트워크 액세스가 가능합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --command,--cmd,-c-
애플리케이션에 대한 명령을 설정합니다.
--command옵션당 한 개의 명령을 지정하십시오(예:--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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.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속성은 필수이며 유효한 값은tcp및http입니다. 예: --probe-live type=tcp --probe-live port=8080. 프로브 작업에 대한 자세한 내용은 프로브 작업에 대한 자세한 내용은 앱에 대한 프로브 구성을 참조하세요. 이 값은 선택사항입니다. --probe-ready,--pr-
NAME=VALUE 형식으로 이 애플리케이션에 대한 준비 상태 프로브를 구성하십시오. 유효한 NAME 옵션은 다음과 같습니다:
type,port,path,interval,initial-delay,timeout,failure-threshold입니다. 이 옵션은 여러 번 지정할 수 있습니다.type속성은 필수이며 유효한 값은tcp및http입니다. 예: --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,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --trusted-profiles-enabled,--trusted,--tpe-
이 애플리케이션의 컨테이너에 컴퓨팅 리소스 토큰을 마운트하도록 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --user,-u-
애플리케이션을 실행하는 데 사용되는 사용자 ID(UID)입니다. 이 값은 애플리케이션 Dockerfile 파일에 설정된 사용자 ID를 대체합니다. ID는 컨테이너의 운영 체제 요구사항을 준수해야 합니다. 이 값은 선택사항입니다. 기본값은
0입니다. --visibility,-v-
애플리케이션에 대한 가시성입니다. 유효한 값은
public,private및project입니다. 가시성을public으로 설정하면 앱이 공용 인터넷 또는 Code Engine 프로젝트 내의 컴포넌트로부터 요청을 수신할 수 있습니다. 가시성을private으로 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 가상 사설 엔드포인트(VPE)를 사용하는 다른 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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce app list --sort-by age
출력 예
Listing all applications...
OK
Name Status URL Latest Age Conditions Reason
myapptestapp2 Ready https://myapptestapp2.4svg40kna19.us-south.codeengine.appdomain.cloud myapptestapp2-emy0q-1 52s 3 OK / 3
myapptestapp1 Ready https://myapptestapp1.4svg40kna19.us-south.codeengine.appdomain.cloud myapptestapp1-ps4ca-1 104s 3 OK / 3
myapp-e Ready https://myapp-e.4svg40kna19.us-south.codeengine.appdomain.cloud myapp-e-gx6xa-1 12m 3 OK / 3
myappd Ready https://myappd.4svg40kna19.us-south.codeengine.appdomain.cloud myappd-lxjxm-1 13m 3 OK / 3
myappc Ready https://myappc.4svg40kna19.us-south.codeengine.appdomain.cloud myappc-qffan-1 14m 3 OK / 3
myappb Ready https://myappb.4svg40kna19.us-south.codeengine.appdomain.cloud myappb-i3hw3-1 15m 3 OK / 3
myapp Ready https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud myapp-jmxwd-1 17m 3 OK / 3
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_EXPRESSION및jsonpath-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,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 이app update명령어에서 ‘--build-source’ 옵션이 설정되어 있거나, 해당 애플리케이션에 현재 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은medium입니다. --build-source,--source,--bsrc,--src-
Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예:
https://github.com/IBM/CodeEngine또는.). 이 값은 선택사항입니다. --build-strategy,--strategy,--bstr,--str-
이미지를 빌드하는 데 사용할 전략입니다. 유효값은
dockerfile및buildpacks입니다. 빌드 전략 옵션은 이app update명령어에서--build-source옵션이 설정되어 있거나, 애플리케이션에 현재 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 지정하지 않으면--build-source가 지정되고 소스가 로컬 시스템에 있는 경우 빌드 전략이 Code Engine에 의해 결정됩니다. 이 값은 선택사항입니다. 기본값은dockerfile입니다. --build-timeout,--bto-
빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 타임아웃 옵션은 이
app update명령어에--build-source옵션이 설정되어 있거나, 애플리케이션에 현재 진행 중인 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은600입니다. --cluster-local,--cl-
프로젝트 전용 엔드포인트를 사용하여 애플리케이션을 배치합니다. 프로젝트 전용 엔드포인트를 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 동일한 프로젝트에서 실행 중인 다른 Code Engine 컴포넌트에서만 네트워크 액세스가 가능합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --command,--cmd,-c-
애플리케이션에 대한 명령을 설정합니다.
--command옵션당 한 개의 명령을 지정하십시오(예:--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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.REGISTRY를 지정하지 않으면 기본값은docker.io입니다.TAG를 지정하지 않으면 기본값은latest입니다. 이 값은 선택사항입니다. --max-scale,--max,--maxscale-
이 애플리케이션에 사용할 수 있는 최대 인스턴스 수입니다. 이 값을
0으로 설정하면 필요에 따라 애플리케이션이 스케일링됩니다. 애플리케이션 스케일링은 애플리케이션 프로젝트의 리소스 할당량에 따라 인스턴스에 의해서만 제한됩니다. Code Engine의 한계 및 할당량을 참조하십시오. 이 값은 선택사항입니다. 기본값은10입니다. --memory,-m-
애플리케이션 인스턴스에 대해 설정된 메모리 양입니다. 메가바이트의 경우
M을 사용하고 기가바이트의 경우G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. --min-scale,--min,--minscale-
이 애플리케이션에 사용할 수 있는 최소 인스턴스 수입니다. 이 값은 선택사항입니다. 기본값은
0입니다. --mount-configmap,--mount-cm-
마운트 디렉토리와 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속성은 필수이며 유효한 값은tcp및http입니다. 예: --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속성은 필수이며 유효한 값은tcp및http입니다. 예: --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,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --service-account-clear,--sac-
서비스 계정을 지우십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --trusted-profiles-enabled,--trusted,--tpe-
이 애플리케이션의 컨테이너에 컴퓨팅 리소스 토큰을 마운트하도록 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --user,-u-
애플리케이션을 실행하는 데 사용되는 사용자 ID(UID)입니다. 이 값은 애플리케이션 Dockerfile 파일에 설정된 사용자 ID를 대체합니다. ID는 컨테이너의 운영 체제 요구사항을 준수해야 합니다. 이 값은 선택사항입니다. 기본값은
0입니다. --visibility,-v-
애플리케이션에 대한 가시성입니다. 유효한 값은
public,private및project입니다. 가시성을public으로 설정하면 앱이 공용 인터넷 또는 Code Engine 프로젝트 내의 컴포넌트로부터 요청을 수신할 수 있습니다. 가시성을private으로 설정하면 공용 인터넷에서 앱에 액세스할 수 없으며 가상 사설 엔드포인트(VPE)를 사용하는 다른 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- 빌드 유형입니다. 유효값은
git및local입니다. 빌드 유형이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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --registry-secret,--rs-
레지스트리에 액세스하는 데 사용되는 레지스트리 키입니다.
registry create명령을 실행하여 레지스트리 시크릿을 추가할 수 있습니다. 이 값은 선택사항입니다. --size,--sz-
사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은
small,medium,large,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 이 값은 선택사항입니다. 기본값은medium입니다. --source,--src-
소스 코드가 포함된 Git 저장소의 URL입니다(예:
https://github.com/IBM/CodeEngine). source 옵션은--build-type옵션이git인 경우 필수이며,--build-type옵션이local인 경우에는 허용되지 않습니다. 이 값은 선택사항입니다. --strategy,--str-
이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은
dockerfile및buildpacks입니다. 함수의 경우, 유효한 값은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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce build list
출력 예
Listing builds...
OK
Name Status Reason Image Build Strategy Age Last Build Run Name Last Build Run Age
myhellobuild Succeeded all validations succeeded us.icr.io/mynamespace/codeengine-codeengine-200 dockerfile-medium 160d myhellobuild-run-4xdnb 160d
hello-build-5ckgs Succeeded all validations succeeded us.icr.io/mynamespace/codeengine-codeengine-51 dockerfile-medium 39d helloapp3-build-5ckgs-run-210803-2129500 39d
hello-build-pmg6v Succeeded all validations succeeded us.icr.io/mynamespace/codeengine-codeengine-4f dockerfile-medium 40d hellooapp2-build-pmg6v-run-210802-2112310 40d
helloworld-build Succeeded all validations succeeded us.icr.io/mynamespace/codeengine-helloworld dockerfile-medium 39d helloworld-build-run 39d
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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --registry-secret,--rs- 레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.
--size,--sz- 사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은
small,medium,large,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 이 값은 선택사항입니다. --source,--src- 소스 코드가 포함된 Git 저장소의 URL입니다(예:
https://github.com/IBM/CodeEngine). 이 값은 선택사항입니다. --strategy,--str- 이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은
dockerfile및buildpacks입니다. 함수의 경우, 유효한 값은codebundle-[RUNTIME-ID]형식을 따릅니다. 예를 들어 런타임 ID가nodejs-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce buildrun list
출력 예
Listing builds...
OK
Name Status Build Name Age
helloworld-build-run Succeeded helloworld-build 5d22h
mybuildrun Succeeded helloworld-build 7m23s
mybuildrun2 Succeeded helloworld-build 3m4s
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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --registry-secret,--rs-
레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다.
--build옵션이 설정되어 있지 않은 경우 레지스트리 비밀 옵션이 허용되며,--build옵션이 설정되어 있는 경우 허용 되지 않습니다. 이 값은 선택사항입니다. --service-account,--sa-
서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인
manager,none,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --size,--sz-
사용된 리소스의 양을 판별할 빌드 크기입니다. 유효한 값은
small,medium,large,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오.--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-
이미지를 빌드하는 데 사용할 전략입니다. 애플리케이션 및 채용 공고의 경우, 유효한 값은
dockerfile및buildpacks입니다. 함수의 경우, 유효한 값은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,-eKEY=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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다.
예
다음 예에서는 configmap-fromliteral 및 color=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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce configmap list
출력 예
Listing Configmaps...
Name Data Age
configmap-fromfile 2 19m13s
configmap-fromliteral 2 16m12s
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,-eKEY=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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
다음 예제에서는 모든 사용자 정의 도메인 매핑 목록을 표시합니다.
ibmcloud ce domainmapping list
출력 예
Listing domain mappings...
OK
Name CNAME Target Target-Type Status Secret Name Age
www.example.com custom.abcdabcdabc.us-south.codeengine.appdomain.cloud myapp app ready mytlssecret 36m
사용자 정의 도메인 매핑과 자동 생성된 시스템 도메인 매핑을 모두 포함하여 애플리케이션의 모든 도메인 매핑 목록을 보려면 --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입니다. --hardrunning상태의 태스크를 포함하여 서버리스 플릿을 즉시 취소하십시오.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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다.
예
ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
출력 예
Getting fleet '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'...
OK
Name: fleet-0123456789
ID: 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
Status: running
Created: 2025-09-26T10:46:02Z
Project region: eu-de
Project name: myproj
Tasks status:
Pending: 893
Running: 12
Failed: 0
Canceled: 0
Successful: 96
Total: 1001
Code:
Container image reference: icr.io/codeengine/helloworld
Tasks specification:
Task state store: mytaskstore
Indexes: 0-1000
Resources and scaling:
CPU per instance: 1
Memory per instance: 2G
Max number of instances: 12
Max retries per task: 3
Network placement:
Subnet 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 올바른 값은
name,status,age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce fleet list
출력 예
Listing fleets...
OK
Name ID Status Tasks finished Tasks total Instances Created
fleet-a123456789 0a0a0a0a-2b2b-3c3c-4d4d-5e5e5e5e5e5e successful 300 300 0 2025-09-26T12:11:28Z
fleet-b123456789 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e running 778 1001 12 2025-09-26T12:43:11Z
fleet-c123456789 2a2a2a2a-2b2b-3c3c-4d4d-5e5e5e5e5e5e canceled 1 1 0 2025-09-26T10:46:02Z
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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다. --pagination-token,--pt- 이 페이지 매김 토큰부터 시작하는 태스크의 다음 페이지를 표시하십시오. 이 값은 선택사항입니다.
--quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --show-all-columns,--sacCreated및Finished열을 추가로 표시합니다. 이 값은 선택사항입니다. 기본값은false입니다.--sort-by,--sb- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 올바른 값은
id,index,status입니다. 이 값은 선택사항입니다. 기본값은index입니다. --status,--st- 지정된 상태의 태스크를 표시합니다. 유효한 값은
canceled,failed,pending,running및succeeded입니다. 이 값은 선택사항입니다.
예
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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및status입니다. 이 값은 선택사항입니다. 기본값은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,disk및memory입니다. 이 값은 선택사항입니다. 기본값은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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --scale-down-delay,--sdd-
호출이 완료된 후 인스턴스가 활성 상태로 유지되는 시간(초)입니다. 이 옵션은 콜드 스타트 시간을 줄일 수 있습니다. 자세한 내용은 함수 인스턴스를 더 오래 살릴 수 있나요? 이 값은 선택사항입니다. 기본값은
1입니다. --trusted-profiles-enabled,--trusted,--tpe-
함수 실행을 위해 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --visibility,-v-
함수의 가시성입니다. 유효한 값은
public,private및project입니다. 프로젝트가 함수 전용 가시성을 지원하는 경우에만 가시성이private가 될 수 있습니다. 이 값은 선택사항입니다. 기본값은public입니다. --wait,-w-
빌드 실행이 완료될 때까지 대기하십시오. 이 값은 선택사항입니다. 기본값은
true입니다. --wait-timeout,--wto-
함수가 준비될 때까지 대기할 시간(초 단위).
--wait옵션을 지정한 경우 이 값이 필수입니다.--no-wait옵션을 지정한 경우 이 값이 무시됩니다. 기본값은600입니다.
예
ibmcloud ce fn create --name myfunction --build-source main.js --runtime nodejs
출력 예
Preparing function 'myfunction' for build push...
Creating function 'myfunction'...
Packaging files to upload from source path 'main.js'...
Submitting build run 'myfunction-run-111111-12345678'...
Creating image 'private.stg.icr.io/ce--1a1a1-11c22def3rhz/function-myfunction:12345678-1111-dexla'...
Waiting for build run to complete...
Build run status: 'Running'
Build run completed successfully.
Run 'ibmcloud ce buildrun get -n myfunction-run-111111-12345678' to check the build run status.
Waiting for function 'myfunction' to become ready...
Function 'myfunction' is ready.
OK
Run 'ibmcloud ce function get -n myfunction' to see more details.
https://myfunction.11c22def3rhz.us-south.codeengine.appdomain.cloud
ibmcloud ce fn get -n 'myfunction' 를 실행하여 함수 상태를 확인하면, 해당 함수에 대한 URL 페이지가 표시됩니다.
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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce fn delete --name myfunction
출력 예
Name Status URL CPU Memory Age
hellofunction Ready https://hellofunction.4svg40kna19.us-south.codeengine.appdomain.cloud 0.25 500M 25h
myfunction Ready https://myfun1.4svg40kna19.us-south.codeengine.appdomain.cloud 0.25 1G 8d
helloworld Ready https://myfunction1.4svg40kna19.us-south.codeengine.appdomain.cloud 0.25 1G 16d
myfunction1 Ready https://myfunction111.4svg40kna19.us-south.codeengine.appdomain.cloud 0.25 500M 25h
myfunction3 Ready https://myfunction41.4svg40kna19.us-south.codeengine.appdomain.cloud 0.25 500M 25h
ibmcloud ce function runtimes
사용 가능한 함수 런타임을 나열합니다.
ibmcloud ce function runtimes [--all] [--output OUTPUT] [--quiet]
명령 옵션
--all,-A- 더 이상 사용되지 않는 런타임을 포함하여 모든 런타임을 표시합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --output,-o- 명령 출력 형식을 지정합니다. 올바른 값은
json,yaml,jsonpath=JSONPATH_EXPRESSION및jsonpath-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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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_EXPRESSION및jsonpath-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,private및project입니다. 프로젝트가 함수 전용 가시성을 지원하는 경우에만 가시성이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-
작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어,
instances을5으로 지정하면, 시스템은 이를array-indexes을0 - 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,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은--build-source옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은medium입니다. --build-source,--source,--bsrc,--src-
Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예:
https://github.com/IBM/CodeEngine또는.). 이 값은 선택사항입니다. --build-strategy,--strategy,--bstr,--str-
이미지를 빌드하는 데 사용할 전략입니다. 유효값은
dockerfile및buildpacks입니다. 빌드 전략 옵션은--build-source옵션이 설정된 경우에만 허용됩니다. 명시되지 않은 경우,--build-source가 지정되어 있고 소스 코드가 로컬 컴퓨터에 있는 경우 빌드 전략은 Code Engine 에 따라 결정됩니다. 이 값은 선택사항입니다. 기본값은dockerfile입니다. --build-timeout,--bto-
빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 시간 초과 옵션은
--build-source옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은600입니다. --command,--cmd,-c-
작업 실행에 대한 명령을 설정합니다.
--command옵션당 한 개의 명령을 지정하십시오(예:--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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.REGISTRY를 지정하지 않으면 기본값은docker.io입니다.TAG를 지정하지 않으면 기본값은latest입니다.--build-source옵션을 지정하지 않은 경우 image 옵션은 필수입니다. 이 값은 선택사항입니다. --maxexecutiontime,--met-
작업 실행의 최대 실행 시간(초)입니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은7200입니다. --memory,-m-
작업 실행에 대해 설정된 메모리의 양입니다. 메가바이트의 경우
M을 사용하고 기가바이트의 경우G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은4G입니다. --mode-
작업 실행 모드입니다. 유효값은
task및daemon입니다.task모드에서는maxexecutiontime및retrylimit옵션이 적용됩니다.daemon모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로,--maxexecutiontime및--retrylimit옵션은 사용할 수 없습니다. 이 값은 선택사항입니다. 기본값은task입니다. --mount-configmap,--mount-cm-
마운트 디렉토리와 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --registry-secret,--rs-
레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.
--retrylimit,-r-
작업이 실패로 표시되기 전에 작업 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업의 배열 인덱스가 다시 실행됩니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은3입니다. --service-account,--sa-
서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인
manager,none,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --trusted-profiles-enabled,--trusted,--tpe-
작업 실행에 대한 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --wait,-w-
빌드 실행이 완료될 때까지 대기하십시오.
--wait옵션을 지정하면 빌드 실행이 성공적으로 완료될 때까지--wait-timeout옵션으로 설정된 최대 시간(초) 동안 빌드 실행이 대기합니다. 빌드 실행이 지정된--wait-timeout기간 내에 완료되지 않으면 빌드 실행이 실패합니다. 대기 옵션은--build-source옵션이 설정된 경우에만 허용됩니다. 이 값은 선택사항입니다. 기본값은true입니다. --wait-timeout,--wto-
빌드 실행이 완료될 때까지 대기하는 시간(초)입니다.
--wait옵션을 지정한 경우 이 값이 필수입니다.--no-wait옵션을 지정한 경우 이 값이 무시됩니다. 대기 시간 초과 옵션은--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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce job list
출력 예
Name Age Last Job Run Name Last Job Run Age
demo 110d demo-jobrun-hkkmx 108d
myjob-envvar 107d
hellojob 7s
myjob 60d myjob-977v7 58d
testjob 88d testjob-jobrun-kzxlp 72d
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-
작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어,
instances을5으로 지정하면, 시스템은 이를array-indexes을0 - 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,xlarge및xxlarge입니다. 자세한 내용은 빌드의 크기 결정을 참조하십시오. 빌드 크기 옵션은 이job update명령어에서 ‘--build-source’ 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은medium입니다. --build-source,--source,--bsrc,--src-
Git 저장소의 URL 또는 소스 코드가 포함되어 있는 로컬 소스의 경로입니다(예:
https://github.com/IBM/CodeEngine또는.). 이 값은 선택사항입니다. --build-strategy,--strategy,--bstr,--str-
이미지를 빌드하는 데 사용할 전략입니다. 유효값은
dockerfile및buildpacks입니다. 빌드 전략 옵션은 이job update명령어에서--build-source옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 지정하지 않으면--build-source가 지정되고 소스가 로컬 시스템에 있는 경우 빌드 전략이 Code Engine에 의해 결정됩니다. 이 값은 선택사항입니다. 기본값은dockerfile입니다. --build-timeout,--bto-
빌드 성공 또는 실패 전 경과 시간(초)입니다. 빌드 타임아웃 옵션은 이
job update명령어에--build-source옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은600입니다. --command,--cmd,-c-
작업 실행에 대한 명령을 설정합니다.
--command옵션당 한 개의 명령을 지정하십시오(예:--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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.REGISTRY를 지정하지 않으면 기본값은docker.io입니다.TAG를 지정하지 않으면 기본값은latest입니다. 이 값은 선택사항입니다. --maxexecutiontime,--met-
작업 실행의 최대 실행 시간(초)입니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은7200입니다. --memory,-m-
작업 실행에 대해 설정된 메모리의 양입니다. 메가바이트의 경우
M을 사용하고 기가바이트의 경우G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. --mode-
작업 실행 모드입니다. 유효값은
task및daemon입니다.task모드에서는maxexecutiontime및retrylimit옵션이 적용됩니다.daemon모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로,--maxexecutiontime및--retrylimit옵션은 사용할 수 없습니다. 이 값은 선택사항입니다. --mount-configmap,--mount-cm-
마운트 디렉토리와 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_EXPRESSION및jsonpath-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,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --service-account-clear,--sac-
서비스 계정을 지우십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --trusted-profiles-enabled,--trusted,--tpe-
작업 실행에 대한 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --wait,-w-
빌드 실행이 완료될 때까지 대기하십시오.
--wait옵션을 지정하면 빌드 실행이 성공적으로 완료될 때까지--wait-timeout옵션으로 설정된 최대 시간(초) 동안 빌드 실행이 대기합니다. 빌드 실행이 지정된--wait-timeout기간 내에 완료되지 않으면 빌드 실행이 실패합니다. 'wait' 옵션은 이 'job update' 명령어에서 '--build-source' 옵션이 설정되어 있거나, 현재 작업에 연관된 빌드가 있는 경우에만 사용할 수 있습니다. 이 값은 선택사항입니다. 기본값은true입니다. --wait-timeout,--wto-
빌드 실행이 완료될 때까지 대기하는 시간(초)입니다.
--wait옵션을 지정한 경우 이 값이 필수입니다.--no-wait옵션을 지정한 경우 이 값이 무시됩니다.--build-source옵션이 이job update명령에 설정되어 있거나 작업에 현재 연관된 빌드가 있는 경우 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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce jobrun list
출력 예
Listing job runs...
OK
Name Failed Pending Requested Running Succeeded Unknown Age
firstjob-jobrun-shnj5 0 0 0 0 1 0 11d
myjob-jobrun-fji48 0 0 0 0 5 0 11d
myjob-jobrun-xeqc8 0 0 0 0 5 0 12d
myjobrun 0 0 0 0 5 0 7m47s
mytestjob-jobrun-el0o8 0 0 0 0 1 0 11d
testjobrun 0 0 0 0 5 0 11d
나열된 작업 실행의 이름은 작업 실행의 이름과 작업 실행의 현재 개정을 표시합니다.
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_EXPRESSION및jsonpath-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-
이 작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어,
instances을5으로 지정하면, 시스템은 이를array-indexes을0 - 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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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-
작업 실행 모드입니다. 유효값은
task및daemon입니다.task모드에서는maxexecutiontime및retrylimit옵션이 적용됩니다.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입니다. 이 값은 선택사항입니다. -n,--name-
이 작업 실행의 이름입니다. 참조된 작업에 관련 작업 구성이 없는 경우 이 값이 필요합니다. 프로젝트 내에서 고유한 이름을 사용하십시오.
- 이름은 소문자 영숫자로 시작하고 끝나야 합니다.
- 이름은 53자 이하여야 하며 소문자, 숫자, 하이픈(-)을 포함할 수 있습니다.
이 값은 선택사항입니다.
--no-wait,--nw- 작업 실행을 다시 제출하며 이 작업 실행의 인스턴스가 완료될 때까지 대기하지 않습니다.
--no-wait옵션을 지정할 경우 작업 실행 다시 제출이 시작되며 대기하지 않습니다. 작업 실행 상태를 확인하려면jobrun get명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은true입니다.
--output,-o-
명령 출력 형식을 지정합니다. 올바른 값은
json,yaml,jsonpath=JSONPATH_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --retrylimit,-r-
작업 실행이 실패로 표시되기 전에 이 작업 실행의 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업 실행의 배열 인덱스가 다시 실행됩니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은3입니다. --service-account,--sa-
서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인
manager,none,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --service-account-clear,--sac-
서비스 계정을 지우십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --trusted-profiles-enabled,--trusted,--tpe-
이 작업 실행의 인스턴스에 대해 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --wait,-w-
작업 실행을 다시 제출하며 이 작업 실행의 인스턴스가 완료될 때까지 대기합니다.
--wait옵션을 지정할 경우 작업 실행이 완료될 때까지--wait-timeout옵션에 설정된 최대 시간(초) 동안 작업 실행 다시 제출이 대기합니다. 작업 실행이 지정된--wait-timeout기간 내에 완료되지 않으면 작업 실행 다시 제출이 실패합니다. 이 값은 선택사항입니다. 기본값은false입니다. --wait-timeout,--wto-
이 작업 실행의 인스턴스가 완료될 때까지 대기하는 시간(초)입니다.
--wait옵션을 지정한 경우 이 값이 필수입니다.--no-wait옵션을 지정한 경우 이 값이 무시됩니다. 기본값은600입니다.
예
다음 예에서는 myjobrun 인스턴스에 대한 4-5 작업 실행을 다시 실행합니다. 다시 제출된 작업 실행의 이름은 myjobresubmit입니다.
ibmcloud ce jobrun resubmit --name myjobresubmit --jobrun myjobrun --array-indices 4-5
출력 예
Getting job run 'myjobrun'...
Rerunning job run 'myjobresubmit'...
Run 'ibmcloud ce jobrun get -n myjobresubmit' to check the job run status.
OK
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-
이 작업 실행에 사용되는 인스턴스 수를 지정합니다. 이 옵션을 사용하면 시스템에서 배열 색인으로 변환합니다. 예를 들어,
instances을5으로 지정하면, 시스템은 이를array-indexes을0 - 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>입니다. 예를 들어, configmapconfigmapName에 있는 키의 모든 변수 이름에 대한 접두부를CUSTOM_으로 설정하려면CUSTOM_=configmapName을 값으로 사용하십시오. configmapconfigmapName에 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입니다. 여기서,REGISTRY및TAG는 선택사항입니다.REGISTRY를 지정하지 않으면 기본값은docker.io입니다.TAG를 지정하지 않으면 기본값은latest입니다.--job옵션을 지정하지 않은 경우--name및--image값이 필요합니다. 이 값은 선택사항입니다. --job,-j-
작업 구성의 이름입니다.
job list명령을 사용하면 작업 구성을 확인할 수 있습니다.--job값을 지정하는 경우 선택적으로--name값을 지정할 수 있습니다.--job값을 지정하지 않는 경우,--name및--image값을 지정해야 합니다. 이 값은 선택사항입니다. --maxexecutiontime,--met-
이 작업 실행의 최대 실행 시간(초)입니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은7200입니다. --memory,-m-
이 작업 실행에 지정할 메모리 양입니다. 메가바이트의 경우
M을 사용하고 기가바이트의 경우G를 사용하십시오. 올바른 값은 지원되는 메모리와 CPU 조합을 참조하십시오. 이 값은 선택사항입니다. 기본값은4G입니다. --mode-
작업 실행 모드입니다. 유효값은
task및daemon입니다.task모드에서는maxexecutiontime및retrylimit옵션이 적용됩니다.daemon모드에서는 타임아웃이 없고 실패한 인스턴스가 무기한으로 재시작되므로,maxexecutiontime및retrylimit옵션은 사용할 수 없습니다. 이 값은 선택사항입니다. 기본값은task입니다. --mount-configmap,--mount-cm-
마운트 디렉토리와 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --registry-secret,--rs-
레지스트리 본인확인정보의 이름입니다. 레지스트리 본인확인정보는 컨테이너 이미지를 다운로드할 때 개인용 레지스트리를 사용하여 인증하는 데 사용됩니다. 이 값은 선택사항입니다.
--retrylimit,-r-
작업 실행이 실패로 표시되기 전에 이 작업 실행의 인스턴스를 다시 실행하는 횟수입니다. 0이 아닌 종료 코드가 제공될 경우 작업 실행의 배열 인덱스가 다시 실행됩니다. 이 옵션은
mode이task``인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. 기본값은3입니다. --service-account,--sa-
서비스 계정의 이름. 서비스 계정은 인스턴스에서 실행되는 프로세스의 ID를 제공합니다. 기본 제공 서비스 계정의 경우 단축 이름인
manager,none,reader및writer를 사용할 수 있습니다.Kubernetes Config Context명령으로 결정될 수 있는project current의 접두부로 전체 이름을 사용할 수도 있습니다. 이 값은 선택사항입니다. --trusted-profiles-enabled,--trusted,--tpe-
이 작업 실행의 인스턴스에 대해 컴퓨팅 리소스 토큰 마운트를 사용으로 설정하십시오. 이 값은 선택사항입니다. 기본값은
false입니다. --wait,-w-
작업 실행을 제출하며 이 작업 실행의 인스턴스가 완료될 때까지 대기합니다.
--wait옵션을 지정할 경우 작업 실행이 완료될 때까지--wait-timeout옵션에 설정된 최대 시간(초) 동안 작업 실행 제출이 대기합니다. 작업 실행이 지정된--wait-timeout기간 내에 완료되지 않으면 작업 실행 제출이 실패합니다. 이 값은 선택사항입니다. 기본값은false입니다. --wait-timeout,--wto-
이 작업 실행의 인스턴스가 완료될 때까지 대기하는 시간(초)입니다.
--wait옵션을 지정한 경우 이 값이 필수입니다.--no-wait옵션을 지정한 경우 이 값이 무시됩니다. 기본값은600입니다.
예
ibmcloud ce jobrun submit --name myjobrun --image icr.io/codeengine/firstjob --array-indices 1-5
출력 예
Submitting job run 'myjobrun'...
Run 'ibmcloud ce jobrun get -n myjobrun' to check the job run status.
OK
퍼시스턴트데이터스토어 명령
영구 데이터 저장소를 관리합니다.
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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다.
예
ibmcloud ce persistentdatastore get --name my-pds-2
출력 예
Getting persistent data store 'my-pds-2'...
OK
Name: my-pds-2
ID: abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Type: object_storage
Created: Fri, 11 Jul 2025 13:52:30 +0200
Age: 103s
Project Name: myproject
Project ID: 01234567-abcd-abcd-abcd-abcdabcd1111
Data:
COS bucket: my-test-bucket-2
Access secret: my-hmac-secret-2
Bucket region: eu-de
ibmcloud ce persistentdatastore list
프로젝트 내 모든 영구 데이터 저장소를 나열합니다.
ibmcloud ce persistentdatastore 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 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- 프로젝트의 엔드포인트입니다. 유효값은
public및private입니다.--endpoint옵션을 명시적으로 지정하지 않은 경우 동작은 시스템에 의해 결정됩니다. IBM Cloud CLI가private.cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는--endpoint가private인 것처럼 동작합니다. IBM Cloud CLI가cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는--endpoint가public인 것처럼 동작합니다. 이 값은 선택사항입니다.
--no-select,--ns-
해당 프로젝트가 작성된 후에는 프로젝트를 현재 컨텍스트로 선택하지 마십시오. 이 옵션을 선택하지 않으면 프로젝트가 자동으로 선택됩니다. 이 값은 선택사항입니다. 기본값은
false입니다. --no-wait,--nw-
프로젝트를 작성하며 프로젝트가 작성될 때까지 대기하지 않습니다.
no-wait옵션을 지정할 경우 프로젝트 작성이 시작되며 대기하지 않습니다. 프로젝트 상태를 확인하려면project get명령을 사용하십시오. 이 값은 선택사항입니다. 기본값은false입니다. --output,-o-
명령 출력 형식을 지정합니다. 올바른 값은
json,yaml,jsonpath=JSONPATH_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. 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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --regions,-r- 프로젝트 표시를 지정된 지역으로 제한합니다. 하나 이상의 지역 이름을 제공하십시오(예:
us-south,eu-de). 이 값은 선택사항입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce project list
출력 예
Getting projects...
OK
Name ID Status Selected Tags Region Resource Group Age
myproj-eude 09768af4-abcd-abcd-abcd-24674ba90db0 active false eu-de default 27d
myproject cd09cfe1-abcd-abcd-abcd-0f8a8a1d0ddf active true us-south default 52d
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- 프로젝트의 엔드포인트입니다. 유효값은
public및private입니다.--endpoint옵션을 명시적으로 지정하지 않은 경우 동작은 시스템에 의해 결정됩니다. IBM Cloud CLI가private.cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는--endpoint가private인 것처럼 동작합니다. IBM Cloud CLI가cloud.ibm.com에 연결된 경우 Code Engine 프로젝트는--endpoint가public인 것처럼 동작합니다. 이 값은 선택사항입니다. --id,--guid- 프로젝트의 ID입니다.
--name를 지정하지 않은 경우에는 이 값이 필수입니다. --kubecfg,-k- Kubernetes 구성 파일에 프로젝트를 추가합니다.
KUBECONFIG환경 변수를 설정하여 기본 Kubernetes 구성 파일을 대체할 수 있습니다. 이 값은 선택사항입니다. 기본값은false입니다. --name,-n- 프로젝트 이름입니다.
--id를 지정하지 않은 경우에는 이 값이 필수입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다.
예
ibmcloud ce project select --name myproject
출력 예
Selecting project 'myproject'...
OK
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- 이 프로젝트의 서비스 바인딩의 인증에 사용할 리소스 그룹의 이름입니다. 이 리소스 그룹에 있는 모든 서비스에 대해
Operator및Manager역할이 있는 서비스 ID가 작성됩니다. 이 계정에 있는 모든 리소스 그룹을 지정하려면"*"를 사용하십시오. 이 값은 선택사항입니다. --binding-resource-group-id,--brgid- 이 프로젝트의 서비스 바인딩에 대한 인증에 사용할 자원 그룹의 ID. 이 리소스 그룹에 있는 모든 서비스에 대해
Operator및Manager역할이 있는 서비스 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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --regions,-r- 프로젝트 재확보 표시를 지정된 지역으로 제한합니다. 하나 이상의 지역 이름을 제공하십시오(예:
us-south,eu-de). 이 값은 선택사항입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은name입니다.
예
ibmcloud ce reclamation list
출력 예
Getting project reclamations...
OK
Name ID Reclamation ID Status Region Resource Group Age Time to Hard Deletion
myproject def218c5-abcd-abcd-abcd-97854c288d76 48e3d7a2-abcd-abcd-abcd-99db7152b8fe soft deleted us-south default 40h 6d23h
myproject2 01f0bc66-abcd-abcd-abcd-3ef7e99f6f69 af2cd017-abcd-abcd-abcd-d32e2bb79136 soft deleted jp-osa default 8m58s 2d11h
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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다.
--password,--pw-
기본 인증 또는 레지스트리 비밀의 비밀번호입니다.
--password,--password-from-file또는--password-from-json-file옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 이 값은basic_auth및registry비밀에 필요합니다. 이 값은 선택사항입니다. --password-from-file,--spf-
기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 파일 경로입니다. 파일의 첫 번째 행은 비밀번호에 사용됩니다.
--password,--password-from-file또는--password-from-json-file옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은basic_auth및registry비밀에 필요합니다. 이 값은 선택사항입니다. --password-from-json-file,--spfj-
기본 인증 또는 레지스트리 비밀에 대한 비밀번호가 포함된 JSON 파일의 경로입니다.
apikey필드는 비밀번호에 사용됩니다.--password,--password-from-file또는--password-from-json-file옵션이 지정되지 않은 경우 비밀번호를 묻는 프롬프트가 표시됩니다. 파일 경로를 값으로 제공해야 합니다. 이 값은basic_auth및registry비밀에 필요합니다. 이 값은 선택사항입니다. --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_auth및registry비밀에 필요합니다. 이 값은 선택사항입니다.
기본 인증 비밀의 예
기본 인증 비밀번호에는 username 및 password 키가 포함되어 있으며 기본 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_id 및 secret_access_key 키를 포함하며 인증이 필요하지만 IBM Cloud® Identity and Access Management API 키를 지원하지 않는 S3-compatible 도구 및 라이브러리와 함께 사용됩니다.
HMAC 시크릿을 만들기 위한 CLI 도움말을 보려면 ibmcloud ce secret create --format hmac 을 실행하세요.
다음 예에서는 mysecret-hmac 라는 이름의 HMAC 시크릿을 만듭니다. 이 비밀 번호에는 메시지가 표시될 때 입력한 access_key_id 및 secret_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 라는 이름의 레지스트리 비밀을 만들고 username 및 password 에 대한 자격 증명을 지정합니다.
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_EXPRESSION및jsonpath-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,ssh및tls입니다. 이 값은 선택사항입니다. --output,-o- 명령 출력 형식을 지정합니다. 올바른 값은
json,yaml,jsonpath=JSONPATH_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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,-eKEY=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_EXPRESSION및jsonpath-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,--pkfcert-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,--dtdestination의 유형입니다. 올바른 값은app및job입니다. 이 값은 선택사항입니다. 기본값은app입니다.
--event-type,-e-
감시할 이벤트 유형입니다. 유효한 값은
delete,write및all입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --path-
이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --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_EXPRESSION및jsonpath-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
Ready가 true이면 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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,--dtdestination의 유형입니다. 올바른 값은app및job입니다. 이 값은 선택사항입니다.--event-type,-e- 감시할 이벤트 유형입니다. 유효한 값은
delete,write및all입니다. 이 값은 선택사항입니다. --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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --path- 이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --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/html및text/plain입니다. 이 값은 선택사항입니다.
--da,--data-
대상으로 전송할 데이터입니다(예:
'{ "message": "Hello world!" }').--data옵션을 지정하는 경우에는--data-base64옵션을 사용하지 마십시오.이 값은 선택사항입니다.
--data-base64,--db- 대상에 전송할, Base64로 인코딩된 데이터로 예를 들면
Q29kZSBFbmdpbmU=과 같습니다.--data-base64옵션을 지정하는 경우에는--data옵션을 사용하지 마십시오. 이 값은 선택사항입니다.
--destination-type,--dt-
destination의 유형입니다. 유효한 값은app,function및job입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --path-
이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --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_EXPRESSION및jsonpath-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
Ready가 true이면 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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/html및text/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,function및job입니다. 이 값은 선택사항입니다. --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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --path-
이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --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의 유형입니다. 올바른 값은app및job입니다. 이 값은 선택사항입니다. 기본값은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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --password,-p-
Kafka 인스턴스 인증에 사용되는 비밀번호입니다.
--password옵션을 지정하는 경우,--secret옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다. --path-
이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --quiet,-q-
명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --secret,-s-
Kafka 인스턴스에 대한 인증에 사용되며,
username및password키를 모두 포함하는 비밀의 이름입니다.--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_EXPRESSION및jsonpath-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
Ready 가 true 일 때, 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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --sort-by,-s- 목록을 정렬할 때 사용할 기준 열을 지정합니다. 유효값은
name및age입니다. 이 값은 선택사항입니다. 기본값은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,--dtdestination의 유형입니다. 올바른 값은app및job입니다. 이 값은 선택사항입니다.--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_EXPRESSION및jsonpath-as-json=JSONPATH_EXPRESSION입니다. JSON 출력 요소에 대한 경로를 지정하려면jsonpath를 사용하십시오. 이 값은 선택사항입니다. --password,-p- Kafka 인스턴스 인증에 사용되는 비밀번호입니다.
--password옵션을 지정하는 경우,--secret옵션은 지정해서는 안 됩니다. 이 값은 선택사항입니다. --path- 이벤트가 전달될
destination애플리케이션 내의 경로입니다(예:/events). 기본 경로는destination애플리케이션의 루트 URL입니다. 이 옵션은destination-type이app인 경우에만 지정할 수 있습니다. 이 값은 선택사항입니다. --quiet,-q- 명령 출력을 줄이려면 이 옵션을 지정합니다. 이 값은 선택사항입니다. 기본값은
false입니다. --secret,-s- Kafka 인스턴스에 대한 인증에 사용되며,
username및password키를 모두 포함하는 비밀의 이름입니다.--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