Serviceinstanz über IBM Cloud-Konsole erstellen

Sie können eine Instanz mithilfe der IBM Cloud -Konsole erstellen. Informationen zu den Konzepten hinter Bereitstellungseinstellungen in der Benutzerschnittstelle finden Sie unter Architektur und Konzepte in serverunabhängigen Instanzen.

Gehen Sie wie folgt vor, um eine IBM Analytics Engine-Instanz zu erstellen:

1. Melden Sie sich an der IBM Cloud®-Konsolean.

2. Klicken Sie auf Services und wählen Sie die Kategorie aus Analyse.

3. Suchen Sie nach Analytics Engine und klicken Sie dann auf die Kachel, um die Seite zum Erstellen der Serviceinstanz zu öffnen.

4. Wählen Sie die Position aus, an der die Serviceinstanz bereitgestellt werden soll. Zurzeit sind us-south und eu-de die einzigen unterstützten Regionen.

5. Wählen Sie einen Plan aus. Derzeit ist Standard Serverless für Apache Spark der einzige unterstützte serverunabhängige Plan.

6. Konfigurieren Sie die Instanz, indem Sie einen Namen Ihrer Wahl eingeben, eine Ressourcengruppe auswählen und Tags hinzufügen.

7. Wählen Sie die Spark-Standardlaufzeit aus. Spark 3.4 ist Standard. Die Laufzeit installiert standardmäßig die Pakete für räumlich-zeitliche Verschlüsselung, das Überspringen von Daten und die modulare Paquet-Verschlüsselung.

8. Wählen Sie die IBM Cloud Object Storage -Instanz aus Ihrem Konto aus, die als instance home zum Speichern instanzbezogener Daten verwendet werden soll.

9. Fügen Sie Spark-Konfigurationswerte hinzu, um Apache Spark-Standardeinstellungen zu überschreiben.

10. Klicken Sie auf Erstellen , um die Serviceinstanz im Hintergrund bereitzustellen.

    Der neu erstellte Dienst wird in Ihrer IBM Cloud® Ressourcenliste unter *Services aufgeführt.

Serviceinstanz über IBM Cloud-Befehlszeilenschnittstelle erstellen

Gehen Sie wie folgt vor, um eine Serviceinstanz über die IBM Cloud®-Befehlszeilenschnittstelle zu erstellen:

1. Laden Sie die IBM Cloud®-CLI herunter und konfigurieren Sie sie. Befolgen Sie die Anweisungen in Einführung in die IBM Cloud® -CLI.

2. Legen Sie den API-Endpunkt für Ihre Region fest und melden Sie sich an:

   ibmcloud api https://{DomainName}
   ibmcloud login
   

3. Rufen Sie die Liste der Ressourcengruppen für Ihr Konto ab und wählen Sie eine der zurückgegebenen Ressourcengruppen als Zielressourcengruppe aus, in der die serverunabhängige IBM Analytics Engine -Instanz erstellt werden soll.

   ibmcloud resource groups
   ibmcloud target -g <resource_group_name>
   

4. Erstellen Sie eine Serviceinstanz:

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

   Zum Beispiel für die Region Dallas:

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

   Sie können der Serviceinstanz einen beliebigen Namen geben. Beachten Sie, dass derzeit nur standard-serverless-spark unterstützt wird und us-south und eu-de die einzigen unterstützten Regionen sind.

   Die Datei "provision.json" enthält die Bereitstellungsparameter für die Instanz, die Sie erstellen wollen.

   Der Endpunkt zu Ihrer IBM Cloud Object Storage Instanz in der Payload JSON Datei sollte der direkte Endpunkt sein. Direkte Endpunkte bieten eine bessere Leistung als öffentliche Endpunkte und es fallen keine Gebühren für ausgehende oder eingehende Bandbreite an.

   Dies ist ein Beispiel dafür, wie die Datei "provision.json" aussehen kann. Eine Beschreibung der Bereitstellungsparameter in den Nutzdaten finden Sie in Architektur und Konzepte in serverunabhängigen Instanzen .

   Beachten Sie, dass Spark 3.4 unterstützt wird. Wenn Sie beim Erstellen einer Serviceinstanz keine Standard-Spark-Laufzeitversion angeben, wird standardmäßig Spark 3.4 verwendet.

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

   Die Antwort IBM Cloud® auf den Befehl zum Erstellen einer Instanz:

   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
   

   Notieren Sie die Instanz-ID aus der Ausgabe. Sie benötigen die Instanz-ID, wenn Sie APIs für das Instanzmanagement oder das Spark-Anwendungsmanagement aufrufen. Siehe Spark-Anwendungs-REST-API.

5. Überwachung der Instanzbereitschaft.

Serviceinstanz mit REST-API des Ressourcencontrollers erstellen

Eine serverunabhängige IBM Analytics Engine -Instanz muss sich in einer IBM Cloud® -Ressourcengruppe befinden. Als ersten Schritt zur Erstellung einer serverunabhängigen IBM Analytics Engine -Instanz über die REST-API des Ressourcencontrollers müssen Sie die Ressourcengruppen-ID und die serverunabhängige Plan-ID zur Hand haben.

Gehen Sie wie folgt vor, um eine Serviceinstanz über die REST-API des Ressourcencontrollers zu erstellen:

1. Rufen Sie die Ressourcengruppen-ID ab, indem Sie sich an der IBM Cloud® -CLI anmelden und den folgenden Befehl ausführen:

   ibmcloud resource groups
   

   Beispielergebnis:

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

2. Verwenden Sie die folgende Ressourcenplan-ID für den Plan "Standard Serverless for Apache Spark":

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

3. Rufen Sie das IAM-Token ab, indem Sie die folgende Schritteausführen.

4. Erstellen Sie eine Instanz mit der REST-API des Ressourcencontrollers:

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

   Die Datei "provision.json" enthält die Bereitstellungsparameter für die Instanz, die Sie erstellen wollen. Eine Beschreibung der Bereitstellungsparameter in den Nutzdaten finden Sie in Architektur und Konzepte in serverunabhängigen Instanzen .

   Beachten Sie, dass Spark 3.4 unterstützt wird. Wenn Sie beim Erstellen einer Serviceinstanz keine Standard-Spark-Laufzeitversion angeben, wird standardmäßig Spark 3. verwendet.

   Das folgende Beispiel zeigt, wie die Datei provision.json aussehen kann:

   {
     "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. Überwachung der Instanzbereitschaft.

Weitere Informationen zur REST-API des Ressourcencontrollers für die Erstellung einer Instanz finden Sie unter Neue Ressourceninstanz erstellen (bereitstellen).

Überwachung der Instanzbereitschaft

Um Anwendungen in einer neu erstellten serverunabhängigen Instanz auszuführen, muss sich die Instanz im Status active befinden.

So verfolgen Sie die Instanzbereitschaft:

1. Geben Sie den folgenden Befehl ein:

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

   Beispielantwort:

   {
     "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. Überprüfen Sie den Wert des Attributs "state". Es muss active lauten, bevor Sie aktive Anwendungen in der Instanz starten können.

Weitere Informationen

Befolgen Sie bei der Bereitstellung serverloser Instanzen die empfohlenen Best Practices.