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á. # Uso do Editor de Código 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 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 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 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 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 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 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 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 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 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 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 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)