CLI 설정

필요한 CLI를 설치, 업데이트 및 삭제하고 IBM Cloud® Code Engine을 사용하도록 환경을 설정하십시오.

Code Engine CLI에 지원되는 환경

Code Engine CLI는 다음 환경을 지원합니다.

  • Linux 64비트
  • Linux 64비트 ARM
  • Linux 32비트
  • Mac OS X 64비트
  • Mac OS X M1/ARM
  • Windows 64비트
  • Windows 32비트

IBM Cloud CLI 설치

최신 버전의 IBM Cloud CLI를 설치하십시오.

시작하기 전에

IBM Cloud 계정을 작성해야 합니다.

  1. IBM Cloud CLI를 다운로드하여 설치하십시오.

    이 설치에는 다음 파일이 포함되어 있습니다.

    • IBM Cloud Functions 플러그인
    • IBM Cloud Object Storage 플러그인
    • IBM Cloud Container Registry 플러그인
    • IBM Cloud Kubernetes Service 플러그인

    자세한 정보는 IBM Cloud CLI를 참조하십시오.

  2. IBM Cloud에 로그인하십시오.

    ibmcloud login

  3. 계정이 두 개 이상 있는 경우 사용할 계정을 선택하라는 프롬프트가 표시됩니다. 프롬프트를 따르거나 target 명령을 사용하여 IBM Cloud 계정을 선택하십시오.

    ibmcloud target -c <account_id>

  4. 지역도 지정해야 합니다. target 명령을 사용하여 지역을 대상으로 지정하거나 변경할 수 있습니다.

    ibmcloud target -r <region>

  5. 리소스 그룹을 지정해야 합니다. 리소스 그룹 목록을 가져오려면 다음 명령을 실행하십시오.

    ibmcloud resource groups

    출력 예

    Retrieving all resource groups under account <account_name> as email@ibm.com...
OK
Name      ID                                 Default Group   State   
default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE

  6. 다음 명령을 실행하여 리소스 그룹을 대상으로 지정하십시오.

    ibmcloud target -g <resource_group>

    출력 예

    Targeted resource group default

Code Engine CLI 플러그인 설치

최신 버전의 Code Engine CLI를 설치하십시오.

최신 버전의 IBM Cloud CLI를 설치했는지 확인하십시오. 그렇지 않으면 Could not find compatible binary to install for plug-in code-engine와 유사한 메시지가 표시되면서 Code Engine CLI 설치가 실패할 수 있습니다.

  1. Code Engine 플러그인을 설치하십시오.

    ibmcloud plugin install code-engine

  2. ibmcloud plugin show code-engine 명령을 사용하여 플러그인이 설치되었는지 확인하십시오.

    ibmcloud plugin show code-engine

    출력 예

    Plugin Name                              code-engine[ce]
Plugin Version                           1.31.0
Plugin SDK Version                       0.9.0
Minimal IBM Cloud CLI version required   1.0.0
Private endpoints supported              true

Commands:
code-engine,ce                    Manage Code Engine components.
[...]

  3. Code Engine 명령을 실행하려면 ibmcloud code-engine 또는 **ibmcloud ce**를 사용하십시오. Code Engine 플러그인을 사용하여 수행할 수 있는 모든 작업을 확인하려면 **ibmcloud ce**를 인수 없이 실행하십시오.

    ibmcloud ce

선택적으로 jq 패키지를 설치할 수 있습니다. 많은 Code Engine 명령에는 JSON 출력을 작성하는 옵션(--output JSON)이 포함되어 있습니다. 이 패키지를 사용하면 명령행에서 JSON 응답을 확인하고 구문 분석할 수 있습니다.

Code Engine 명령에 대한 자세한 정보는 ibmcloud ce 명령을 참조하십시오.

Code Engine CLI 업데이트

새로운 기능을 활용하려면 CLI를 주기적으로 업데이트하십시오.

  1. ibmcloud plugin list 명령을 실행하여 현재 플러그인 목록을 확인하십시오.

    ibmcloud plugin list

    출력 예

    Listing installed plug-ins...

Plugin Name                                  Version   Status             Private endpoints supported
code-engine[ce]                              1.31.0                       true
container-registry                           0.1.571                      true
container-service[kubernetes-service]        1.0.408                      false

  2. 업데이트가 사용 가능한 경우 ibmcloud plugin update 명령을 실행하십시오.

    ibmcloud plugin update code-engine

CLI 설치 제거

CLI가 더 이상 필요하지 않은 경우에는 이를 설치 제거할 수 있습니다.

  1. 설치된 플러그인을 나열하십시오.

    ibmcloud plugin list

  2. 플러그인을 설치 제거하십시오. 예를 들어 Code Engine CLI 플러그인을 설치 제거하려면 다음을 수행하십시오.

    ibmcloud plugin uninstall code-engine

  3. 다음 명령을 실행하고 설치된 플러그인 목록을 확인하여 플러그인이 설치 제거되었는지 확인하십시오.

    ibmcloud plugin list

삭제한 플러그인은 결과에 표시되지 않습니다.

웹 브라우저에서 IBM Cloud Shell 에 액세스

IBM® Cloud Shell에서 웹 브라우저에서 직접 IBM Cloud CLI및 기타 CLI 플러그인을 사용할 수 있습니다.

IBM Cloud Shell 은 기본 IBM Cloud CLI (ibmcloud) 및 Code Engine CLI를 포함하여 여러 플러그인 및 도구에서 사용 가능합니다.

Cloud Shell를 사용하는 동안에는 다음 제한사항을 유념하십시오.

  • 동시에 여러 다른 리소스, 지역 및 계정에 대해 작업할 수 있도록 개별적으로 작동하는 동시 세션을 최대 5개 열 수 있습니다.
  • YAML 파일과 같이 로컬로 다운로드하여 편집하는 모든 파일은 Cloud Shell에 임시로 저장되며 세션 간에 지속되지 않습니다.
  • Cloud Shell에는 일주일 내에 50시간으로 사용이 제한되는 사용 할당량이 있습니다.

IBM Cloud Shell을 실행하고 사용하려면 IBM Cloud 콘솔 메뉴 표시줄에서 Cloud Shell 아이콘 IBM Cloud Shell 아이콘을 클릭하십시오. 세션이 시작되고 현재 계정 인증 정보로 IBM Cloud CLI에 자동으로 로그인됩니다.