Configuración del agente de actualización - Amazon EMR
Requisitos previosRecursos de configuración

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración del agente de actualización

nota

El agente de actualización de Apache Spark utiliza la inferencia entre regiones para procesar las solicitudes en lenguaje natural y generar respuestas. Para obtener más información, consulte esta página en. Procesamiento entre regiones para el agente de actualización de Apache Spark El servidor MCP de Amazon SageMaker Unified Studio se encuentra en versión preliminar y está sujeto a cambios.

Requisitos previos

Antes de comenzar nuestro proceso de configuración para la integración con la CLI de Kiro, asegúrese de tener lo siguiente instalado en su estación de trabajo:

Recursos de configuración

Puede usar una CloudFormation plantilla para configurar el recurso para el servidor MCP. Estas plantillas son ejemplos que debe modificar para satisfacer sus requisitos. La plantilla crea los siguientes recursos para el proceso de actualización:

  • Función de IAM que tiene permisos para llamar al servidor MCP y los permisos necesarios para el proceso de actualización de la plataforma EMR subyacente.

  • El depósito provisional de Amazon S3 se utiliza para cargar los artefactos de actualización y la clave KMS opcional para el cifrado de Amazon S3.

Elija uno de los botones Lanzar pila de la siguiente tabla. Esto lanza la pila en la CloudFormation consola de la región correspondiente.

Region Lanzar
Este de EE. UU. (Norte de Virginia)
Este de EE. UU. (Ohio)
Oeste de EE. UU. (Oregón)
Europa (Irlanda)
Asia Pacífico (Tokio)
Asia-Pacífico (Singapur)
Asia-Pacífico (Sídney)
Canadá (centro)
América del Sur (São Paulo)
Europa (Fráncfort)
Europa (Estocolmo)
Europa (Londres)
Europa (París)
Asia-Pacífico (Seúl)
Asia-Pacífico (Mumbai)

Diríjase a la página de especificar los detalles de la pila e introduzca el nombre de la pila. Introduzca información adicional en Parámetros. Proporcione la siguiente información y proceda a crear la pila.

  • SparkUpgradeIAMRoleNombre: nombre del rol de IAM que se utilizará en el proceso de actualización de Spark

  • Habilitar EMREC2: habilita los permisos de EC2 actualización de EMR (predeterminado: true)

  • Habilitar EMRServerless: habilite los permisos de actualización sin servidor EMR (predeterminado: true)

  • StagingBucketPath- Ruta de Amazon S3 para organizar artefactos (por ejemplo, s3://my - bucket/spark-upgrade or my-bucket/spark -upgrade). Déjelo en blanco para generar automáticamente un nuevo depósito

  • USES3Encryption: habilita el cifrado de KMS para el depósito provisional de Amazon S3 (predeterminado: false, establecido en true para usar el cifrado de KMS en lugar del cifrado de S3 predeterminado)

  • S3 KmsKeyArn: ARN (opcional) de la clave de KMS existente para el cifrado de buckets de Amazon S3. Solo se usa si el cifrado USES3Encryption es verdadero y tiene un depósito existente con una clave KMS

  • CloudWatchKmsKeyArn- (Opcional) ARN de la clave KMS existente para el cifrado de CloudWatch registros (solo EMR sin servidor, déjelo en blanco para el cifrado predeterminado)

  • EMRServerlessS3 LogPath: ruta S3 (opcional) donde se almacenan los registros de aplicaciones sin servidor de EMR (por ejemplo, s3://my - bucket/emr-serverless-logs or my-bucket/emr -serverless-logs). Cuando se proporciona, otorga al rol de IAM acceso de lectura a estos registros para su análisis. Solo se usa cuando Enable EMRServerless es true

  • ExecutionRoleToGrantS3Access: nombre de la función de IAM o ARN de la función de ejecución sin servidor EMR o EMR (opcional) existente para conceder acceso al EC2 bucket de almacenamiento provisional de Amazon S3. Solo se aplica cuando se crea un nuevo depósito provisional. Útil para conceder a las funciones de ejecución de trabajos de EMR acceso al depósito de almacenamiento provisional. Admite nombres de roles simples y rutas ARNs .

También puede descargar y revisar la CloudFormation plantilla, especificar las opciones anteriores e iniciar la plantilla usted mismo con los comandos CloudFormation CLI; consulte un ejemplo a continuación:

# 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

Abra la pestaña Salidas (o extráigala del comando CLI CloudFormation describe-stacks anterior) y copie la ExportCommand instrucción de 1 línea y, a continuación, ejecútela en su entorno local. Ejemplo de instrucción de 1 línea:

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>

A continuación, ejecute el siguiente comando localmente para configurar el perfil de IAM y el servidor 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

Esto debería actualizarse ~/.kiro/settings/mcp.json para incluir la configuración del servidor MCP que se muestra a continuación.

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

Consulte Uso del agente de actualización la guía de configuración para diferentes clientes MCP como Kiro, Cline y. GitHub CoPilot