View a markdown version of this page

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.

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) Launch Stack button with information icon.
AS Timur (Ohio) Launch Stack button with information icon.
AS Barat (Oregon) Launch Stack button with information icon.
Eropa (Irlandia) Launch Stack button with information icon.
Asia Pacific (Tokyo) Launch Stack button with information icon.
Asia Pasifik (Singapura) Launch Stack button with information icon.
Asia Pacific (Sydney) Launch Stack button with information icon.
Kanada (Pusat) Launch Stack button with information icon.
Amerika Selatan (Sao Paulo) Launch Stack button with information icon.
Eropa (Frankfurt) Launch Stack button with information icon.
Eropa (Stockholm) Launch Stack button with information icon.
Eropa (London) Launch Stack button with information icon.
Eropa (Paris) Launch Stack button with information icon.
Asia Pasifik (Seoul) Launch Stack button with information icon.
Asia Pasifik (Mumbai) Launch Stack button with information icon.

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

  • SparkUpgradeIAMRoleName- Nama peran IAM yang akan digunakan untuk proses upgrade Spark

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

  • enableeMRServerLess - Aktifkan izin EMR-Serverless peningkatan (default: true)

  • StagingBucketPath- Jalur Amazon S3 untuk pementasan artefak (misalnya, s3://my - bucket/spark -upgrade atau my- -upgrade). 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)

  • S3KmsKeyArn- (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)

  • EMRServerlessS3LogPath- (Opsional) jalur S3 tempat log EMR-Serverless aplikasi disimpan (misalnya, s3://my - bucket/emr -serverless-logs atau my- -serverless-logs). bucket/emr Saat disediakan, memberikan akses baca peran IAM ke log ini untuk dianalisis. Hanya digunakan ketika enableeMRServerLess benar

  • ExecutionRoleToGrantS3Access- (Opsional) Nama Peran IAM atau ARN dari peran eksekusi EMR-EC2/EMR-Serverless 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 ARN 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