

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á.

# Criar uma instância de Caderno com um repositório Git associado
<a name="nbi-git-create"></a>

**Importante**  
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

Você pode associar repositórios Git a uma instância do notebook ao criar a instância do notebook usando o Console de gerenciamento da AWS, ou o. AWS CLI Se você quiser usar um CodeCommit repositório que esteja em uma AWS conta diferente da instância do notebook, configure o acesso entre contas para o repositório. Para mais informações, consulte [Associar um CodeCommit repositório em uma AWS conta diferente a uma instância do Notebook](nbi-git-cross.md).

**Topics**
+ [Criar uma instância de caderno com um repositório Git associado (console)](#nbi-git-create-console)
+ [Criar uma instância de caderno com um repositório Git associado (CLI)](nbi-git-create-cli.md)

## Criar uma instância de caderno com um repositório Git associado (console)
<a name="nbi-git-create-console"></a>

**Para criar uma instância de notebook e associar repositórios Git no console Amazon AI SageMaker**

1. Siga as instruções em [Crie uma instância do Amazon SageMaker Notebook para o tutorial](gs-setup-working-env.md).

1. Para **Repositórios Git**, escolha repositórios Git a serem associados a instância de caderno.

   1. Em **Repositório padrão**, escolha um repositório que você deseja usar como seu repositório padrão. SageMaker O AI clona esse repositório como um subdiretório no diretório de inicialização do Jupyter em. `/home/ec2-user/SageMaker` Quando você abrir sua instância de caderno, ela será aberta nesse repositório. Para escolher um repositório armazenado como um recurso na sua conta, escolha seu nome na lista. Para adicionar um novo repositório como recurso em sua conta, escolha **Adicionar um repositório ao SageMaker AI (abre o fluxo Adicionar repositório em uma nova janela)** e siga as instruções em. [Criar uma instância de caderno com um repositório Git associado (console)](#nbi-git-create-console) Para clonar um repositório público que não esteja armazenado na sua conta, escolha **Clonar repositório Git público apenas para essa instância de caderno** e especifique o URL desse repositório.

   1. Para **Repositório adicional 1**, escolha um repositório que você deseja adicionar como um diretório adicional. SageMaker O AI clona esse repositório como um subdiretório no diretório de inicialização do Jupyter em. `/home/ec2-user/SageMaker` Para escolher um repositório armazenado como um recurso na sua conta, escolha seu nome na lista. Para adicionar um novo repositório como recurso em sua conta, escolha **Adicionar um repositório ao SageMaker AI (abre o fluxo Adicionar repositório em uma nova janela)** e siga as instruções em. [Criar uma instância de caderno com um repositório Git associado (console)](#nbi-git-create-console) Para clonar um repositório que não esteja armazenado na sua conta, escolha **Clonar repositório Git público apenas para essa instância de caderno** e especifique a URL desse repositório.

      Repita essa etapa até três vezes para adicionar até três repositórios adicionais à sua instância de caderno.

# Criar uma instância de caderno com um repositório Git associado (CLI)
<a name="nbi-git-create-cli"></a>

**Importante**  
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

Para criar uma instância de caderno e associar repositórios Git usando a AWS CLI, utilize o comando `create-notebook-instance` da seguinte forma:
+ Especifique o repositório que você deseja usar como seu repositório padrão como o valor do argumento `default-code-repository`. O Amazon SageMaker AI clona esse repositório como um subdiretório no diretório de inicialização do Jupyter em. `/home/ec2-user/SageMaker` Quando você abrir sua instância de caderno, ela será aberta nesse repositório. Para usar um repositório armazenado como um recurso em sua conta de SageMaker IA, especifique o nome do repositório como o valor do `default-code-repository` argumento. Para usar um repositório que não esteja armazenado na sua conta, especifique a URL do repositório como o valor do argumento `default-code-repository`.
+ Especifique até três repositórios adicionais como o valor do `additional-code-repositories` argumento. SageMaker O AI clona esse repositório como um subdiretório no diretório de inicialização do Jupyter em`/home/ec2-user/SageMaker`, e o repositório é excluído do repositório padrão ao adicioná-lo ao diretório do repositório padrão. `.git/info/exclude` Para usar repositórios armazenados como recursos em sua conta de SageMaker IA, especifique os nomes dos repositórios como o valor do `additional-code-repositories` argumento. Para usar repositórios que não estão armazenados em sua conta, especifique o URLs dos repositórios como o valor do `additional-code-repositories` argumento.

Por exemplo, o comando a seguir cria uma instância de notebook que tem um repositório chamado`MyGitRepo`, que é armazenado como um recurso em sua conta de SageMaker IA, como um repositório padrão e um repositório adicional hospedado em: GitHub

```
aws sagemaker create-notebook-instance \
                    --notebook-instance-name "MyNotebookInstance" \
                    --instance-type "ml.t2.medium" \
                    --role-arn "arn:aws:iam::012345678901:role/service-role/AmazonSageMaker-ExecutionRole-20181129T121390" \
                    --default-code-repository "MyGitRepo" \
                    --additional-code-repositories "https://github.com/myprofile/my-other-repo"
```

**nota**  
Se você usar um AWS CodeCommit repositório que não contenha "SageMaker" em seu nome, adicione as `codecommit:GitPush` permissões `codecommit:GitPull` e à função que você passa como `role-arn` argumento para o `create-notebook-instance` comando. Para obter informações sobre como adicionar permissões a um perfil, consulte [Adicionar e remover políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html), no *Guia do Usuário do AWS Identity and Access Management *. 