Einen interaktiven Endpunkt für Ihren virtuellen Cluster erstellen

Auf dieser Seite wird beschrieben, wie Sie mithilfe der AWS-Befehlszeilenschnittstelle (AWS CLI) einen interaktiven Endpunkt erstellen.

Erstellen Sie einen interaktiven Endpunkt mit dem create-managed-endpoint-Befehl

Geben Sie die Parameter im create-managed-endpoint-Befehl wie folgt an. Amazon EMR in EKS unterstützt die Erstellung interaktiver Endpunkte mit Amazon-EMR-Versionen 6.7.0 und später.

aws emr-containers create-managed-endpoint \
‐‐type JUPYTER_ENTERPRISE_GATEWAY \
‐‐virtual‐cluster‐id 1234567890abcdef0xxxxxxxx \
‐‐name example-endpoint-name \
‐‐execution-role-arn arn:aws:iam::444455556666:role/JobExecutionRole \
‐‐release-label emr-6.9.0-latest \
‐‐configuration-overrides '{
    "applicationConfiguration": [{
        "classification": "spark-defaults",
        "properties": {
            "spark.driver.memory": "2G"
        }
    }],
    "monitoringConfiguration": {
        "cloudWatchMonitoringConfiguration": {
            "logGroupName": "log_group_name",
            "logStreamNamePrefix": "log_stream_prefix"
        },
        "persistentAppUI": "ENABLED",
        "s3MonitoringConfiguration": {
            "logUri": "s3://my_s3_log_location"
        }
    }
}'

Weitere Informationen finden Sie unter Parameter für die Erstellung eines interaktiven Endpunkts.

Erstellen Sie einen interaktiven Endpunkt mit angegebenen Parametern in einer JSON-Datei

1. Erstellen Sie eine create-managed-endpoint-request.json-Datei und geben Sie die erforderlichen Parameter für Ihren Endpunkt an, wie in der folgenden JSON-Datei gezeigt:

   {
       "name": "MY_TEST_ENDPOINT",
       "virtualClusterId": "MY_CLUSTER_ID",
       "type": "JUPYTER_ENTERPRISE_GATEWAY",
       "releaseLabel": "emr-6.9.0-latest",
       "executionRoleArn": "arn:aws:iam::444455556666:role/JobExecutionRole",
       "configurationOverrides":
       {
           "applicationConfiguration": 
           [
               {
                   "classification": "spark-defaults",
                   "properties":
                   {
                       "spark.driver.memory": "8G"
                   }
               }
           ],
           "monitoringConfiguration":
           {
               "persistentAppUI": "ENABLED",
               "cloudWatchMonitoringConfiguration":
               {
                   "logGroupName": "my_log_group",
                   "logStreamNamePrefix": "log_stream_prefix"
               },
               "s3MonitoringConfiguration":
               {
                   "logUri": "s3://my_s3_log_location"
               }
           }
       }
   }

2. Verwenden Sie den create-managed-endpoint-Befehl mit einem Pfad zu der lokal gespeicherten create-managed-endpoint-request.json-Datei in Amazon S3.

   aws emr-containers create-managed-endpoint \
   ‐‐cli-input-json  file://./create-managed-endpoint-request.json ‐‐region AWS-Region

Ausgabe von interaktivem Endpunkt erstellen

Die Ausgabe sollte im Terminal folgendermaßen aussehen. Die Ausgabe enthält den Namen und die Kennung Ihres neuen interaktiven Endpunkts:

{
    "id": "1234567890abcdef0",
    "name": "example-endpoint-name", 
    "arn": "arn:aws:emr-containers:us-west-2:111122223333:/virtualclusters/444455556666/endpoints/444455556666",
    "virtualClusterId": "111122223333xxxxxxxx"
}

Beim Ausführen von aws emr-containers create-managed-endpoint wird ein selbstsigniertes Zertifikat erstellt, das die HTTPS-Kommunikation zwischen EMR Studio und dem interaktiven Endpunktserver ermöglicht.

Wenn Sie create-managed-endpoint ausführen und die Voraussetzungen nicht erfüllt haben, gibt Amazon EMR eine Fehlermeldung mit den Maßnahmen zurück, die Sie ergreifen müssen, um fortzufahren.

Parameter für die Erstellung eines interaktiven Endpunkts

Erforderliche Parameter für interaktive Endpunkte

Sie müssen die folgenden Parameter angeben, wenn Sie einen interaktiven Endpunkt erstellen:

‐‐type

Verwenden Sie JUPYTER_ENTERPRISE_GATEWAY. Dies ist der einzige unterstützte Typ.

‐‐virtual-cluster-id

Die ID des virtuellen Clusters, den Sie bei Amazon EMR in EKS registriert haben.

‐‐name

Ein aussagekräftiger Name für den interaktiven Endpunkt, der EMR-Studio-Benutzern hilft, ihn aus der Dropdownliste auszuwählen.

‐‐execution-role-arn

Der Amazon-Ressourcenname (ARN) Ihrer IAM-Aufgabenausführungsrolle für Amazon EMR in EKS, die als Teil der Voraussetzungen erstellt wurde.

‐‐release-label

Die Versionskennung der Amazon-EMR-Version, die für den Endpunkt verwendet werden soll. Zum Beispiel emr-6.9.0-latest. Amazon EMR in EKS unterstützt interaktive Endpunkte mit Amazon-EMR-Versionen 6.7.0 und höher.

Optionale Parameter für interaktive Endpunkte

Optional können Sie beim Erstellen eines interaktiven Endpunkts auch die folgenden Parameter angeben:

‐‐configuration-overrides

Um die Standardkonfigurationen für Anwendungen zu überschreiben, geben Sie ein Konfigurationsobjekt an. Sie können eine Syntax-Kurznotation verwenden, um die Konfiguration anzugeben oder Sie können auf die Konfiguration in einer JSON-Datei zu verweisen.

Konfigurationsobjekte bestehen aus einer Klassifizierung, Eigenschaften und optionalen verschachtelten Konfigurationen. Eigenschaften bestehen aus den Einstellungen, die Sie in dieser Datei überschreiben möchten. Sie können mehrere Klassifizierungen für mehrere Anwendungen in einem einzigen JSON-Objekt angeben. Die verfügbaren Konfigurationsklassifizierungen variieren je nach Amazon EMR in EKS-Version. Eine Liste der Konfigurationsklassifizierungen, die für jede Version von Amazon EMR in EKS verfügbar sind, finden Sie unter Versionen von Amazon EMR in EKS. Zusätzlich zu den Konfigurationsklassifizierungen, die für jede Version aufgeführt sind, bieten interaktive Endpunkte zusätzliche jeg-config-Klassifizierungen. Weitere Informationen finden Sie unter Konfigurationsoptionen für Jupyter Enterprise Gateway (JEG).