本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Service Catalog 中配置亚马逊EMR CloudFormation模板

本主题假设管理员熟悉AWS CloudFormation中的 AWS Service Catalog产品组合和产品以及 Amazon EMR。

为了简化通过 Studio 创建亚马逊EMR集群的过程，管理员可以将亚马逊EMR CloudFormation 模板注册为产品AWS Service Catalog组合中的产品。要使模板可供数据科学家使用，他们必须将项目组合与 Studio 或 Studio Classic 中使用的 SageMaker 执行角色相关联。最后，要允许用户从 Studio 或 Studio Classic 中发现模板、配置EMR集群并连接到 Amazon 集群，管理员需要设置适当的访问权限。

Amazon EMR AWS CloudFormation 模板允许最终用户自定义群集的各个方面。例如，管理员可以定义已批准的实例类型列表，用户在创建集群时可以从中进行选择。

以下说明使用 end-to-end CloudFormation 堆栈来设置 Studio 或 Studio Classic 域名、用户个人资料、Service Catalog 产品组合，以及填充亚马逊EMR启动模板。以下步骤重点介绍了管理员必须在其 end-to-end 堆栈中应用的特定设置，才能让 Studio 或 Studio Classic 访问服务目录产品和配置亚马逊EMR集群。

要让数据科学家从 Studio 或 Studio Classic 中发现 Amazon EMR CloudFormation 模板并配置集群，请按照以下步骤操作。

第 0 步：检查您的网络并准备 CloudFormation 堆栈

开始之前：

步骤 1：将您的 Service Catalog 产品组合与关联起来 SageMaker

在您的 Service Catalog 产品组合中，将您的产品组合 ID 与访问您的集群的 SageMaker 执行角色相关联。

为此，请将以下部分（此处为YAML格式）添加到您的堆栈中。这将授予 SageMaker 执行角色访问包含亚马逊EMR模板等产品的指定 Service Catalog 产品组合的权限。它允许担任 SageMaker 的角色启动这些产品。

Replace（替换） SageMakerExecutionRole.Arn 以及 SageMakerStudioEMRProductPortfolio.ID 以及它们的实际值。

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

第 2 步：在 Service Catalog 产品中引用亚马逊EMR模板

在您的产品组合的 Service Catalog 产品中，引用亚马逊EMR模板资源并确保其在 Studio 或 Studio Classic 中的可见性。

为此，请在 Service Catalog 产品定义中引用 Amazon EMR 模板资源，然后将以下标签密钥"sagemaker:studio-visibility:emr"集添加到该值中"true"（参见YAML格式中的示例）。

在 Service Catalog 产品定义中，集群的 AWS CloudFormation 模板是通过引用的URL。将附加标签设置为 true 可确保亚马逊EMR模板在 Studio 或 Studio Classic 中的可见性。

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 模板允许管理员指定可配置的参数。管理员可以在模板的Parameters部分中为这些参数定义Default值和AllowedValues范围。在集群启动过程中，数据科学家可以提供自定义输入或从这些预定义选项中进行选择，以自定义其 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 或 Studio Classic 中集群创建表单上的输入字段。对于每个参数，数据科学家可以在输入框中输入自定义值，也可以从下拉菜单中列出的预定义选项中进行选择，该选项与模板中的AllowedValues指定值相对应。

下图显示了根据 CloudFormation亚马逊EMR模板组装而成的动态表单，用于在 Studio 或 Studio Classic 中创建亚马逊EMR集群。

请访问从 Studio 或 Studio Classic 中启动 A EMR，了解如何使用这些亚马逊EMR模板从 Studio 或 Studio Classic 启动集群。

第 4 步：设置权限以允许从 Studio 发布和启动亚马逊EMR集群

最后，附加所需的IAM权限以允许列出正在运行的现有亚马逊EMR集群以及从 Studio 或 Studio Classic 自行配置新集群。

您必须添加这些权限的角色取决于 Studio 还EMR是 Studio Classic 和 Amazon 部署在同一个账户（选择单个账户）中，还是部署在不同的账户（选择跨账户）中。