

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

# Editor de código no Amazon SageMaker Studio
<a name="code-editor"></a>

O Editor de Código no [Code-OSS, Visual Studio Code - Open Source](https://github.com/microsoft/vscode#visual-studio-code---open-source-code---oss), ajuda você a escrever, testar, depurar e executar seu código de analytics e machine learning. O Code Editor se estende e é totalmente integrado ao Amazon SageMaker Studio. Compatível extensões de ambiente de desenvolvimento integrado (IDE) disponíveis também no [Open VSX Registry](https://open-vsx.org/). A página a seguir fornece informações sobre o Editor de Código e os principais detalhes para usá-lo.

O Code Editor tem a extensão [AWS Toolkit for VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) Code pré-instalada, que Serviços da AWS permite conexões com um gerador de código de uso geral baseado em aprendizado de máquina que fornece recomendações de código em tempo real. [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html) Para obter mais informações sobre extensões, consulte [Conexões e extensões do Editor de Código](code-editor-use-connections-and-extensions.md).

**Importante**  
Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica ao uso da experiência atualizada do Studio. Para obter informações sobre como usar a aplicação do Studio Classic, consulte [Amazon SageMaker Studio Clássico](studio.md).

Para iniciar o Editor de Código, crie um espaço privado no Editor de Código. O espaço do Editor de Código usa uma única instância do Amazon Elastic Compute Cloud (Amazon EC2) para a computação e um único volume do Amazon Elastic Block Store (Amazon EBS) para o armazenamento. Tudo em seu espaço, como seu código, perfil Git e variáveis de ambiente, é armazenado no mesmo volume do Amazon EBS. O volume tem 3.000 IOPS e uma taxa de transferência de 125. MBps Seu administrador definiu as configurações padrão de armazenamento do Amazon EBS para o seu espaço.

O tamanho de armazenamento padrão é 5 GB, mas o administrador pode aumentar a quantidade de espaço que você recebe. Para obter mais informações, consulte [Alterar o tamanho de armazenamento padrão](code-editor-admin-storage-size.md).

O diretório de trabalho de seus usuários dentro do volume de armazenamento é `/home/sagemaker-user`. Se você especificar sua própria AWS KMS chave para criptografar o volume, tudo no diretório de trabalho será criptografado usando sua chave gerenciada pelo cliente. Se você não especificar uma AWS KMS chave, os dados internos `/home/sagemaker-user` serão criptografados com uma chave AWS gerenciada. Independentemente de você especificar uma AWS KMS chave, todos os dados fora do diretório de trabalho são criptografados com uma chave AWS gerenciada.

Você pode escalar sua computação acima ou abaixo com a alteração do tipo de instância do Amazon EC2 que executa sua aplicação de Editor de Código. Antes de alterar o tipo de instância associada, primeiro é necessário interromper o espaço do Editor de Código. Para obter mais informações, consulte [Instâncias e imagens da aplicação Editor de Código](code-editor-use-instances.md).

Seu administrador pode fornecer para você uma configuração de ciclo de vida para personalizar o seu ambiente. É possível especificar a configuração do ciclo de vida ao criar o espaço. Para obter mais informações, consulte [Configurações de ciclo de vida do Editor de Código](code-editor-use-lifecycle-configurations.md).

Você também pode trazer seu próprio sistema de armazenamento de arquivos se tiver um volume do Amazon EFS.

![\[A página de boas-vindas da interface do usuário da aplicação Editor de Código.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-home.png)


**Topics**
+ [Uso do Editor de Código](code-editor-use.md)
+ [Guia do administrador do Editor de Código](code-editor-admin.md)

# Uso do Editor de Código
<a name="code-editor-use"></a>

Os tópicos desta seção fornecem guias para usar o Editor de código, incluindo como iniciar, adicionar conexões Serviços da AWS, desligar recursos e muito mais. Depois de criar um espaço no Editor de Código, você pode acessar a sua sessão do Editor de Código diretamente pelo navegador.

No ambiente do Editor de Código, você pode fazer o seguinte: 
+ Acesse todos os artefatos persistentes em seu diretório inicial
+ Clone seus GitHub repositórios e confirme as alterações
+ Acesse o SageMaker Python SDK

Você pode retornar ao Studio para revisar todos os ativos criados em seu ambiente de Editor de Código, como experimentos, pipelines ou trabalhos de treinamento. 

**Topics**
+ [Verifique a versão do Editor de Código](code-editor-use-version.md)
+ [Instâncias e imagens da aplicação Editor de Código](code-editor-use-instances.md)
+ [Inicie a aplicação de Editor de Código no Studio](code-editor-use-studio.md)
+ [Inicie um aplicativo Editor de código usando o AWS CLI](code-editor-launch-cli.md)
+ [Clonar um repositório no Editor de Código](code-editor-use-clone-a-repository.md)
+ [Conexões e extensões do Editor de Código](code-editor-use-connections-and-extensions.md)
+ [Encerre os recursos do Editor de Código](code-editor-use-log-out.md)

# Verifique a versão do Editor de Código
<a name="code-editor-use-version"></a>

As etapas a seguir mostram como verificar a versão da sua aplicação do Editor de Código.

**Para verificar a versão da aplicação do Editor de Código**

1. Inicie e execute um espaço do Editor de Código e navegue até a interface do usuário da aplicação Editor de Código. Para obter mais informações, consulte [Inicie a aplicação de Editor de Código no Studio](code-editor-use-studio.md).

1. No canto superior esquerdo da interface do Editor de Código, selecione o botão de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-menu-icon.png)). Em seguida, escolha **Ajuda**. Em seguida, escolha **Sobre**.

# Instâncias e imagens da aplicação Editor de Código
<a name="code-editor-use-instances"></a>

Somente algumas instâncias são compatíveis com as aplicações do Editor de Código. Você pode escolher o tipo de instância compatível com seu caso de uso no menu suspenso **Instância**. 

As instâncias de **Início Rápido** iniciam muito mais rápido do que as outras instâncias. Para obter mais informações sobre os tipos de instância de início rápido no Studio, [Tipos de instância disponíveis para uso com notebooks Amazon SageMaker Studio Classic](notebooks-available-instance-types.md).

**nota**  
Se você usar um tipo de instância de GPU na configuração da sua aplicação Editor de Código, também deverá usar uma imagem baseada em GPU. A interface do usuário do espaço do Editor de Código seleciona automaticamente uma imagem compatível quando você seleciona o seu tipo de instância.

Em um espaço, seus dados são armazenados em um volume do Amazon EBS que persiste independentemente da duração de uma instância. Você não perderá seus dados ao alterar as instâncias. Se seu espaço no Editor de Código for `Running`, você deverá interromper o seu espaço antes de fazer a alteração dos tipos de instância.

A tabela a seguir lista as imagens ARNs de CPU e GPU do Editor de Código disponíveis para cada região.


|  Região  |  CPU  |  GPU  | 
| --- | --- | --- | 
|  us-east-1  | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-cpu |  arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-gpu | 
|  us-east-2  | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-gpu | 
|  us-west-1  | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-gpu | 
|  us-west-2  | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-cpu |  arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-gpu | 
|  af-south-1  | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-cpu | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-gpu | 
|  ap-east-1  | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-gpu | 
|  ap-south-1  | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-gpu | 
|  ap-northeast-2  | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-gpu | 
|  ap-southeast-1  | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-gpu | 
|  ap-southeast-2  | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-gpu | 
|  ap-northeast-1  | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-gpu | 
|  ca-central-1  | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-gpu | 
|  eu-central-1  | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-gpu | 
|  eu-west-1  | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-gpu | 
|  eu-west-2  | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-gpu | 
|  eu-west-3  | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-gpu | 
|  eu-north-1  | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-gpu | 
|  eu-south-1  | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-gpu | 
|  sa-east-1  | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-cpu | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-gpu | 
|  ap-northeast-3  | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-gpu | 
|  ap-southeast-3  | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-gpu | 
|  me-south-1  | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-gpu | 
|  me-central-1  | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-gpu | 
|  il-central-1  | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-cpu | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-gpu | 
|  cn-north-1  | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-cpu |  arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-gpu  | 
|  cn-northwest-1  | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-cpu |  arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-gpu  | 
|  us-gov-west-1  | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-gpu | 
|  us-gov-east-1  | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-gpu | 

Se encontrar limites de instância, entre em contato com o administrador. Para obter mais armazenamento e computação para um usuário, os administradores podem solicitar um aumento nas cotas de um usuário. AWS Para obter mais informações sobre como solicitar um aumento de cota, consulte os [endpoints e cotas do Amazon SageMaker AI](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).

# Inicie a aplicação de Editor de Código no Studio
<a name="code-editor-use-studio"></a>

Para configurar e acessar seu ambiente de desenvolvimento integrado do Editor de Código por meio do Studio, você deve criar um espaço do Editor de Código. Para obter mais informações sobre espaços no Studio, consulte [Espaços do Amazon SageMaker Studio](studio-updated-spaces.md).

![\[O botão da aplicação Editor de Código e o quadro de visão geral na interface do usuário do Studio.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-studio-home.png)


O procedimento a seguir mostra como criar e executar um espaço do Editor de Código.

**Para criar e executar um espaço do Editor de Código**

1. Inicie a experiência atualizada do Studio. Para obter mais informações, consulte [Launch Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html).

1. Execute um destes procedimentos:
   + Na interface atualizada do Amazon SageMaker Studio, selecione **Editor de código** no menu **Aplicativos**.
   + Na interface atualizada do Amazon SageMaker Studio, escolha **Visualizar espaços do editor de código** na seção **Visão geral** da página inicial do Studio.

1. No canto superior direito da página inicial do Editor de Código, escolha **Criar espaço no Editor de Código**.

1. Insira um nome para o seu espaço no Editor de Código. O nome deve ter de 1 a 62 caracteres usando somente letras, números e traços.

1. Selecione **Criar espaço**.

1. Depois de criado o espaço, você terá algumas opções antes de optar por executar o espaço:
   + Você pode editar **Armazenamento (GB)**, **Configuração do ciclo de vida** ou **Anexar configurações personalizadas do sistema de arquivo EFS**. As opções para essas configurações estão disponíveis com base nas especificações do administrador.
   + No menu suspenso **Instância**, você pode escolher o tipo de instância mais compatível com seu caso de uso. No menu suspenso **Imagem**, você pode escolher uma imagem de SageMaker distribuição ou uma imagem personalizada fornecida pelo administrador.
**nota**  
Alternar entre imagens de distribuição do SageMaker altera a versão subjacente do Editor de Código que está sendo usada, o que pode causar incompatibilidades devido ao armazenamento em cache do navegador. Você deve limpar o cache do navegador ao alternar entre imagens.

     Se você usar um tipo de instância de GPU na configuração da sua aplicação Editor de Código, também deverá usar uma imagem baseada em GPU. Em um espaço, seus dados são armazenados em um volume do Amazon EBS que persiste independentemente da duração de uma instância. Você não perderá seus dados ao alterar as instâncias.
**Importante**  
As políticas do IAM personalizadas que permitem que os usuários do Studio criem espaços devem conceder permissões também para listar imagens (`sagemaker: ListImage`) para visualizar imagens personalizadas. Para adicionar a permissão, consulte [Adicionar ou remover permissões de identidade](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*.   
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar recursos de SageMaker IA já incluem permissões para listar imagens ao criar esses recursos.
**nota**  
Para atualizar as configurações de espaço, primeiro é necessário interromper o espaço. Se seu editor de código usa uma NVMe instância com armazenamentos de instâncias, todos os dados armazenados na NVMe loja são excluídos quando o espaço é interrompido.

1. Após a atualização de suas configurações, escolha **Executar Espaço** na página de detalhes do espaço.

1. Depois que o status do espaço for `Running`, escolha **Abrir Editor de Código** para iniciar a sua sessão do Editor de Código. 

![\[A página de detalhes do espaço para uma aplicação Editor de Código na interface do usuário do Studio.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-open.png)


# Inicie um aplicativo Editor de código usando o AWS CLI
<a name="code-editor-launch-cli"></a>

Para configurar e acessar seu ambiente de desenvolvimento integrado do Editor de Código por meio do AWS Command Line Interface (AWS CLI), você deve criar um espaço do Editor de Código. Certifique-se de conhecer o [Concluir os pré-requisitos](code-editor-admin-prerequisites.md) antes de seguir as etapas a seguir. Use o procedimento a seguir para criar e executar um espaço do Editor de Código.

**Para criar e executar um espaço do Editor de Código**

1. Acesse um espaço usando AWS Identity and Access Management (IAM) ou Centro de Identidade do AWS IAM autenticação. Para obter mais informações sobre como acessar espaços usando o AWS CLI, consulte *Acessando espaços usando o AWS Command Line Interface* in[Espaços do Amazon SageMaker Studio](studio-updated-spaces.md). 

1. Crie uma aplicação e especifique `CodeEditor` como `app-type` usando o comando a seguir.

   Se você usar um tipo de instância de GPU ao criar a aplicação Editor de Código também deverá usar uma imagem baseada em GPU.

   ```
   aws sagemaker create-app \
   --domain-id domain-id \
   --space-name space-name \
   --app-type CodeEditor \
   --app-name default \
   --resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:account-id:image/sagemaker-distribution-cpu"
   ```

   Para obter mais informações sobre a imagem disponível do Editor de Código ARNs, consulte[Instâncias e imagens da aplicação Editor de Código](code-editor-use-instances.md).

1. Depois que a aplicação Editor de Código estiver em funcionamento, inicie a aplicação usando uma URL pré-assinada. Você pode usar a API `describe-app` para verificar se sua aplicação está em funcionamento. Use a API `create-presigned-domain-url` para criar uma URL pré-assinada:

   ```
   aws sagemaker create-presigned-domain-url \
   --domain-id domain-id \
   --space-name space-name \
   --user-profile-name user-profile-name \
   --session-expiration-duration-in-seconds 43200 \
   --landing-uri app:CodeEditor:
   ```

1. Abra a URL gerada para começar a trabalhar na aplicação Editor de Código.

# Clonar um repositório no Editor de Código
<a name="code-editor-use-clone-a-repository"></a>

Você pode navegar pelas pastas e clonar um repositório na janela **Explorer** da interface do usuário da aplicação Editor de Código. 

Para clonar um repositório, siga essas etapas:

**Para clonar um repositório**

1. Abra sua aplicação Editor de Código no navegador e escolha o botão **Exploração** (![\[Icon representing multiple documents or pages stacked on top of each other.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-exploration-icon.png)) no painel de navegação à esquerda.

1. Escolha **Clonar repositório** na janela **Explorer**. Em seguida, forneça uma URL do repositório ou escolha uma fonte de repositório no prompt.

1. Escolha uma pasta onde clonar o seu repositório. Observe que a pasta padrão do Editor de Código é `/home/sagemaker-user/`. A clonagem do repositório pode levar algum tempo.

1. Para abrir o repositório clonado, escolha **Abrir em nova janela** ou **Abrir**.

1.  Para retornar à página inicial da interface do usuário da aplicação Editor de Código, escolha **Cancelar**.

1. Dentro do repositório, um prompt pergunta se você confia nos autores dos arquivos no novo repositório. Você tem duas opções:

   1. Para confiar na pasta e ativar todos os atributos, escolha **Sim, confio nos autores**.

   1. Para navegar pelo conteúdo do repositório no *modo restrito*, escolha **Não, não confio nos autores**.

      No modo restrito, as tarefas não podem ser executadas, a depuração é desativada, as configurações do espaço de trabalho não são aplicadas e as extensões têm funcionalidade limitada.

      Para sair do modo restrito, confiar nos autores de todos os arquivos em sua pasta atual ou na pasta principal e habilitar todos os atributos, escolha **Gerenciar** no banner **Modo restrito**.

# Conexões e extensões do Editor de Código
<a name="code-editor-use-connections-and-extensions"></a>

O Code Editor suporta conexões IDE e extensões disponíveis no [Open VSX](https://open-vsx.org/) Registry. Serviços da AWS 

## Conexões com AWS
<a name="code-editor-use-connections"></a>

Os ambientes do Editor de Código são integrados ao [AWS Kit de ferramentas para VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) para adicionar conexões aos Serviços da AWS. Para começar a usar conexões com Serviços da AWS, você deve ter credenciais válidas AWS Identity and Access Management (IAM). Para obter mais informações, consulte [Autenticação e acesso ao AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).

Em seu ambiente de Editor de Código, você pode adicionar conexões para: 
+  [AWS Explorer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/aws-explorer.html) — Visualize, modifique e implante AWS recursos no Amazon S3 e muito mais. CloudWatch

  O acesso a determinados recursos no AWS Explorer requer certas AWS permissões. Para obter mais informações, consulte [Autenticação e acesso ao AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).
+ [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html): crie aplicações mais rapidamente com sugestões de código baseadas em IA. 

  Para usar Amazon CodeWhisperer com o Editor de código, você deve adicionar as seguintes permissões à sua função de execução de SageMaker IA.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Sid": "CodeWhispererPermissions",
        "Effect": "Allow",
        "Action": ["codewhisperer:GenerateRecommendations"],
        "Resource": "*"
      }
    ]
  }
  ```

------

  Para obter informações sobre como [Criar políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) e [Adicionar e remover permissões de identidade do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) no *Guia do usuário do IAM*.

## Extensões
<a name="code-editor-use-extensions"></a>

O Editor de Código é compatível com extensões IDE disponíveis no [Open VSX Registry](https://open-vsx.org/). 

Para começar a usar extensões em seu ambiente do Editor de Código, escolha o ícone **Extensões** (![\[Icon showing two overlapping squares representing multiple windows or instances.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-extensions-icon.png)) no painel de navegação à esquerda. Aqui, você pode configurar as conexões com a AWS instalando o AWS Toolkit. Para obter mais informações, consulte [Instalar a AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html).

Na barra de pesquisa, você pode pesquisar diretamente extensões adicionais por meio do [Open VSX Registry](https://open-vsx.org/), como o AWS Toolkit, Jupyter, Python e muito mais.

# Encerre os recursos do Editor de Código
<a name="code-editor-use-log-out"></a>

Ao terminar de usar um espaço do Editor de Código, você pode usar o Studio para interrompê-lo. Dessa forma, você deixa de incorrer em custos com o espaço. 

Como alternativa, você pode excluir recursos não utilizados do Editor de Código com a AWS CLI.

## Parada no seu espaço no Editor de Código com o Studio
<a name="code-editor-use-log-out-stop-space"></a>

Para interromper seu espaço no Editor de Código no Studio, use as seguintes etapas:

**Para interromper seu espaço no Editor de Código no Studio**

1. Retorne à página inicial do Editor de Código fazendo o seguinte: 

   1. Na barra de navegação no canto superior esquerdo, escolha **Editor de Código**.

   1. Como alternativa, no painel de navegação esquerdo, selecione **Editor de Código** no menu **Aplicações**.

1. Encontre o nome do espaço do Editor de Código que você criou. Se o status do seu espaço for **Em execução**, escolha **Parar** na coluna **Ação**. Você também pode interromper o espaço diretamente na página de detalhes do espaço escolhendo **Interromper o espaço**. A interrupção do espaço pode levar algum tempo.

![\[Uma página de detalhes do espaço na interface do usuário da aplicação Editor de Código.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-stop-space.png)


Recursos adicionais, como endpoints de SageMaker IA, clusters do Amazon EMR (Amazon EMR) e buckets do Amazon Simple Storage Service (Amazon S3) criados a partir do Studio, não são excluídos automaticamente quando sua instância espacial é encerrada. Para parar de acumular cobranças dos recursos, exclua quaisquer recursos adicionais. Para obter mais informações, consulte [Exclusão de recursos não usados](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-clean-up.html).

## Exclua os recursos do Editor de código usando o AWS CLI
<a name="code-editor-use-log-out-shut-down-resources"></a>

Você pode excluir o aplicativo e o espaço do Editor de Código usando o AWS Command Line Interface (AWS CLI).
+ [DeleteApp](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteApp.html)
+ [DeleteSpace](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteSpace.html)

# Guia do administrador do Editor de Código
<a name="code-editor-admin"></a>

Você pode usar o Editor de Código com uma instância sob demanda para acelerar o tempo de inicialização e o armazenamento configurável. Você pode iniciar um aplicativo de editor de código por meio do Amazon SageMaker Studio ou do AWS CLI. Você também pode editar as configurações padrão do Editor de Código no console do domínio. Para obter mais informações, consulte [Editar configurações de domínio](domain-edit.md). Os tópicos a seguir descrevem como os administradores podem configurar o Editor de Código, com base no Code-OSS, Visual Studio Code - código aberto, alterando as opções de armazenamento, personalizando ambientes e gerenciando o acesso do usuário, além de fornecer informações sobre os pré-requisitos necessários para usar o Editor de Código.

**Topics**
+ [Concluir os pré-requisitos](code-editor-admin-prerequisites.md)
+ [Forneça acesso a espaços privados aos seus usuários](code-editor-admin-user-access.md)
+ [Alterar o tamanho de armazenamento padrão](code-editor-admin-storage-size.md)
+ [Configurações de ciclo de vida do Editor de Código](code-editor-use-lifecycle-configurations.md)
+ [Imagens personalizadas](code-editor-custom-images.md)

# Concluir os pré-requisitos
<a name="code-editor-admin-prerequisites"></a>

Para usar o Editor de Código, com base no Code-OSS, Visual Studio Code - código aberto, você deve preencher os seguintes pré-requisitos:

1. Primeiro, você deve se conectar ao domínio Amazon SageMaker AI e criar um perfil de usuário. Para obter mais informações, consulte [Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md).

1. Se você estiver interagindo com seu aplicativo Editor de código usando o AWS CLI, você também deverá preencher os seguintes pré-requisitos.

   1.  Atualize o AWS CLI seguindo as etapas em [Instalando a AWS CLI versão atual](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled). 

   1.  Em sua máquina local, execute `aws configure` e forneça suas credenciais da AWS . Para obter informações sobre AWS credenciais, consulte [Entendendo e obtendo suas AWS credenciais](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html). 

1. (Opcional) Para obter mais armazenamento e computação para seu aplicativo, você pode solicitar um aumento nas suas AWS cotas. Para obter mais informações sobre como solicitar um aumento de cota, consulte os [endpoints e cotas do Amazon SageMaker AI](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).

# Forneça acesso a espaços privados aos seus usuários
<a name="code-editor-admin-user-access"></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.

Esta seção fornece uma política que concede acesso a espaços privados ao usuário. Você pode usar a política também para restringir espaços privados bem como as aplicações associados com eles do proprietário associado ao perfil do usuário. 

Para fornecer permissões aos seus usuários, siga os seguintes passos:
+ Espaços privados
+ O perfil de usuário necessário para acessar os espaços privados

Para dar permissões, adicione a seguinte política nos perfis do IAM dos seus usuários:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {

      "Effect": "Allow",
      "Action": [
        "sagemaker:CreateApp",
        "sagemaker:DeleteApp"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/*",
      "Condition": {
        "Null": {
          "sagemaker:OwnerUserProfileArn": "true"
        }
      }
    },
    {
      "Sid": "SMStudioCreatePresignedDomainUrlForUserProfile",
      "Effect": "Allow",
      "Action": [
        "sagemaker:CreatePresignedDomainUrl"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
    },
    {
      "Sid": "SMStudioAppPermissionsListAndDescribe",
      "Effect": "Allow",
      "Action": [
        "sagemaker:ListApps",
        "sagemaker:ListDomains",
        "sagemaker:ListUserProfiles",
        "sagemaker:ListSpaces",
        "sagemaker:DescribeApp",
        "sagemaker:DescribeDomain",
        "sagemaker:DescribeUserProfile",
        "sagemaker:DescribeSpace"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SMStudioAppPermissionsTagOnCreate",
      "Effect": "Allow",
      "Action": [
        "sagemaker:AddTags"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:*/*",
      "Condition": {
        "Null": {
          "sagemaker:TaggingAction": "false"
        }
      }
    },
    {
      "Sid": "SMStudioRestrictSharedSpacesWithoutOwners",
      "Effect": "Allow",
      "Action": [
        "sagemaker:CreateSpace",
        "sagemaker:UpdateSpace",
        "sagemaker:DeleteSpace"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
      "Condition": {
        "Null": {
          "sagemaker:OwnerUserProfileArn": "true"
        }
      }
    },
    {
      "Sid": "SMStudioRestrictSpacesToOwnerUserProfile",
      "Effect": "Allow",
      "Action": [
        "sagemaker:CreateSpace",
        "sagemaker:UpdateSpace",
        "sagemaker:DeleteSpace"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
      "Condition": {
        "ArnLike": {
        "sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
        },
        "StringEquals": {
          "sagemaker:SpaceSharingType": [
            "Private",
            "Shared"
          ]
        }
      }
    },
    {
      "Sid": "SMStudioRestrictCreatePrivateSpaceAppsToOwnerUserProfile",
      "Effect": "Allow",
      "Action": [
        "sagemaker:CreateApp",
        "sagemaker:DeleteApp"
      ],
      "Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/domain-id/*",
      "Condition": {
        "ArnLike": {
        "sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
        },
        "StringEquals": {
          "sagemaker:SpaceSharingType": [
            "Private"
          ]
        }
      }
    }
  ]
}
```

------

# Alterar o tamanho de armazenamento padrão
<a name="code-editor-admin-storage-size"></a>

Você pode alterar as configurações padrão de armazenamento dos seus usuários. Você pode alterar também as configurações de armazenamento padrão com base nos requisitos organizacionais e nas necessidades dos seus usuários.

Para alterar o tamanho de armazenamento de seus usuários, faça o seguinte:

1. Atualização das configurações de armazenamento do Amazon EBS no domínio. 

1. Crie um perfil de usuário e especifique as configurações de armazenamento dentro dele.

Use o comando a seguir AWS Command Line Interface (AWS CLI) para atualizar o domínio.

```
aws --region $REGION sagemaker update-domain \
--domain-id $DOMAIN_ID \
--default-user-settings '{
    "SpaceStorageSettings": {
        "DefaultEbsStorageSettings":{
            "DefaultEbsVolumeSizeInGb":5,
            "MaximumEbsVolumeSizeInGb":100
        }
    }
}'
```

Use o AWS CLI comando a seguir para criar o perfil do usuário e especificar as configurações de armazenamento padrão.

```
aws --region $REGION sagemaker create-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
    "SpaceStorageSettings": {
        "DefaultEbsStorageSettings":{
            "DefaultEbsVolumeSizeInGb":5,
            "MaximumEbsVolumeSizeInGb":100
        }
    }
}'
```

Use os AWS CLI comandos a seguir para atualizar as configurações de armazenamento padrão no perfil do usuário.

```
aws --region $REGION sagemaker update-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
    "SpaceStorageSettings": {
        "DefaultEbsStorageSettings":{
            "DefaultEbsVolumeSizeInGb":25,
            "MaximumEbsVolumeSizeInGb":200
        }
    }
}'
```

# Configurações de ciclo de vida do Editor de Código
<a name="code-editor-use-lifecycle-configurations"></a>

Você pode usar configurações de ciclo de vida do Editor de Código para automatizar a personalização do ambiente Studio. Essa personalização inclui a instalação de pacotes personalizados, a configuração de extensões, o pré-carregamento de conjuntos de dados e a configuração de repositórios de código fonte.

As instruções a seguir usam o AWS Command Line Interface (AWS CLI) para criar, anexar, depurar e desanexar configurações de ciclo de vida para o tipo de aplicativo: `CodeEditor`
+ [Crie e anexe as configurações de ciclo de vida no Studio](code-editor-use-lifecycle-configurations-studio-create.md)
+ [Configurações de ciclo de vida de depuração no Studio](code-editor-use-lifecycle-configurations-studio-debug.md)
+ [Desassociação das configurações de ciclo de vida no Studio](code-editor-use-lifecycle-configurations-studio-detach.md)

# Crie e anexe as configurações de ciclo de vida no Studio
<a name="code-editor-use-lifecycle-configurations-studio-create"></a>

A seção a seguir fornece AWS CLI comandos para criar uma configuração de ciclo de vida, anexar uma configuração de ciclo de vida ao criar um novo perfil de usuário e anexar uma configuração de ciclo de vida ao atualizar um perfil de usuário. Para pré-requisitos e etapas gerais sobre como criar e anexar configurações de ciclo de vida no Studio, consulte [Criação de configuração do ciclo de vida](jl-lcc-create.md). 

Ao criar a sua configuração de ciclo de vida do Studio com o comando `create-studio-lifecycle-config`, certifique-se de especificar que `studio-lifecycle-config-app-type` é `CodeEditor`. O exemplo a seguir mostra como criar uma configuração nova do ciclo de vida para a sua aplicação no Editor de Código.

```
aws sagemaker create-studio-lifecycle-config \
--studio-lifecycle-config-name my-code-editor-lcc \
--studio-lifecycle-config-content $LCC_CONTENT \
--studio-lifecycle-config-app-type CodeEditor
```

Anote o ARN da configuração de ciclo de vida recém-criada que é retornada. Ao anexar uma configuração de ciclo de vida, forneça esse ARN na lista `LifecycleConfigArns` de `CodeEditorAppSettings`. 

Você pode anexar uma configuração de ciclo de vida ao criar um perfil de usuário ou domínio. O exemplo a seguir mostra como criar um novo perfil de usuário com a configuração de ciclo de vida anexada. Você também pode criar um novo domínio com uma configuração de ciclo de vida anexada com o comando [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/create-domain.html).

```
# Create a new UserProfile
aws sagemaker create-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'
```

Como alternativa, você pode anexar uma configuração de ciclo de vida ao atualizar um perfil de usuário ou domínio. O exemplo a seguir mostra como atualizar um perfil de usuário com a configuração de ciclo de vida anexada. Você também pode atualizar um domínio novo com uma configuração de ciclo de vida anexada com o comando [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html).

```
# Update a UserProfile
aws sagemaker update-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'
```

# Configurações de ciclo de vida de depuração no Studio
<a name="code-editor-use-lifecycle-configurations-studio-debug"></a>

Para depurar scripts de configuração do ciclo de vida do Editor de Código, você deve usar o Studio. Para obter instruções sobre como depurar as configurações de ciclo de vida no Studio, consulte [Configuração de depuração do ciclo de vida](jl-lcc-debug.md). Para encontrar os logs de uma aplicação específico, pesquise os fluxos de logs usando o seguinte formato:

```
domain-id/space-name/CodeEditor/default/LifecycleConfigOnStart
```

# Desassociação das configurações de ciclo de vida no Studio
<a name="code-editor-use-lifecycle-configurations-studio-detach"></a>

Para desassociar as configurações de ciclo de vida do Editor de Código, você pode usar o console ou a AWS CLI. Para ver as etapas sobre como desassociar as configurações de ciclo de vida do console do Studio, consulte [Desassociar as configurações de ciclo de vida](jl-lcc-delete.md).

Para separar uma configuração de ciclo de vida usando o AWS CLI, remova a configuração de ciclo de vida desejada da lista de configurações de ciclo de vida anexada ao recurso. Em seguida, passe a lista como parte do respectivo comando:
+ [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html)
+ [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html)

Por exemplo, o comando a seguir remove todas as configurações de ciclo de vida da aplicação Editor de Código anexadas ao domínio.

```
aws sagemaker update-domain --domain-id domain-id \
--default-user-settings '{
"CodeEditorAppSettings": {
  "LifecycleConfigArns":
    []
  }
}'
```

# Crie uma configuração de ciclo de vida para clonar repositórios em uma aplicação de Editor de Código
<a name="code-editor-use-lifecycle-configurations-repositories"></a>

Esta seção mostra como clonar um repositório e criar uma aplicação de Editor de Código com a configuração de ciclo de vida anexada.

1. De sua máquina local, crie um arquivo denominado `my-script.sh` com o conteúdo a seguir:

   ```
   #!/bin/bash
   set -eux
   ```

1. Clonar o repositório de sua escolha no script de configuração do ciclo de vida. 

   ```
   export REPOSITORY_URL="https://github.com/aws-samples/sagemaker-studio-lifecycle-config-examples.git"
   git -C /home/sagemaker-user clone $REPOSITORY_URL
   ```

1. Depois de finalizar seu script, crie e anexe sua configuração de ciclo de vida. Para obter mais informações, consulte [Crie e anexe as configurações de ciclo de vida no Studio](code-editor-use-lifecycle-configurations-studio-create.md).

1. Crie sua aplicação de Editor de Código com a configuração de ciclo de vida anexada.

   ```
   aws sagemaker create-app \
   --domain-id domain-id \
   --space-name space-name \
   --app-type CodeEditor \
   --app-name default \
   --resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
   ```

   Para obter mais informações sobre a imagem disponível do Editor de Código ARNs, consulte[Instâncias e imagens da aplicação Editor de Código](code-editor-use-instances.md).

# Crie uma configuração de ciclo de vida para instalar extensões do Editor de Código
<a name="code-editor-use-lifecycle-configurations-extensions"></a>

Esta seção mostra como criar uma configuração de ciclo de vida para instalar extensões do [Open VSX Registry](https://open-vsx.org/) em seu ambiente de Editor de Código.

1. De sua máquina local, crie um arquivo denominado `my-script.sh` com o seguinte conteúdo:

   ```
   #!/bin/bash
   set -eux
   ```

1. Dentro do script, instale a extensão [Open VSX Registry](https://open-vsx.org/) de sua escolha:

   ```
   sagemaker-code-editor --install-extension AmazonEMR.emr-tools --extensions-dir /opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions
   ```

   Você pode recuperar o nome da extensão a partir da URL da extensão no [Open VSX Registry](https://open-vsx.org/). O nome da extensão a ser usado no comando `sagemaker-code-editor` deve conter todo o texto a seguir `https://open-vsx.org/extension/` na URL. Substitua todas as instâncias de uma barra (`/`) por um ponto (`.`). Por exemplo, `AmazonEMR/emr-tools` deveria ser `AmazonEMR.emr-tools`.  
![\[A página de extensão do Amazon EMR no Open VSX Registry.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/code-editor/code-editor-emr-extension.png)

1. Depois de finalizar seu script, crie e anexe sua configuração de ciclo de vida. Para obter mais informações, consulte [Crie e anexe as configurações de ciclo de vida no Studio](code-editor-use-lifecycle-configurations-studio-create.md).

1. Crie sua aplicação de Editor de Código com a configuração de ciclo de vida anexada:

   ```
   aws sagemaker create-app \
   --domain-id domain-id \
   --space-name space-name \
   --app-type CodeEditor \
   --app-name default \
   --resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
   ```

   Para obter mais informações sobre a imagem disponível do Editor de Código ARNs, consulte[Instâncias e imagens da aplicação Editor de Código](code-editor-use-instances.md). Para ver mais informações sobre conexões e extensões, consulte [Conexões e extensões do Editor de Código](code-editor-use-connections-and-extensions.md).

# Imagens personalizadas
<a name="code-editor-custom-images"></a>

Se precisar de uma funcionalidade diferente da fornecida pela SageMaker distribuição, você pode trazer sua própria imagem com suas extensões e pacotes personalizados. Você também pode personalizar a interface de usuário do Editor de Código de acordo com sua própria marca ou necessidades de conformidade.

A página a seguir fornecerá informações e modelos específicos do Code Editor para criar suas próprias imagens personalizadas de SageMaker IA. Isso serve para complementar as informações e instruções do Amazon SageMaker Studio sobre como criar sua própria imagem de SageMaker IA e trazer sua própria imagem para o Studio. Para saber mais sobre imagens personalizadas de SageMaker IA da Amazon e como trazer sua própria imagem para o Studio, consulte[Traga sua própria imagem (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Verificação de integridade e URL de aplicações](#code-editor-custom-images-app-healthcheck)
+ [Exemplos de Dockerfile](#code-editor-custom-images-dockerfile-templates)

## Verificação de integridade e URL de aplicações
<a name="code-editor-custom-images-app-healthcheck"></a>
+ `Base URL`: O URL base para a aplicação BYOI deve ser `CodeEditor/default`. Você só pode ter uma aplicação e ele deve sempre ter um nome `default`.
+ Endpoint de verificação de integridade — Você deve hospedar seu servidor do Editor de Código na porta 0.0.0.0 8888 para que a SageMaker IA o detecte.
+  Autenticação — Você deve passar `--without-connection-token` ao abrir `sagemaker-code-editor` para permitir que a SageMaker IA autentique seus usuários.

**nota**  
Se você estiver usando a Amazon SageMaker Distribution como imagem base, esses requisitos já foram atendidos como parte do `entrypoint-code-editor` script incluído.

## Exemplos de Dockerfile
<a name="code-editor-custom-images-dockerfile-templates"></a>

Os exemplos a seguir são arquivos `Dockerfile` que atendem às informações e [Especificações de imagem personalizadas](studio-updated-byoi-specs.md) acima.

**nota**  
Se você estiver trazendo sua própria imagem para o SageMaker Unified Studio, precisará seguir as [especificações do Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) no Guia do *usuário do Amazon SageMaker Unified Studio*.  
`Dockerfile`exemplos do SageMaker Unified Studio podem ser encontrados no [exemplo do Dockerfile no Guia do](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) *usuário do Amazon SageMaker Unified Studio*.

------
#### [ Example micromamba Dockerfile ]

Veja o seguinte exemplo de Dockerfile para criar uma imagem do zero usando um ambiente [https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html) básico: 

```
FROM mambaorg/micromamba:latest
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100

USER root

RUN micromamba install -y --name base -c conda-forge sagemaker-code-editor

USER $NB_UID

CMD eval "$(micromamba shell hook --shell=bash)"; \
    micromamba activate base; \
    sagemaker-code-editor --host 0.0.0.0 --port 8888 \
        --without-connection-token \
        --base-path "/CodeEditor/default"
```

------
#### [ Example SageMaker AI Distribution Dockerfile ]

Veja a seguir um exemplo de Dockerfile para criar uma imagem com base na [Amazon SageMaker AI](https://github.com/aws/sagemaker-distribution/tree/main) Distribution:

```
FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
ENV MAMBA_USER=$NB_USER

USER root

 # install scrapy in the base environment
RUN micromamba install -y --name base -c conda-forge scrapy

 # download VSCodeVim
RUN \
  wget https://github.com/VSCodeVim/Vim/releases/download/v1.27.2/vim-1.27.2.vsix \
  -P /tmp/exts/ --no-check-certificate

 # Install the extension
RUN \
  extensionloc=/opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions \
  && sagemaker-code-editor \
    --install-extension "/tmp/exts/vim-1.27.2.vsix" \
    --extensions-dir "${extensionloc}"

USER $MAMBA_USER
ENTRYPOINT ["entrypoint-code-editor"]
```

------