Code Engine CLI 시작하기

IBM Cloud® Code Engine API를 사용하여 Code Engine 엔티티를 작성하고 관리할 수 있습니다.

CLI 환경 설정하기

CLI를 사용하여 Code Engine 엔티티를 작성하고 관리하려면 CLI 환경을 설정하십시오. IBM Cloud CLI의 최신 버전이 설치되어 있는지 확인하십시오.

시작하기 전에

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

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

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

    1. IBM Cloud에 로그인하십시오.
        ibmcloud login
    ```
2. 계정이 두 개 이상 있는 경우 사용할 계정을 선택하라는 프롬프트가 표시됩니다. 프롬프트를 따르거나 **`target`** 명령을 사용하여 IBM Cloud 계정을 선택하십시오.

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. 지역을 지정합니다. 다음 **`target`** 명령을 사용하여 영역을 지정하거나 변경하십시오.

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. 리소스 그룹을 지정하십시오. 리소스 그룹 목록을 가져오려면 다음 명령을 실행하십시오.

```txt {: pre}
    ibmcloud resource groups
    ```
    출력 예

    ```txt {: screen}
    Retrieving all resource groups under account <account_id> as email@ibm.com...
    OK
    Name      ID                                 Default Group   State   
    default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
    test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE
    ```
5. 다음 명령을 실행하여 리소스 그룹을 대상으로 지정하십시오.

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    출력 예

    ```txt {: screen}
    Targeted resource group default
    ```

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

    ibmcloud plugin install code-engine

  4. Code Engine CLI 플러그인이 설치되어 있는지 확인하십시오. ibmcloud code-engine version 명령 또는 ibmcloud plugin list 명령을 사용하여 플러그인이 설치되었는지 확인할 수 있습니다.

    ibmcloud code-engine version

    출력 예

    OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d

  5. ibmcloud ce help 명령을 실행하여 Code Engine CLI에 대한 명령을 보십시오. 예를 들면 다음과 같습니다.

    ibmcloud ce help

Code Engine CLI에 대한 작업

이제 Code Engine CLI 환경이 설정되었으므로 CLI를 사용하여 애플리케이션, 기능 또는 작업과 같은 Code Engine 리소스에 대해 작업할 준비가 되었습니다.

Code Engine 리소스에 대해 작업하려면 먼저 프로젝트의 컨텍스트 내에서 작업해야 합니다.

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

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

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

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

  1. project create 명령을 사용하여 프로젝트를 작성하십시오. 사용자 지역에 고유한 프로젝트 이름을 사용하십시오.

    ibmcloud ce project create --name PROJECT_NAME

    출력 예

    Creating project 'myproject'...
OK

  2. project get 명령으로 프로젝트에 대한 세부사항을 보십시오.

    ibmcloud ce project get --name PROJECT_NAME

    출력 예

    Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

또는 project list 명령을 사용하여 작성된 프로젝트의 목록을 표시할 수 있습니다.

CLI를 사용하여 프로젝트에 대해 작업하려면 프로젝트를 현재 컨텍스트로 선택해야 합니다. --no-select 옵션을 지정하지 않으면 프로젝트가 작성될 때 자동으로 현재 컨텍스트로 선택됩니다. 현재 대상으로 지정되지 않은 프로젝트를 선택하려면 project select 명령을 사용하십시오.

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

다음 단계

CLI 환경을 설정했고 Code Engine 프로젝트의 컨텍스트 내에서 작업 중인지 확인하기 위한 첫 번째 단계를 수행했으므로 Code Engine CLI를 사용하여 앱, 기능 및 작업에 대해 작업할 수 있습니다.

CLI를 사용하여 Code Engine 컴포넌트에 대한 작업을 시작하려면 다음 주제를 참조하십시오.

Code Engine CLI에 대한 자세한 정보는 CLI 환경 설정 을 참조하십시오.

Code Engine CLI 환경에서의 작업에 대한 자세한 정보는 Code Engine CLI 명령 참조 문서 를 참조하십시오.

CLI의 각 버전에 대한 변경사항 요약은 CLI 버전 히스토리 를 참조하십시오. 사용 가능한 명령과 옵션을 모두 사용할 수 있도록 CLI를 최신 상태로 유지하십시오.