Suministro de una instancia sin servidor de IBM Analytics Engine

Puede crear una instancia de servicio de IBM Analytics Engine sin servidor:

Utilización de la consola de IBM Cloud
Utilizando la interfaz de la línea de mandatos IBM Cloud
Utilizando la API REST de controlador de recursos

Tenga en cuenta que no puede definir determinados valores de limitación y cuota al suministrar una instancia sin servidor. Estos valores están predefinidos. Consulte Límites y cuotas para instancias de Analytics Engine para obtener una lista de esta configuración y sus valores.

Debe tener acceso a IBM Cloud® us-south (Dallas) o a la región eu-de (Frankurt).

Creación de una instancia de servicio desde la consola de IBM Cloud

Puede crear una instancia utilizando la consola de IBM Cloud. Para comprender los conceptos en los que se basan los valores de suministro de la interfaz de usuario, consulte Arquitectura y conceptos en instancias sin servidor.

Para crear una instancia de IBM Analytics Engine:

Inicie sesión en la consola deIBM Cloud®.
Pulse Sevicios y seleccione la categoría Análisis.
Busque Analytics Engine y, a continuación, pulse el mosaico para abrir la página de creación de la instancia de servicio.
Elija la ubicación en la que desea que se despliegue la instancia de servicio. Actualmente, us-south y eu-de son las únicas regiones soportadas.
Seleccione un plan. Actualmente, Standard Serverless for Apache Spark es el único plan sin servidor soportado.
Configure la instancia especificando un nombre de su elección, seleccionando un grupo de recursos y añadiendo etiquetas.
Seleccione el tiempo de ejecución de Spark predeterminado. Spark 3.4 es la versión por defecto. El tiempo de ejecución preinstala de forma predeterminada los paquetes de cifrado modular de Parquet, de omisión de datos y espacio-temporales.
Seleccione la instancia de IBM Cloud Object Storage de la cuenta que desea utilizar como instance home para almacenar los datos relacionados con la instancia.
Añada valores de configuración de Spark para sustituir los valores predeterminados de Apache Spark.
Pulse Crear para suministrar la instancia de servicio en segundo plano.

El servicio recién creado aparece en su lista de recursosIBM Cloud® en *Servicios.

Creación de una instancia de servicio utilizando la interfaz de línea de mandatos de IBM Cloud

Para crear una instancia de servicio utilizando la interfaz de línea de mandatos de IBM Cloud®:

Descargue y configure la CLI de IBM Cloud®. Siga las instrucciones de Iniciación a la CLI de IBM Cloud®.
Establezca el punto final de API para la región e inicie sesión:
```
ibmcloud api https://{DomainName}
ibmcloud login
```
Obtenga la lista de los grupos de recursos de la cuenta y seleccione uno de los grupos de recursos devueltos como grupo de recursos de destino en el que crear la instancia sin servidor de IBM Analytics Engine:
```
ibmcloud resource groups
ibmcloud target -g <resource_group_name>
```

Cree una instancia de servicio:

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

Por ejemplo, para la región de Dallas:

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

Puede dar a la instancia de servicio el nombre que prefiera. Tenga en cuenta que actualmente, standard-serverless-spark es el único plan serverless soportado y us-south y eu-de las únicas regiones soportadas.

El archivo provision.json contiene los parámetros de suministro de la instancia que desea crear.

El punto final de su instancia IBM Cloud Object Storage en el archivo JSON de carga útil debe ser el punto final directo. Los puntos finales directos ofrecen mejor rendimiento que los públicos y no incurren en gastos por ancho de banda saliente o entrante.

Este es un ejemplo del aspecto que puede tener el archivo provision.json. Consulte Arquitectura y conceptos en instancias sin servidor para obtener una descripción de los parámetros de suministro en la carga útil.

Tenga en cuenta que Spark 3.4 es compatible. Si no se especifica una versión de tiempo de ejecución de Spark por defecto al crear una instancia de servicio, se toma Spark 3.4 por defecto.

{
  "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"
    }
}

La respuesta de IBM Cloud® al mandato de creación de instancia:

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

Anote el ID de instancia de la salida. Necesitará el ID de instancia cuando llame a las API de gestión de aplicaciones de Spark o de gestión de instancias. Consulte API REST de aplicación de Spark.

Realizar seguimiento de preparación de instancia.

Creación de una instancia de servicio utilizando la API REST del controlador de recursos

Una instancia sin servidor de IBM Analytics Engine debe residir en un grupo de recursos de IBM Cloud®. Como primer paso para crear una instancia sin servidor de IBM Analytics Engine a través de la API REST del controlador de recursos, debe disponer del ID de grupo de recursos y el ID de plan sin servidor.

Para crear una instancia de servicio mediante la API REST del controlador de recursos:

Obtenga el ID de grupo de recursos iniciando sesión en la CLI de IBM Cloud® y ejecutando el mandato siguiente:

ibmcloud resource groups

Resultado de ejemplo:

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

Utilice el siguiente ID de plan de recursos para el plan Standard Serverless for Apache Spark:
```
8afde05e-5fd8-4359-a597-946d8432dd45
```
Obtenga la señal de IAM realizando los pasos siguientes.

Cree una instancia mediante la API REST del controlador de recursos:

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

El archivo provision.json contiene los parámetros de suministro de la instancia que desea crear. Consulte Arquitectura y conceptos en instancias sin servidor para obtener una descripción de los parámetros de suministro en la carga útil.

Tenga en cuenta que Spark 3.4 es compatible. Si no se especifica una versión de tiempo de ejecución de Spark por defecto al crear una instancia de servicio, se toma Spark 3. por defecto.

Este es un ejemplo del aspecto que puede tener el archivo 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"
          }
    }
}

Realizar seguimiento de preparación de instancia.

Para obtener más información sobre la API REST del controlador de recursos para crear una instancia, consulte Crear (suministrar) una nueva instancia de recurso.

Seguimiento de preparación de instancias

Para ejecutar aplicaciones en una instancia sin servidor recién creada, la instancia debe estar en estado active.

Para realizar un seguimiento de la preparación de la instancia:

Escriba el mandato siguiente:

curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/{instance_id} -H "Authorization: Bearer $token"

Respuesta de ejemplo:

{
  "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
    }
  }
}

Compruebe el valor del atributo "state". Debe ser active para poder empezar a ejecutar aplicaciones en la instancia.

Más información

Al suministrar instancias sin servidor, siga las Prácticas recomendadas recomendadas.