本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Service Catalog 中設定 Amazon EMR CloudFormation 範本

本主題假設管理員熟悉 AWS CloudFormationAmazon 中 AWS Service Catalog的產品組合和產品EMR。

為了簡化從 Studio 建立 Amazon EMR 叢集的過程，管理員可以將 Amazon EMR CloudFormation 範本註冊為產品AWS Service Catalog組合中的產品。若要讓資料科學家可以使用範本，他們必須將組合與 Studio 或 Studio 經典中使用的 SageMaker 執行角色產生關聯。最後，為了允許使用者從 Studio 或工作室傳統探索範本、佈建EMR叢集，以及連接到 Amazon 叢集，管理員需要設定適當的存取權限。

Amazon EMR AWS CloudFormation 範本可讓最終使用者自訂各種叢集層面。例如，管理員可以定義使用者在建立叢集時可以從中選擇的執行個體類型的核可清單。

以下說明使用 end-to-end CloudFormation 堆疊來設定 Studio 或 Studio 經典網域、使用者設定檔、Service Catalog 組合，以及填入 Amazon EMR 啟動範本。下列步驟強調顯示管理員必須在其 end-to-end 堆疊中套用的特定設定，才能讓 Studio 或 Studio 經典版存取 Service Catalog 產品和佈建 Amazon EMR 叢集。

若要讓資料科學家探索 Amazon EMR CloudFormation 範本，並從 Studio 或工作室傳統版佈建叢集，請遵循下列步驟。

步驟 0：檢查您的網路並準備 CloudFormation 堆疊

在您開始之前：

步驟 1：將您的 Service Catalog 產品組合與 SageMaker

在您的 Service Catalog 產品組合中，將您的產品組合 ID 與存取叢集的 SageMaker 執行角色相關聯。

為此，請將以下部分（此處以YAML格式）添加到堆棧中。這會授予 SageMaker 執行角色存取指定的 Service Catalog 產品組合，其中包含 Amazon EMR 範本等產品。它允許由承擔的角色 SageMaker 來啟動這些產品。

Replace (取代) SageMakerExecutionRole.Arn 以及 SageMakerStudioEMRProductPortfolio.ID 與他們的實際價值。

SageMakerStudioEMRProductPortfolioPrincipalAssociation:
    Type: AWS::ServiceCatalog::PortfolioPrincipalAssociation
    Properties:
      PrincipalARN: SageMakerExecutionRole.Arn
      PortfolioId: SageMakerStudioEMRProductPortfolio.ID
      PrincipalType: IAM

步驟 2：參考 Service Catalog 產品中的 Amazon EMR 範本

在產品組合的 Service Catalog 產品中，參考 Amazon EMR 範本資源，並確保其在工作室或工作室經典版中的可見性。

若要這麼做，請參考 Service Catalog 產品定義中的 Amazon EMR 範本資源，然後將下列標籤金鑰"sagemaker:studio-visibility:emr"集新增至值 "true" (請參閱YAML格式中的範例)。

在 Service Catalog 產品定義中，透過參考叢集 AWS CloudFormation 範本URL。額外的標籤設置為 true 可確保在工作室或工作室經典中 Amazon EMR 模板的可見性。

SMStudioEMRNoAuthProduct:
    Type: AWS::ServiceCatalog::CloudFormationProduct
    Properties:
      Owner: AWS
      Name: SageMaker Studio Domain No Auth EMR
      ProvisioningArtifactParameters:
        - Name: SageMaker Studio Domain No Auth EMR
          Description: Provisions a SageMaker domain and No Auth EMR Cluster
          Info:
            LoadTemplateFromURL: Link to your CloudFormation template. For example, https://aws-blogs-artifacts-public.s3.amazonaws.com/artifacts/astra-m4-sagemaker/end-to-end/CFN-EMR-NoStudioNoAuthTemplate-v3.yaml
      Tags:
        - Key: "sagemaker:studio-visibility:emr"
          Value: "true"

步驟 3：參數化 Amazon 模板 EMR CloudFormation

用於在 Service Catalog 產品中定義 Amazon EMR 叢集的 CloudFormation 範本可讓管理員指定可設定的參數。管理員可以在AllowedValues範本的Parameters區段中定義這些參數的Default值和範圍。在叢集啟動過程中，資料科學家可以提供自訂輸入，或從這些預先定義的選項中進行選擇，以自訂 Amazon EMR 叢集的某些方面。

下列範例說明管理員在建立 Amazon EMR 範本時可設定的其他輸入參數。

"Parameters": {
    "EmrClusterName": {
      "Type": "String",
      "Description": "EMR cluster Name."
    },
    "MasterInstanceType": {
      "Type": "String",
      "Description": "Instance type of the EMR master node.",
      "Default": "m5.xlarge",
      "AllowedValues": [
        "m5.xlarge",
        "m5.2xlarge",
        "m5.4xlarge"
      ]
    },
    "CoreInstanceType": {
      "Type": "String",
      "Description": "Instance type of the EMR core nodes.",
      "Default": "m5.xlarge",
      "AllowedValues": [
        "m5.xlarge",
        "m5.2xlarge",
        "m5.4xlarge",
        "m3.medium",
        "m3.large",
        "m3.xlarge",
        "m3.2xlarge"
      ]
    },
    "CoreInstanceCount": {
      "Type": "String",
      "Description": "Number of core instances in the EMR cluster.",
      "Default": "2",
      "AllowedValues": [
        "2",
        "5",
        "10"
      ]
    },
    "EmrReleaseVersion": {
      "Type": "String",
      "Description": "The release version of EMR to launch.",
      "Default": "emr-5.33.1",
      "AllowedValues": [
        "emr-5.33.1",
        "emr-6.4.0"
      ]
    }
  }

管理員在 Studio 中提供 Amazon EMR CloudFormation 範本之後，資料科學家可以使用它們自行佈建 Amazon EMR 叢集。範本中定義的Parameters區段會轉譯成 Studio 或工作室傳統內叢集建立表單上的輸入欄位。對於每個參數，資料科學家可以在輸入方塊中輸入自訂值，或從下拉式功能表中列出的預先定義選項中進行選取，這些選項對應於範本中AllowedValues指定的選項。

下圖顯示了從 CloudFormation Amazon EMR 模板組裝的動態表單，以在工作室或工作室經典中創建 Amazon EMR 集群。

請造訪從工作室或工作室經典啟動 Amazon EMR 集群以了解如何使用這些 Amazon EMR 範本從工作室或工作室傳統版啟動叢集。

步驟 4：設定許可以從 Studio 啟用列出和啟動 Amazon EMR 叢集

最後，附加必要的IAM許可，以便列出現有執行中的 Amazon EMR 叢集，並從 Studio 或 Studio 傳統版自行佈建新叢集。

您必須新增這些許可的角色取決於 Studio 或 Studio Classic 和 Amazon EMR 是在同一個帳戶中部署 (選擇單一帳戶) 還是在不同的帳戶 (選擇「跨帳戶」) 部署。