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

# `AWS-SetupJupyter`
<a name="aws-setup-jupyter"></a>

 **描述** 

`AWS-SetupJupyter`运行手册可帮助你在亚马逊弹性计算云 (亚马 EC2逊) 实例上设置 Jupyter Notebook。您可以指定现有实例，也可以提供 Amazon Machine Image (AMI) 用于启动和设置新实例的自动化的 ID。开始之前，您必须先在 Parameter Store 中创建一个 `SecureString` 参数，用作 Jupyter 笔记本的密码。参数存储是一个工具 AWS Systems Manager。有关创建参数的更多信息，请参阅*AWS Systems Manager 用户指南*中的[创建参数](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html)。

[运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-SetupJupyter)

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ AmiId

  类型：字符串

  描述：（可选）的 ID AMI 你想用它来启动新实例和设置 Jupyter Notebook。
+ InstanceId

  类型：字符串

  说明：（必需）您想要设置 Jupyter 笔记本的实例的 ID。
+ InstanceType

  类型：字符串

  默认：t3.medium

  描述：（可选）如果您要启动新实例来设置 Jupyter 笔记本，则指定要使用的实例类型。
+ JupyterPasswordSSMKey

  类型：字符串

  描述：（必填）Parameter Store 中要用作 Jupyter 笔记本密码的 `SecureString` 参数的名称。
+ KeyPairName

  类型：字符串

  描述：（可选）要与新启动实例关联的密钥对。
+ RemoteAccessCidr

  类型：字符串

  默认：0.0.0.0/0

  描述：（可选）您希望允许 SSH 流量来自的 CIDR 范围。
+ RoleName

  类型：字符串

  默认： SSMManagedInstanceProfileRole

  描述：（可选）新启动实例的实例配置文件的名称。
+ StackName

  类型：字符串

  默认： CreateManagedInstanceStack\$1\$1自动化:execution\$1ID\$1\$1

  描述：（可选）您希望自动化使用的 CloudFormation 堆栈名称。
+ SubnetId

  类型：字符串

  默认：Default

  描述：（可选）您希望启动新实例以便使用的子网。
+ VpcId

  类型：字符串

  默认：Default

  描述：（可选）要将新实例启动到的虚拟私有云（VPC）的 ID。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+ `ssm:GetAutomationExecution`
+ `ssm:GetCommandInvocation`
+ `ssm:GetParameter`
+ `ssm:SendCommand`
+ `ssm:StartAutomationExecution`
+ `cloudformation:CreateStack`
+ `cloudformation:DeleteStack`
+ `cloudformation:DescribeStacks`
+ `ec2:DescribeInstances`
+ `ec2:DescribeKeyPairs`
+ `ec2:RunInstances`
+ `iam:AttachRolePolicy`
+ `iam:CreateRole`
+ `iam:DeleteRole`
+ `iam:DeleteRolePolicy`
+ `iam:DetachRolePolicy`
+ `iam:GetRole`
+ `iam:PassRole`
+ `iam:PutRolePolicy`
+ `lambda:CreateFunction`
+ `lambda:DeleteFunction`
+ `lambda:GetFunction`
+ `lambda:InvokeFunction`

 **文档步骤** 
+ `aws:executeScript` - 使用您为运行手册输入参数指定的值，在您指定的实例上或新启动的实例上设置 Jupyter 笔记本。