bluemixUtility 명령

IBM® Bluemix® 명령행 유틸리티를 사용하면 특정 Bluemix 클라우드 서비스를 사용하도록 사내 구축형 Liberty 서버를 구성할 수 있습니다.

소스

명령행 유틸리티와 함께 사용할 수 있는 Bluemix 서비스(예: Watson™Cloudant® 서비스)에 대해 학습합니다.

구문

명령 구문은 다음과 같습니다.
bluemixUtility action [options]
다음 action 명령을 사용하십시오.
login
Bluemix에 로그인하십시오. 옵션 없이 login 명령을 실행하면 도구가 사용자 이름 및 비밀번호 등의 자세한 정보 입력 프롬프트를 표시합니다. 로그인에 성공하면 사용자 이름 및 비밀번호를 다시 지정하지 않고도 다른 명령을 실행할 수 있도록 Bluemix 신임 정보가 파일에 저장됩니다.
Cloud Foundry(cf) 클라이언트를 사용하여 Bluemix에 로그인하는 경우 bluemixUtility는 cf 클라이언트가 저장한 신임 정보를 사용합니다. 자세한 정보는 Cloud Foundry(cf) 명령을 참조하십시오.
bmarketplace
명령행 유틸리티를 사용하여 구성할 수 있는 모든 Bluemix 서비스를 나열합니다.
createService
Bluemix 카탈로그에서 서비스 인스턴스를 작성합니다.
listServices
사용 가능한 모든 Bluemix 서비스 인스턴스를 나열합니다.
showService
서비스 인스턴스에 대한 정보를 표시합니다.
import
서비스에 대한 구성을 가져옵니다. 가져온 서비스 구성 및 해당 종속 항목은 다음 디렉토리에 배치됩니다.
${wlp.user.dir}/shared/config/services/serviceName
listImports
Liberty 서버에 바인드될 수 있는 모든 가져온 서비스 구성을 나열합니다.
bind
Bluemix 서비스 구성을 Liberty 서버에 바인드합니다. 서비스에 대한 구성은 특정 옵션에 대한 기본값을 제공할 수 있습니다(예: dataSource 요소의 jndiName). 일부 경우에는 기본값이 애플리케이션의 예상과 일치하지 않습니다. 애플리케이션이 예상하는 값으로 기본값을 대체하려면 --v 옵션을 사용하십시오.
unbind
Liberty 서버에서 서비스 구성을 언바인드합니다.
deleteService
서비스 인스턴스를 삭제합니다.
switch
다른 Bluemix 조직 또는 영역으로 전환합니다.
info
Bluemix 연결 정보를 봅니다.
help
설명, 사용법 및 옵션을 보려면 각 명령에서 help 조치를 사용하십시오.
logout
Bluemix에서 로그아웃합니다. logout 명령은 Bluemix 신임 정보를 사용하여 로그인할 때 작성된 파일을 삭제합니다.

사용법

각 조치에 대해 실행할 수 있는 사용법 예를 보십시오.

다음 명령을 사용하여 login 조치를 실행하십시오.
bluemixUtility login [options]
다음 명령을 사용하여 marketplace 조치를 실행하십시오.
bluemixUtility marketplace [serviceType...]
다음 명령을 사용하여 createService 조치를 실행하십시오.
bluemixUtility createService [options] serviceType servicePlan serviceName
다음 명령을 사용하여 listServices 조치를 실행하십시오.
bluemixUtility listServices
다음 명령을 사용하여 showService 조치를 실행하십시오.
bluemixUtility showService [options] serviceName
다음 명령을 사용하여 import 조치를 실행하십시오.
bluemixUtility import [options] serviceName
다음 명령을 사용하여 listImports 조치를 실행하십시오.
bluemixUtility listImports [serverName]
다음 명령을 사용하여 bind 조치를 실행하십시오.
bluemixUtility bind [options] serverName serviceName
다음 명령을 사용하여 unbind 조치를 실행하십시오.
bluemixUtility unbind serverName serviceName
다음 명령을 사용하여 deleteService 조치를 실행하십시오.
bluemixUtility deleteService [options] serviceName
다음 명령을 사용하여 switch 조치를 실행하십시오.
bluemixUtility switch [options]
다음 명령을 사용하여 logout 조치를 실행하십시오.
bluemixUtility logout

옵션

각 조치에 대해 사용 가능한 옵션을 보십시오.

bluemixUtility login 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
--api=url
Bluemix API 엔드포인트입니다(예: https://api.ng.bluemix.net). API 엔드포인트는 Bluemix 지역 이름으로 설정될 수도 있습니다. 예를 들어, API 엔드포인트는 미국 남부 지역의 경우 us-south, 영국 런던 지역의 경우 eu-gb, 호주 시드니 지역의 경우 au-syd로 설정될 수 있습니다.
--user=username
Bluemix 계정의 사용자 이름입니다.
--password=password
Bluemix 계정의 비밀번호입니다.
--org=organizationName
조직 이름입니다.
--space=spaceName
영역 이름입니다.
[16.0.0.3 이상]--sso
Bluemix 연합 ID를 사용하여 로그인하는 데 필요한 일회성 패스코드입니다. 패스코드를 생성하려면 명령으로 지정된 Bluemix 패스코드 웹 사이트로 이동한 후 명령행에 생성된 패스코드를 입력하십시오. 이 옵션은 IBM id를 사용하여 사인인하는 데 필요하지 않습니다.
bluemixUtility marketplace 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
[serviceType...]
특정 Bluemix 서비스에 대한 자세한 정보를 표시합니다. 여러 서비스 이름을 공백으로 구분하여 지정하십시오.
bluemixUtility createService 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
--credentialName=name
서비스 신임 정보의 이름입니다. 기본적으로 credential-1이 사용됩니다.
serviceType
작성할 서비스의 유형입니다.
servicePlan
서비스 계획의 이름입니다.
serviceName
작성할 서비스의 이름입니다.

bluemixUtility listServices 명령에 대해 사용 가능한 옵션은 없습니다.

bluemixUtility showService 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

--showCredentials
서비스 신임 정보를 표시합니다.
serviceName
Bluemix 서비스의 이름입니다.

bluemixUtility import 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

--acceptLicense
라이센스 이용 약관에 자동으로 동의함을 표시합니다.
--credentialName=name
서비스 신임 정보의 이름입니다. 기본적으로 발견되는 첫 번째 신임 정보가 사용됩니다.
--encodeAlgorithm=[xor|aes]
가져온 서비스 구성에서 민감한 정보를 인코딩하는 방법을 지정합니다. 지원되는 인코딩 값은 xoraes입니다. 기본 인코딩 알고리즘은 xor입니다.
--encodeKey=key
AES 암호화를 사용하여 인코딩할 때 사용할 키를 지정합니다. 이 옵션이 제공되지 않은 경우, 기본 키가 사용됩니다.
--p[parameter]=value
서비스에 대한 구성을 생성하고 가져오는 데 도움이 되는 매개변수를 지정합니다.
serviceName
Bluemix 서비스의 이름입니다.

bluemixUtility listImports 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

[serverName]
이 특정 서버에 이미 바인드된 서비스를 나열합니다.

bluemixUtility bind 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

--v[variable]=value
가져온 서비스 구성의 변수를 대체합니다.
--acceptLicense
라이센스 이용 약관에 자동으로 동의함을 표시합니다.
serverName
서비스 구성에 바인드할 서버의 이름입니다.
serviceName
가져온 서비스 구성의 이름입니다.

bluemixUtility unbind 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

serverName
서비스 구성을 언바인드할 서버의 이름입니다.
serviceName
언바인드할 서비스 구성의 이름입니다.

bluemixUtility deleteService 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

--force
확인 없이 삭제를 강제 실행합니다.
serviceName
삭제할 서비스의 이름입니다.

bluemixUtility switch 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.

--org=organizationName
조직 이름입니다.
--space=spaceName
영역 이름입니다.

bluemixUtility info 명령에 대해 사용 가능한 옵션은 없습니다.

bluemixUtility logout 명령에 대해 사용 가능한 옵션은 없습니다.

리턴 코드

표 1. 리턴 코드 및 설명
리턴 코드 설명
0 명령이 요청된 조작을 완료했습니다.
20 하나 이상의 명령행 인수 또는 옵션이 올바르지 않습니다.
21 알 수 없는 런타임 예외가 발생했습니다.
22 보통 파일 시스템에서 파일을 삭제하려고 하면 IO 오류가 발생합니다.
24 사용자 중단. 사용자가 프롬프트에 응답하는 데 실패하거나 조작을 취소하는 경우 발생합니다.
26 알 수 없는 예외가 발생했습니다.
27 로그인하려고 하거나 로그인하지 않고 태스크를 수행하려고 할 때 Bluemix 인증 오류.
28 Bluemix와 통신하는 중 발생하는 일반 오류.
29 구성 서비스와 통신하는 중에 발생하는 일반 오류.
30 일반 서비스 구성 오류가 발생했습니다.
31 일반 기능 설치 오류가 발생했습니다.
255 알 수 없는 오류가 발생했습니다.

주제의 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_blmx_utility
파일 이름: rwlp_blmx_utility.html