IBM Analytics Engine 서버리스 인스턴스 프로비저닝

서버리스 IBM Analytics Engine 서비스 인스턴스를 작성할 수 있습니다.

서버리스 인스턴스를 프로비저닝하는 동안 특정 한계 및 할당량 설정을 정의할 수 없습니다. 이 값은 사전 정의되어 있습니다. 이러한 설정 및 해당 값의 목록은 Analytics Engine 인스턴스의 한계 및 할당량을 참조하십시오.

IBM Cloud® us-south (댈러스) 또는 eu-de (프랑크라우트) 지역에 대한 액세스 권한이 있어야 합니다.

IBM Cloud 콘솔에서 서비스 인스턴스 작성

IBM Cloud 콘솔을 사용하여 인스턴스를 작성할 수 있습니다. UI에서 프로비저닝 설정 뒤의 개념을 이해하려면 서버리스 인스턴스의 아키텍처 및 개념을 참조하십시오.

IBM Analytics Engine 인스턴스를 작성하려면 다음을 수행하십시오.

  1. IBM Cloud® 콘솔에 로그인하십시오.

  2. 서비스를 클릭하고 분석 카테고리를 선택하십시오.

  3. Analytics Engine을(를) 검색한 후 타일을 클릭하여 서비스 인스턴스 작성 페이지를 여십시오.

  4. 서비스 인스턴스를 배치할 위치를 선택하십시오. 현재 us-south 및 eu-de 만 지원되는 지역입니다.

  5. 플랜을 선택하십시오. 현재 Apache Spark의 Standard 서버리스는 유일하게 지원되는 서버리스 플랜입니다.

  6. 선택한 이름을 입력하고 리소스 그룹을 선택하고 태그를 지정하여 인스턴스를 구성하십시오.

  7. 기본 Spark 런타임을 선택하십시오. Spark 3.4 기본값입니다. 런타임은 기본적으로 시공간, 데이터 건너뛰기, Paquet 모듈식 암호화 패키지를 미리 설치합니다.

  8. 인스턴스 관련 데이터를 저장하기 위해 instance home(으)로 사용할 계정에서 IBM Cloud Object Storage 인스턴스를 선택하십시오.

  9. Spark 구성 값을 추가하여 기본 Apache Spark 설정을 대체하십시오.

  10. 백그라운드에서 서비스 인스턴스를 프로비저닝하려면 작성을 클릭하십시오.

    새로 생성된 서비스는 IBM Cloud® 리소스 목록의 *서비스 아래에 나열됩니다.

IBM Cloud 명령행 인터페이스를 사용하여 서비스 인스턴스 작성

IBM Cloud® 명령행 인터페이스를 사용하여 서비스 인스턴스를 작성하려면 다음을 수행하십시오.

  1. IBM Cloud® CLI를 다운로드하고 구성하십시오. IBM Cloud® CLI 시작하기의 지시사항을 따르십시오.

  2. 사용자 지역에 대한 API 엔드포인트를 설정하고 로그인하십시오.

    ibmcloud api https://{DomainName}
ibmcloud login

  3. 계정에 대한 리소스 그룹 목록을 가져오고 리턴된 리소스 그룹 중 하나를 IBM Analytics Engine 서버리스 인스턴스를 작성할 대상 리소스 그룹으로 선택하십시오.

    ibmcloud resource groups
ibmcloud target -g <resource_group_name>

  4. 서비스 인스턴스를 작성하십시오.

    ibmcloud resource service-instance-create <service_instance_name> ibmanalyticsengine <plan_name> <region> -p @<path_to JSON file with cluster parameters>

    예를 들어 댈러스 지역의 경우

    ibmcloud resource service-instance-create MyServiceInstance ibmanalyticsengine standard-serverless-spark us-south -p @provision.json

    선택한 이름을 서비스 인스턴스에 제공할 수 있습니다. 현재 표준-서버리스-스파크가 유일하게 지원되는 서버리스 요금제이며, 미국-남미와 유럽은 지원되는 유일한 지역입니다.

    provision.json 파일에는 작성할 인스턴스에 대한 프로비저닝 매개변수가 포함됩니다.

    페이로드 JSON 파일에서 IBM Cloud Object Storage 인스턴스에 대한 엔드포인트는 직접 엔드포인트여야 합니다. 다이렉트 엔드포인트는 공용 엔드포인트보다 더 나은 성능을 제공하며 발신 또는 수신 대역폭에 대한 요금이 발생하지 않습니다.

    이는 provision.json 파일의 모양에 대한 샘플입니다. 페이로드의 프로비저닝 매개변수에 관한 설명은 서버리스 인스턴스의 아키텍처 및 개념을 참조하십시오.

    Spark 3.4 지원됩니다. 서비스 인스턴스를 생성할 때 기본 Spark 런타임 버전을 지정하지 않으면 기본적으로 Spark 3.4 사용됩니다.

    {
  "default_runtime": {
    "spark_version": "3.4"
    },
  "instance_home": {
    "region": "us-south",
    "endpoint": "https://s3.direct.us-south.cloud-object-storage.appdomain.cloud",
    "hmac_access_key": "<your-hmac-access-key",
    "hmac_secret_key": "<your-hmac-secret-key"
    },
  "default_config": {
    "key1": "value1",
    "key2": "value2"
    }
}

    인스턴스 작성 명령에 대한 IBM Cloud® 응답:

    Creating service instance MyServiceInstance in resource group Default of account <your account name> as <your user name>...
OK
Service instance MyServiceInstance was created.

Name:                MyServiceInstance
ID:                  crn:v1:staging:public:ibmanalyticsengine:us-south:a/d628eae2cc7e4373bb0c9d2229f2ece5:1e32e***-afd9-483a-b1**-724ba5cf4***::
GUID:                1e32e***-afd9-483a-b1**-724ba5cf4***
Location:            us-south
State:               provisioning
Type:                service_instance
Sub Type:
Service Endpoints:   public
Allow Cleanup:       false
Locked:              false
Created at:          2021-11-29T07:20:40Z
Updated at:          2021-11-29T07:20:42Z
Last Operation:
                    Status    create in progress
                    Message   Started create instance operation

    출력에서 인스턴스 ID를 기록하십시오. 인스턴스 관리 또는 Spark 애플리케이션 관리 API를 호출할 때 인스턴스 ID가 필요합니다. Spark 애플리케이션 REST API를 참조하십시오.

  5. 인스턴스 준비를 추적하십시오.

리소스 제어기 REST API를 사용하여 서비스 인스턴스 작성

IBM Analytics Engine 서버리스 인스턴스는 IBM Cloud® 리소스 그룹에 있어야 합니다. 리소스 제어기 REST API를 통해 IBM Analytics Engine 서버리스 인스턴스를 작성하는 첫 번째 단계로 리소스 그룹 ID 및 서버리스 플랜 ID를 준비해야 합니다.

리소스 제어기 REST API를 사용하여 서비스 인스턴스를 작성하려면 다음을 수행하십시오.

  1. IBM Cloud® CLI에 로그인하고 다음 명령을 실행하여 리소스 그룹 ID를 가져오십시오.

    ibmcloud resource groups

    샘플 결과:

    Retrieving all resource groups under account <Account details..>
OK
Name      ID      Default Group   State
Default   XXXXX   true            ACTIVE

  2. Apache Spark의 Standard 서버리스 플랜에 다음 리소스 플랜 ID를 사용하십시오.

    8afde05e-5fd8-4359-a597-946d8432dd45

  3. 다음 단계를 수행하여 IAM 토큰을 가져오십시오.

  4. 다음과 같이 리소스 제어기 REST API를 사용하여 인스턴스를 작성하십시오.

    curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances/
--header "Authorization: Bearer $token" -H 'Content-Type: application/json' -d @provision.json

    provision.json 파일에는 작성할 인스턴스에 대한 프로비저닝 매개변수가 포함됩니다. 페이로드의 프로비저닝 매개변수에 관한 설명은 서버리스 인스턴스의 아키텍처 및 개념을 참조하십시오.

    Spark 3.4 지원됩니다. 서비스 인스턴스를 생성할 때 기본 Spark 런타임 버전을 지정하지 않으면 기본적으로 Spark 3.0이 사용됩니다.

    이는 provision.json 파일의 모양에 대한 샘플입니다.

    {
  "name": "your-service-instance-name",
  "resource_plan_id": "8afde05e-5fd8-4359-a597-946d8432dd45",
  "resource_group": "resource-group-id",
  "target": "us-south",
  "parameters": {
    "default_runtime": {
      "spark_version": "3.4"
        },
        "instance_home": {
          "region": "us-south",
          "endpoint": "s3.direct.us-south.cloud-object-storage.appdomain.cloud",
          "hmac_access_key": "your-access-key",
          "hmac_secret_key": "your-secret-key"
          }
    }
}

  5. 인스턴스 준비를 추적하십시오.

인스턴스를 작성하기 위한 리소스 제어기 REST API에 관한 자세한 정보는 새 리소스 인스턴스 작성(프로비저닝)을 참조하십시오.

인스턴스 준비 추적

새로 작성된 서버리스 인스턴스에서 애플리케이션을 실행하려면 인스턴스가 active 상태여야 합니다.

인스턴스 준비를 추적하려면 다음을 수행하십시오.

  1. 다음 명령을 입력하십시오.
    curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/{instance_id} -H "Authorization: Bearer $token"
    샘플 응답:
    {
  "id": "dc0e****-eab2-4t9e-9441-56620949****",
  "state": "created",
  "state_change_time": "2021-04-21T04:24:01Z",
  "default_runtime": {
    "spark_version": "3.4",
    "instance_home": {
      "provider": "ibm-cos",
      "type": "objectstore",
      "region": "us-south",
      "endpoint": "https://s3.direct.us-south.cloud-object-storage.appdomain.cloud",
      "bucket": "ae-bucket-do-not-delete-dc0e****-eab2-4t**-9441-566209499546",
      "hmac_access_key": "eH****g=",
      "hmac_secret_key": "4d********76"
    },
    "default_config": {
      "spark.driver.memory": "4g",
      "spark.driver.cores": 1
    }
  }
}
  2. "state" 속성의 값을 확인하십시오. 인스턴스에서 애플리케이션 실행을 시작하려면 active이어야 합니다.

자세한 정보

서버리스 인스턴스를 프로비저닝할 때 권장되는 우수 사례 를 따르십시오.