Pengaturan untuk Agen Peningkatan - Amazon EMR
PrasyaratSumber Daya Pengaturan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pengaturan untuk Agen Peningkatan

catatan

Apache Spark Upgrade Agent menggunakan inferensi lintas wilayah untuk memproses permintaan bahasa alami dan menghasilkan tanggapan. Untuk lebih jelasnya silakan merujuk ke halaman ini diPemrosesan lintas wilayah untuk Agen Upgrade Apache Spark. Server MCP Amazon SageMaker Unified Studio sedang dalam pratinjau dan dapat berubah sewaktu-waktu.

Prasyarat

Sebelum kita memulai proses setup untuk integrasi dengan Kiro CLI, pastikan Anda memiliki yang berikut diinstal pada workstation Anda:

Sumber Daya Pengaturan

Anda dapat menggunakan CloudFormation template untuk mengatur sumber daya untuk server MCP. Templat ini adalah contoh yang harus Anda modifikasi untuk memenuhi kebutuhan Anda. Template membuat sumber daya berikut untuk proses upgrade:

  • Peran IAM yang memiliki izin untuk memanggil MCP Server dan izin yang diperlukan untuk proses upgrade untuk platform EMR yang mendasarinya.

  • Bucket pementasan Amazon S3 digunakan untuk mengunggah artefak upgrade dan kunci KMS opsional untuk enkripsi Amazon S3.

Pilih salah satu tombol Luncurkan Tumpukan dalam tabel berikut. Ini meluncurkan tumpukan di CloudFormation konsol di wilayah masing-masing.

Region Luncurkan
Timur AS (N. Virginia)
AS Timur (Ohio)
AS Barat (Oregon)
Eropa (Irlandia)
Asia Pacific (Tokyo)
Asia Pasifik (Singapura)
Asia Pacific (Sydney)
Kanada (Pusat)
Amerika Selatan (Sao Paulo)
Eropa (Frankfurt)
Eropa (Stockholm)
Eropa (London)
Eropa (Paris)
Asia Pasifik (Seoul)
Asia Pasifik (Mumbai)

Lanjutkan ke halaman Tentukan detail tumpukan, masukkan nama Stack. Masukkan informasi tambahan di bawah Parameter. Berikan informasi berikut dan lanjutkan untuk membuat tumpukan.

  • SparkUpgradeIAMRoleNama - Nama peran IAM yang akan digunakan untuk proses peningkatan Spark

  • Aktifkan EMREC2 - Aktifkan izin EC2 peningkatan EMR- (default: true)

  • Aktifkan EMRServerless - Aktifkan izin peningkatan tanpa server EMR (default: true)

  • StagingBucketPath- Jalur Amazon S3 untuk pementasan artefak (misalnya, s3://my - -upgrade). bucket/spark-upgrade or my-bucket/spark Biarkan kosong untuk membuat bucket baru secara otomatis

  • Uses3encryption - Aktifkan enkripsi KMS untuk bucket pementasan Amazon S3 (default: false, disetel ke true untuk menggunakan enkripsi KMS alih-alih enkripsi S3 default)

  • S3 KmsKeyArn - (Opsional) ARN kunci KMS yang ada untuk enkripsi bucket Amazon S3. Hanya digunakan jika Uses3Encryption benar dan Anda memiliki bucket yang sudah ada dengan kunci KMS

  • CloudWatchKmsKeyArn- (Opsional) ARN kunci KMS yang ada untuk enkripsi CloudWatch Log (EMR Tanpa Server saja, biarkan kosong untuk enkripsi default)

  • EMRServerlessS3 LogPath - (Opsional) jalur S3 tempat log aplikasi tanpa server EMR disimpan (misalnya, s3://my - -serverless-logs). bucket/emr-serverless-logs or my-bucket/emr Saat disediakan, memberikan akses baca peran IAM ke log ini untuk dianalisis. Hanya digunakan ketika EMRServerless Aktifkan benar

  • ExecutionRoleToGrantS3Access - (Opsional) Nama Peran IAM atau ARN dari peran eksekusi EMR EC2 - /EMR-tanpa server yang ada untuk memberikan akses bucket staging Amazon S3. Hanya berlaku saat bucket pementasan baru dibuat. Berguna untuk memberikan akses peran eksekusi pekerjaan EMR ke bucket staging. Mendukung nama peran sederhana dan ARNs dengan jalur.

Anda juga dapat mengunduh dan meninjau CloudFormation template, menentukan opsi di atas dan meluncurkan template sendiri dengan perintah CloudFormation CLI, lihat di bawah untuk contoh:

# 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

Buka tab Output (atau ambil dari perintah CLI CloudFormation deskripsi-tumpukan di atas) dan salin ExportCommand instruksi 1 baris, lalu jalankan di lingkungan lokal Anda. Contoh instruksi 1-baris:

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>

Kemudian jalankan perintah berikut secara lokal untuk mengatur profil IAM dan konfigurasi 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

Ini harus diperbarui ~/.kiro/settings/mcp.json untuk menyertakan konfigurasi server MCP seperti di bawah ini.

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

Lihat panduan konfigurasi Menggunakan Agen Upgrade untuk klien MCP yang berbeda seperti Kiro, Cline dan. GitHub CoPilot