As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

O `AWS-SetupJupyter` runbook ajuda você a configurar o Jupyter Notebook em uma instância do Amazon Elastic Compute Cloud (Amazon). EC2 Você pode especificar uma instância existente ou fornecer uma Amazon Machine Image (AMI) ID da automação para iniciar e configurar uma nova instância. Antes de começar, é necessário criar um parâmetro `SecureString` no repositório de parâmetros para usar como senha do caderno Jupyter. O Parameter Store é uma ferramenta em AWS Systems Manager. Para obter mais informações sobre criação de parâmetro, consulte [Criação de parâmetros](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html) no *Guia do usuário do AWS Systems Manager *.

[Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-SetupJupyter)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ AmiId

  Tipo: string

  Descrição: (Opcional) O ID do AMI que você deseja usar para iniciar uma nova instância e configurar o Jupyter Notebook.
+ InstanceId

  Tipo: string

  Descrição: (obrigatório) o ID da instância do caderno Jupyter que você deseja reinicializar.
+ InstanceType

  Tipo: string

  Padrão: t3.medium

  Descrição: (opcional) se você estiver iniciando uma nova instância para configurar o caderno Jupyter, especifique o tipo de instância que deseja usar.
+ JupyterPasswordSSMKey

  Tipo: string

  Descrição: (obrigatório) o nome do parâmetro `SecureString` no repositório de parâmetros que você deseja usar como senha para o caderno Jupyter.
+ KeyPairName

  Tipo: string

  Descrição: (opcional) o par de chaves que você deseja associar à instância recém-iniciada.
+ RemoteAccessCidr

  Tipo: string

  Padrão: 0.0.0.0/0

  Descrição: (opcional) o intervalo CIDR do qual você deseja permitir o tráfego SSH.
+ RoleName

  Tipo: string

  Padrão: SSMManaged InstanceProfileRole

  Descrição: (opcional) o nome do perfil da instância recém-iniciada.
+ StackName

  Tipo: string

  Padrão: CreateManagedInstanceStack \$1\$1automation:execution\$1id\$1\$1

  Descrição: (Opcional) O nome da CloudFormation pilha que você deseja que a automação use.
+ SubnetId

  Tipo: string

  Padrão: Default

  Descrição: (opcional) a sub-rede na qual você deseja iniciar a nova instância para usar.
+ VpcId

  Tipo: string

  Padrão: Default

  Descrição: (opcional) o ID da nuvem privada virtual (VPC) na qual você deseja iniciar a nova instância.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `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`

 **Etapas do documento** 
+ `aws:executeScript`: configura o caderno Jupyter na instância especificada ou em uma instância recém-lançada, usando os valores que você especifica para os parâmetros de entrada do runbook.