에이전트 업그레이드 설정 - Amazon EMR
사전 조건리소스 설정

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

에이전트 업그레이드 설정

참고

Apache Spark 업그레이드 에이전트는 리전 간 추론을 사용하여 자연어 요청을 처리하고 응답을 생성합니다. 자세한 내용은의이 페이지를 참조하세요Apache Spark 업그레이드 에이전트에 대한 리전 간 처리. Amazon SageMaker Unified Studio MCP 서버는 미리 보기 중이며 변경될 수 있습니다.

사전 조건

Kiro CLI와의 통합을 위한 설정 프로세스를 시작하기 전에 워크스테이션에 다음이 설치되어 있는지 확인합니다.

리소스 설정

CloudFormation 템플릿을 사용하여 MCP 서버의 리소스를 설정할 수 있습니다. 이 템플릿은 요구 사항에 맞게 수정해야 하는 샘플입니다. 템플릿은 업그레이드 프로세스를 위해 다음과 같은 리소스를 생성합니다.

  • MCP Server를 호출할 수 있는 권한과 기본 EMR 플랫폼의 업그레이드 프로세스에 필요한 권한이 있는 IAM 역할입니다.

  • Amazon S3 암호화를 위한 업그레이드 아티팩트 및 선택적 KMS 키를 업로드하는 데 사용되는 Amazon S3 스테이징 버킷입니다.

다음 표에서 스택 시작 버튼 중 하나를 선택하십시오. 그러면 해당 리전의 CloudFormation 콘솔에서 스택이 시작됩니다.

리전 시작
미국 동부(버지니아 북부)
미국 동부(오하이오)
미국 서부(오리곤)
유럽(아일랜드)
아시아 태평양(도쿄)
아시아 태평양(싱가포르)
아시아 태평양(시드니)
캐나다(중부)
남아메리카(상파울루)
유럽(프랑크푸르트)
유럽(스톡홀름)
유럽(런던)
유럽(파리)
아시아 태평양(서울)
아시아 태평양(뭄바이)

스택 세부 정보 지정 페이지로 이동하여 스택 이름을 입력합니다. 파라미터(Parameters) 아래에 추가 정보를 입력합니다. 다음 정보를 제공하고 스택 생성을 진행합니다.

  • SparkUpgradeIAMRoleName - Spark 업그레이드 프로세스에 사용할 IAM 역할의 이름

  • EnableEMREC2 - EMR-EC2 업그레이드 권한 활성화(기본값: true)

  • EnableEMRServerless - EMR-Serverless 업그레이드 권한 활성화(기본값: true)

  • StagingBucketPath - 스테이징 아티팩트를 위한 Amazon S3 경로(예: s3://my-bucket/spark-upgrade 또는 my-bucket/spark-upgrade). 새 버킷을 자동 생성하려면 비워 둡니다.

  • UseS3Encryption - Amazon S3 스테이징 버킷에 대해 KMS 암호화 활성화(기본값: false, 기본 S3 암호화 대신 KMS 암호화를 사용하려면 true로 설정)

  • S3KmsKeyArn - (선택 사항) Amazon S3 버킷 암호화를 위한 기존 KMS 키의 ARN입니다. UseS3Encryption이 true이고 KMS 키가 있는 기존 버킷이 있는 경우에만 사용됩니다.

  • CloudWatchKmsKeyArn - (선택 사항) CloudWatch Logs 암호화를 위한 기존 KMS 키의 ARN(EMR Serverless만 해당, 기본 암호화를 위해 비워둠)

  • EMRServerlessS3LogPath - (선택 사항) EMR-Serverless 애플리케이션 로그가 저장되는 S3 경로입니다(예: s3://my-bucket/emr-serverless-logs 또는 my-bucket/emr-serverless-logs). 제공되면는 분석을 위해 IAM 역할에 이러한 로그에 대한 읽기 액세스 권한을 부여합니다. EnableEMRServerless가 true인 경우에만 사용됩니다.

  • ExecutionRoleToGrantS3Access - (선택 사항) Amazon S3 스테이징 버킷 액세스 권한을 부여하는 기존 EMR-EC2/EMR-Serverless 실행 역할의 IAM 역할 이름 또는 ARN입니다. 새 스테이징 버킷이 생성될 때만 적용됩니다. EMR 작업 실행 역할에 스테이징 버킷에 대한 액세스 권한을 부여하는 데 유용합니다. 경로가 있는 ARNs과 간단한 역할 이름을 모두 지원합니다.

CloudFormation 템플릿을 다운로드 및 검토하고, 위의 옵션을 지정하고, CloudFormation CLI 명령을 사용하여 템플릿을 직접 시작할 수도 있습니다. 아래 예제를 참조하세요.

# 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

출력 탭을 열고(또는 위의 CloudFormation describe-stacks CLI 명령에서 검색) 1줄 명령을 복사한 ExportCommand다음 로컬 환경에서 실행합니다. 1줄 지침의 예:

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>

그런 다음 로컬에서 다음 명령을 실행하여 IAM 프로파일 및 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

MCP 서버 구성을 ~/.kiro/settings/mcp.json 포함하도록 아래와 같이 업데이트해야 합니다.

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

Kiro, Cline 및 GitHub CoPilot과 같은 다양한 MCP 클라이언트에 대한 구성 지침은 섹션을 참조업그레이드 에이전트 사용하세요.