Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Einrichtung für den Upgrade-Agenten
Anmerkung
Der Apache Spark Upgrade Agent verwendet regionsübergreifende Inferenz, um Anfragen in natürlicher Sprache zu verarbeiten und Antworten zu generieren. Weitere Informationen finden Sie auf dieser Seite unter. Regionsübergreifende Verarbeitung für den Apache Spark Upgrade Agent Der Amazon SageMaker Unified Studio MCP-Server befindet sich in der Vorschauversion und kann sich ändern.
Voraussetzungen
Bevor wir mit dem Einrichtungsprozess für die Integration mit Kiro CLI beginnen, stellen Sie sicher, dass auf Ihrer Workstation Folgendes installiert ist:
-
AWS Konfiguration lokaler Anmeldeinformationen (über AWS CLI, Umgebungsvariablen oder IAM-Rollen) — für lokale Operationen wie das Hochladen aktualisierter Job-Artefakte für die Ausführung von EMR-Validierungsaufträgen.
Ressourcen einrichten
Sie können eine CloudFormation Vorlage verwenden, um die Ressource für den MCP-Server einzurichten. Diese Vorlagen sind Beispiele, die Sie entsprechend Ihren Anforderungen anpassen sollten. Die Vorlage erstellt die folgenden Ressourcen für den Upgrade-Prozess:
-
IAM-Rolle, die über Berechtigungen zum Aufrufen des MCP-Servers und über erforderliche Berechtigungen für den Upgrade-Prozess für die zugrunde liegende EMR-Plattform verfügt.
-
Amazon S3 S3-Staging-Bucket, der zum Hochladen von Upgrade-Artefakten und optionalem KMS-Schlüssel für die Amazon S3 S3-Verschlüsselung verwendet wird.
Wählen Sie eine der Schaltflächen Launch Stack (Stack starten) in der folgenden Tabelle aus. Dadurch wird der Stack auf der CloudFormation Konsole in der jeweiligen Region gestartet.
Gehen Sie zur Seite „Stack-Details angeben“ und geben Sie den Stack-Namen ein. Geben Sie zusätzliche Informationen unter Parameter ein. Geben Sie die folgenden Informationen ein und fahren Sie mit der Erstellung des Stacks fort.
-
SparkUpgradeIAMRoleName — Name der IAM-Rolle, die für den Spark-Upgrade-Prozess verwendet werden soll
-
Aktivieren EMREC2 — EC2 EMR-Upgrade-Berechtigungen aktivieren (Standard: true)
-
Aktivieren EMRServerless — Aktiviert EMR-Serverless-Upgrade-Berechtigungen (Standard: true)
-
StagingBucketPath- Amazon S3 S3-Pfad für das Staging von Artefakten (z. B. s3://my - bucket/spark-upgrade or my-bucket/spark -upgrade). Leer lassen, um automatisch einen neuen Bucket zu generieren
-
uses3Encryption — Aktivieren Sie die KMS-Verschlüsselung für den Amazon S3 S3-Staging-Bucket (Standard: false, auf true gesetzt, um KMS-Verschlüsselung anstelle der standardmäßigen S3-Verschlüsselung zu verwenden)
-
S3 KmsKeyArn — (Optional) ARN des vorhandenen KMS-Schlüssels für die Amazon S3 S3-Bucket-Verschlüsselung. Wird nur verwendet, wenn useS3Encryption den Wert true hat und Sie bereits einen Bucket mit einem KMS-Schlüssel haben
-
CloudWatchKmsKeyArn— (Optional) ARN des vorhandenen KMS-Schlüssels für die CloudWatch Protokollverschlüsselung (nur EMR Serverless, für Standardverschlüsselung leer lassen)
-
EMRServerlessS3 LogPath — (Optional) S3-Pfad, in dem EMR-Serverless-Anwendungsprotokolle gespeichert werden (z. B. s3://my - bucket/emr-serverless-logs or my-bucket/emr -serverless-logs). Gewährt der IAM-Rolle, sofern angegeben, Lesezugriff auf diese Protokolle zur Analyse. Wird nur verwendet, wenn Enable den Wert EMRServerless true hat
-
ExecutionRoleToGrantS3Access — (Optional) IAM-Rollenname oder ARN der vorhandenen EMR- EC2 /EMR-Serverless-Ausführungsrolle, um Zugriff auf den Amazon S3 S3-Staging-Bucket zu gewähren. Gilt nur, wenn ein neuer Staging-Bucket erstellt wird. Nützlich, um EMR-Jobausführungsrollen Zugriff auf den Staging-Bucket zu gewähren. Unterstützt sowohl einfache Rollennamen als auch Rollennamen ARNs mit Pfaden.
Sie können die CloudFormation Vorlage
# deploy the stack with CloudFormation CLI commands aws cloudformation deploy \ --template-file spark-upgrade-mcp-setup.yaml \ --stack-name spark-mcp-setup \ --region <your mcp server launch region> \ --capabilities CAPABILITY_NAMED_IAM \ --parameter-overrides \ ExecutionRoleToGrantS3Access=<your EMR or EMR Serverless job execution role> # retrieve the 1-line instruction to set the local environment variables, which will be used for the following MCP server configuration aws cloudformation describe-stacks \ --stack-name spark-mcp-setup \ --region <your mcp server launch region> \ --query "Stacks[0].Outputs[?OutputKey=='ExportCommand'].OutputValue" \ --output text
Öffnen Sie die Registerkarte Ausgaben (oder rufen Sie sie über den obigen CLI-Befehl CloudFormation describe-stacks auf)ExportCommand, kopieren Sie die einzeilige Anweisung und führen Sie sie dann in Ihrer lokalen Umgebung aus. Beispiel für eine einzeilige Anweisung:
export SMUS_MCP_REGION=<your mcp server launch region> && export IAM_ROLE=arn:aws:iam::111122223333:role/spark-upgrade-role-xxxxxx && export STAGING_BUCKET_PATH=<your staging bucket path>
Führen Sie dann den folgenden Befehl lokal aus, um das IAM-Profil und die MCP-Serverkonfiguration einzurichten
# Step 1: Configure AWS CLI Profile aws configure set profile.spark-upgrade-profile.role_arn ${IAM_ROLE} aws configure set profile.spark-upgrade-profile.source_profile <AWS CLI Profile to assume the IAM role - ex: default> aws configure set profile.spark-upgrade-profile.region ${SMUS_MCP_REGION} # Step 2: if you are using Kiro CLI, use the following command to add the MCP configuration kiro-cli-chat mcp add \ --name "spark-upgrade" \ --command "uvx" \ --args "[\"mcp-proxy-for-aws@latest\",\"https://sagemaker-unified-studio-mcp.${SMUS_MCP_REGION}.api.aws/spark-upgrade/mcp\", \"--service\", \"sagemaker-unified-studio-mcp\", \"--profile\", \"spark-upgrade-profile\", \"--region\", \"${SMUS_MCP_REGION}\", \"--read-timeout\", \"180\"]" \ --timeout 180000\ --scope global
Dies sollte aktualisiert ~/.kiro/settings/mcp.json werden und die MCP-Serverkonfiguration wie folgt enthalten.
{ "mcpServers": { "spark-upgrade": { "type": "stdio", "command": "uvx", "args": [ "mcp-proxy-for-aws@latest", "https://sagemaker-unified-studio-mcp.us-east-1.api.aws/spark-upgrade/mcp", "--service", "sagemaker-unified-studio-mcp", "--profile", "spark-upgrade-profile", "--region", "us-east-1", "--read-timeout", "180" ], "timeout": 180000, "disabled": false } } }
Anleitungen Den Upgrade-Agenten verwenden zur Konfiguration verschiedener MCP-Clients wie Kiro, Cline und finden Sie unter. GitHub CoPilot