bluemixUtility 명령
IBM® Bluemix® 명령행 유틸리티를 사용하면 특정 IBM Cloud 클라우드 서비스를 사용하도록 사내 구축형 Liberty 서버를 구성할 수 있습니다.
IBM Bluemix는 이제 IBM Cloud이고 https://console.bluemix.net에서는 이러한 이름을 동일한 클라우드 플랫폼으로 참조합니다.
소스
- IBM Cloud 계정에 등록하거나 로그인하려면 IBM Cloud에 등록을 참조하십시오.
- Watson에 대해 자세히 살펴보려면 Watson 서비스를 참조하십시오.
- Cloudant 서비스에 대해 자세히 살펴보려면 Cloudant NoSQL DB 시작하기를 참조하십시오.
구문
bluemixUtility action [options]
- login
- IBM Cloud에 로그인하십시오. 옵션 없이 login 명령을 실행하면 도구가 사용자 이름 및 비밀번호 등의 자세한 정보 입력 프롬프트를 표시합니다. 로그인에 성공하면 사용자 이름 및 비밀번호를 다시 지정하지 않고도 다른 명령을 실행할 수 있도록 IBM Cloud 신임 정보가 파일에 저장됩니다.
- Cloud Foundry(cf) 클라이언트를 사용하여 IBM Cloud에 로그인하는 경우 bluemixUtility는 cf 클라이언트가 저장한 신임 정보를 사용합니다. 자세한 정보는 Cloud Foundry(cf) 명령을 참조하십시오.
- bmarketplace
- 명령행 유틸리티를 사용하여 구성할 수 있는 모든 IBM Cloud 서비스를 나열합니다.
- createService
- IBM Cloud 카탈로그에서 서비스 인스턴스를 작성합니다.
- listServices
- 사용 가능한 모든 IBM Cloud 서비스 인스턴스를 나열합니다.
- showService
- 서비스 인스턴스에 대한 정보를 표시합니다.
- import
- 서비스에 대한 구성을 가져옵니다. 가져온 서비스 구성 및 해당 종속 항목은 다음 디렉토리에 배치됩니다.
${wlp.user.dir}/shared/config/services/serviceName
- listImports
- Liberty 서버에 바인드될 수 있는 모든 가져온 서비스 구성을 나열합니다.
- bind
- IBM Cloud 서비스 구성을 Liberty 서버에 바인드합니다. 서비스에 대한 구성은 특정 옵션에 대한 기본값을 제공할 수 있습니다(예: dataSource 요소의 jndiName). 일부 경우에는 기본값이 애플리케이션의 예상과 일치하지 않습니다. 애플리케이션이 예상하는 값으로 기본값을 대체하려면 --v 옵션을 사용하십시오.
- unbind
- Liberty 서버에서 서비스 구성을 언바인드합니다.
- deleteService
- 서비스 인스턴스를 삭제합니다.
- switch
- 다른 IBM Cloud 조직 또는 영역으로 전환합니다.
- info
- IBM Cloud 연결 정보를 봅니다.
- help
- 설명, 사용법 및 옵션을 보려면 각 명령에서 help 조치를 사용하십시오.
- logout
- IBM Cloud에서 로그아웃합니다. logout 명령은 IBM Cloud 신임 정보를 사용하여 로그인할 때 작성된 파일을 삭제합니다.
사용법
각 조치에 대해 실행할 수 있는 사용법 예를 보십시오.
bluemixUtility login [options]
bluemixUtility marketplace [serviceType...]
bluemixUtility createService [options] serviceType servicePlan serviceName
bluemixUtility listServices
bluemixUtility showService [options] serviceName
bluemixUtility import [options] serviceName
bluemixUtility listImports [serverName]
bluemixUtility bind [options] serverName serviceName
bluemixUtility unbind serverName serviceName
bluemixUtility deleteService [options] serviceName
bluemixUtility switch [options]
bluemixUtility logout
옵션
각 조치에 대해 사용 가능한 옵션을 보십시오.
- --api=url
- Bluemix API 엔드포인트입니다(예: https://api.ng.bluemix.net). API 엔드포인트는 Bluemix 지역 이름으로 설정될 수도 있습니다. 예를 들어, API 엔드포인트는 미국 남부 지역의 경우 us-south, 영국 런던 지역의 경우 eu-gb, 호주 시드니 지역의 경우 au-syd로 설정될 수 있습니다.
- --user=username
- IBM Cloud 계정의 사용자 이름입니다.
- --password=password
- IBM Cloud 계정의 비밀번호입니다.
- --org=organizationName
- 조직 이름입니다.
- --space=spaceName
- 영역 이름입니다.
--sso
- IBM Cloud 연합 ID를 사용하여 로그인하는 데 필요한 일회성 패스코드입니다. 패스코드를 생성하려면 명령으로 지정된 IBM Cloud 패스코드 웹 사이트로 이동한 후 명령행에 생성된 패스코드를 입력하십시오. 이 옵션은 IBM ID를 사용하여 사인인하는 데 필요하지 않습니다.
- [serviceType...]
- 특정 IBM Cloud 서비스에 대한 자세한 정보를 표시합니다. 여러 서비스 이름을 공백으로 구분하여 지정하십시오.
- --credentialName=name
- 서비스 신임 정보의 이름입니다. 기본적으로 credential-1이 사용됩니다.
- serviceType
- 작성할 서비스의 유형입니다.
- servicePlan
- 서비스 계획의 이름입니다.
- serviceName
- 작성할 서비스의 이름입니다.
bluemixUtility listServices 명령에 대해 사용 가능한 옵션은 없습니다.
bluemixUtility showService 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
- --showCredentials
- 서비스 신임 정보를 표시합니다.
- serviceName
- IBM Cloud 서비스의 이름입니다.
bluemixUtility import 명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
- --acceptLicense
- 라이센스 이용 약관에 자동으로 동의함을 표시합니다.
- --credentialName=name
- 서비스 신임 정보의 이름입니다. 기본적으로 발견되는 첫 번째 신임 정보가 사용됩니다.
- --encodeAlgorithm=[xor|aes]
- 가져온 서비스 구성에서 민감한 정보를 인코딩하는 방법을 지정합니다. 지원되는 인코딩 값은 xor 및 aes입니다. 기본 인코딩 알고리즘은 xor입니다.
- --encodeKey=key
- AES 암호화를 사용하여 인코드할 때 사용할 키를 지정합니다. 이 옵션이 제공되지 않은 경우, 기본 키가 사용됩니다.
- --p[parameter]=value
- 서비스에 대한 구성을 생성하고 가져오는 데 도움이 되는 매개변수를 지정합니다.
- serviceName
- IBM Cloud 서비스의 이름입니다.
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 명령에 대해 사용 가능한 옵션은 없습니다.
리턴 코드
리턴 코드 | 설명 |
---|---|
0 | 명령이 요청된 조작을 완료했습니다. |
20 | 하나 이상의 명령행 인수 또는 옵션이 올바르지 않습니다. |
21 | 알 수 없는 런타임 예외가 발생했습니다. |
22 | 보통 파일 시스템에서 파일을 삭제하려고 하면 IO 오류가 발생합니다. |
24 | 사용자 중단. 사용자가 프롬프트에 응답하는 데 실패하거나 조작을 취소하는 경우 발생합니다. |
26 | 알 수 없는 예외가 발생했습니다. |
27 | 로그인하려고 하거나 로그인하지 않고 태스크를 수행하려고 할 때 IBM Cloud 인증 오류. |
28 | IBM Cloud와 통신하는 중 발생하는 일반 오류. |
29 | 구성 서비스와 통신하는 중에 발생하는 일반 오류. |
30 | 일반 서비스 구성 오류가 발생했습니다. |
31 | 일반 기능 설치 오류가 발생했습니다. |
255 | 알 수 없는 오류가 발생했습니다. |