Configurazione per Upgrade Agent - Amazon EMR
PrerequisitiRisorse per l'installazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione per Upgrade Agent

Nota

L'agente di aggiornamento Apache Spark utilizza l'inferenza interregionale per elaborare le richieste in linguaggio naturale e generare risposte. Per maggiori dettagli, consulta questa pagina su. Elaborazione interregionale per Apache Spark Upgrade Agent Il server MCP Amazon SageMaker Unified Studio è disponibile in anteprima ed è soggetto a modifiche.

Prerequisiti

Prima di iniziare il nostro processo di configurazione per l'integrazione con Kiro CLI, assicurati di avere installato quanto segue sulla tua workstation:

Risorse per l'installazione

È possibile utilizzare un CloudFormation modello per configurare la risorsa per il server MCP. Questi modelli sono esempi che è necessario modificare per soddisfare i requisiti. Il modello crea le seguenti risorse per il processo di aggiornamento:

  • Ruolo IAM che dispone delle autorizzazioni per chiamare MCP Server e delle autorizzazioni richieste per il processo di aggiornamento per la piattaforma EMR sottostante.

  • Bucket di staging Amazon S3 utilizzato per caricare elementi di aggiornamento e chiave KMS opzionale per la crittografia Amazon S3.

Scegli uno dei pulsanti Launch Stack (Avvia stack) nella tabella seguente. Questo avvia lo stack sulla console nella rispettiva regione. CloudFormation

Region Avvia
Stati Uniti orientali (Virginia settentrionale)
Stati Uniti orientali (Ohio)
Stati Uniti occidentali (Oregon)
Europa (Irlanda)
Asia Pacifico (Tokyo)
Asia Pacifico (Singapore)
Asia Pacifico (Sydney)
Canada (Centrale)
Sud America (San Paolo)
Europa (Francoforte)
Europa (Stoccolma)
Europe (Londra)
Europa (Parigi)
Asia Pacifico (Seoul)
Asia Pacifico (Mumbai)

Vai alla pagina Specificare i dettagli dello stack, inserisci il nome dello stack. Inserisci informazioni aggiuntive sotto Parameters (Parametri). Fornisci le seguenti informazioni e procedi con la creazione dello stack.

  • SparkUpgradeIAMRoleNome: nome del ruolo IAM da utilizzare per il processo di aggiornamento di Spark

  • Abilita EMREC2: abilita le autorizzazioni di EC2 aggiornamento EMR (impostazione predefinita: true)

  • AbilitaEMRServerless: abilita le autorizzazioni di aggiornamento senza server EMR (impostazione predefinita: true)

  • StagingBucketPath- Percorso Amazon S3 per lo staging degli artefatti (ad esempio, s3://my - -upgrade). bucket/spark-upgrade or my-bucket/spark Lascia vuoto per generare automaticamente un nuovo bucket

  • uses3Encryption: abilita la crittografia KMS per lo staging bucket di Amazon S3 (impostazione predefinita: false, impostata su true per utilizzare la crittografia KMS anziché la crittografia S3 predefinita)

  • S3 KmsKeyArn - (Facoltativo) ARN della chiave KMS esistente per la crittografia dei bucket Amazon S3. Utilizzato solo se UseS3Encryption è vero e disponi di un bucket esistente con una chiave KMS

  • CloudWatchKmsKeyArn- (Facoltativo) ARN della chiave KMS esistente per la CloudWatch crittografia dei registri (solo EMR Serverless, lascia vuoto per la crittografia predefinita)

  • EMRServerlessS3 LogPath - (Facoltativo) Percorso S3 in cui sono archiviati i log delle applicazioni EMR-serverless (ad esempio, s3://my - -serverless-logs). bucket/emr-serverless-logs or my-bucket/emr Se fornito, concede al ruolo IAM l'accesso in lettura a questi log per l'analisi. Utilizzato solo quando Enable è vero EMRServerless

  • ExecutionRoleToGrantS3Access - (Facoltativo) Nome del ruolo IAM o ARN del ruolo di esecuzione EC2 senza server EMR- /EMR esistente per concedere l'accesso al bucket di staging di Amazon S3. Si applica solo quando viene creato un nuovo bucket di staging. Utile per concedere ai ruoli di esecuzione dei lavori EMR l'accesso allo staging bucket. Supporta sia nomi di ruolo semplici che percorsi. ARNs

Puoi anche scaricare e rivedere il CloudFormation modello, specificare le opzioni sopra e avviare il modello da solo con i comandi CloudFormation CLI, vedi sotto per un esempio:

# 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

Apri la scheda Output (o recupera dal comando CLI CloudFormation describe-stacks sopra) e copia l'ExportCommandistruzione a 1 riga, quindi eseguila nel tuo ambiente locale. Esempio di istruzione a 1 riga:

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>

Quindi esegui il seguente comando localmente per configurare il profilo IAM e la configurazione del server MCP

# 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

Questo dovrebbe ~/.kiro/settings/mcp.json aggiornarsi per includere la configurazione del server MCP come di seguito.

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

Consulta Utilizzo dell'Upgrade Agent la guida alla configurazione per diversi client MCP come Kiro, Cline e. GitHub CoPilot