

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

# Conecte seu IDE remoto a SageMaker espaços com acesso remoto
<a name="remote-access"></a>

Você pode se conectar remotamente do seu IDE remoto aos espaços do Amazon SageMaker Studio. Você pode usar sua configuração de IDE local personalizada, incluindo ferramentas de AI-assisted desenvolvimento e extensões personalizadas, com os recursos computacionais escaláveis na Amazon SageMaker AI. Este guia apresenta conceitos e instruções de configuração para administradores e usuários.

Uma conexão IDE remota estabelece uma conexão segura entre o IDE local e SageMaker os espaços. Essa conexão permite que você:
+ **Acesse recursos de computação de SageMaker IA** — execute código em uma infraestrutura de SageMaker IA escalável a partir do seu ambiente local
+ **Mantenha os limites de segurança** — trabalhe dentro da mesma estrutura de segurança da SageMaker IA
+ **Mantenha sua experiência familiar de IDE** — Use extensões, temas e configurações locais compatíveis que ofereçam suporte ao desenvolvimento remoto

**nota**  
Nem todas as extensões do IDE são compatíveis com o desenvolvimento remoto. As extensões que exigem componentes de GUI locais têm dependências de arquitetura ou precisam de interações específicas entre cliente e servidor talvez não funcionem adequadamente no ambiente remoto. Verifique se as extensões necessárias oferecem suporte ao desenvolvimento remoto antes de usar.

**Topics**
+ [Principais conceitos](#remote-access-key-concepts)
+ [Métodos de conexão](#remote-access-connection-methods)
+ [Um IDE compatível.](#remote-access-supported-ides)
+ [Requisitos da versão do IDE](#remote-access-ide-version-requirements)
+ [Requisitos de sistema operacional](#remote-access-os-requirements)
+ [Pré-requisitos da máquina local](#remote-access-local-prerequisites)
+ [Requisitos de imagens](#remote-access-image-requirements)
+ [Requisitos de instância](#remote-access-instance-requirements)
+ [Configurar o acesso remoto](remote-access-remote-setup.md)
+ [Configurar o IDE remoto](remote-access-local-ide-setup.md)
+ [Compatível AWS Regiões](remote-access-supported-regions.md)
+ [Instalando as habilidades de SageMaker IA da Amazon](remote-access-install-skills.md)

## Principais conceitos
<a name="remote-access-key-concepts"></a>
+ **Conexão remota** — Um túnel seguro entre seu IDE remoto e um SageMaker espaço. Essa conexão permite o desenvolvimento interativo e a execução de código usando recursos computacionais de SageMaker IA.
+ [https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html) — Um ambiente dedicado dentro do Amazon SageMaker Studio onde você pode gerenciar seu armazenamento e recursos para seus aplicativos Studio.
+ **Link** direto — Um botão (URL direto) da SageMaker interface do usuário que inicia uma conexão remota com seu IDE local.

## Métodos de conexão
<a name="remote-access-connection-methods"></a>

Há três maneiras principais de conectar seu IDE remoto a SageMaker espaços:
+ **Acesso ao link** direto — Você pode se conectar diretamente a um espaço específico usando o botão **Abrir espaço com** disponível na SageMaker IA. Isso usa padrões de URL para estabelecer uma conexão remota e abrir seu SageMaker espaço no IDE remoto.
+ [https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html): você pode se autenticar com o AWS Toolkit for Visual Studio Code. Isso permite que você se conecte a espaços e abra uma janela conectada remotamente a partir do seu IDE remoto.
+ **Conexão de terminal SSH**: você pode se conectar por meio da linha de comandos usando a configuração SSH.

## Um IDE compatível.
<a name="remote-access-supported-ides"></a>

A conexão remota com espaços do Studio permite usar:
+ [Visual Studio Code](https://code.visualstudio.com/)
+ [Kiro](https://kiro.dev/)
+ [Cursor](https://cursor.com/home)

## Requisitos da versão do IDE
<a name="remote-access-ide-version-requirements"></a>

A tabela a seguir lista os requisitos mínimos de versão para cada IDE remoto compatível.


| IDE | Versão mínima | 
| --- | --- | 
| Visual Studio Code | [v1.90 ou superior](https://code.visualstudio.com/updates/v1_90). Recomendamos usar a [versão estável mais recente](https://code.visualstudio.com/updates). | 
| Kiro | v0.10.78 ou superior | 
| Cursor | v2.6.18 ou superior | 

A extensão AWS Toolkit é necessária para conectar seu IDE remoto aos espaços do Studio. Para Kiro e Cursor, é necessária a versão v3.100 ou superior da extensão AWS Toolkit.

## Requisitos de sistema operacional
<a name="remote-access-os-requirements"></a>

Você precisa de um dos seguintes sistemas operacionais para se conectar remotamente aos espaços do Studio:
+ macOS 13 e posterior
+ Windows 10
  + [O suporte ao Windows 10 termina em 14 de outubro de 2025](https://support.microsoft.com/en-us/windows/windows-10-support-ends-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281)
+ Windows 11
+ Linux
  + Para o VS Code, instale o [Microsoft VS Code oficial para Linux](https://code.visualstudio.com/docs/setup/linux), não uma versão de código aberto

## Pré-requisitos da máquina local
<a name="remote-access-local-prerequisites"></a>

Antes de conectar seu IDE remoto aos espaços do Studio, certifique-se de que sua máquina local tenha as dependências e o acesso à rede necessários.

**Importante**  
Ambientes com restrições de instalação de software podem impedir que os usuários instalem as dependências necessárias. O pesquisa AWS Toolkit for Visual Studio Code automaticamente essas dependências ao iniciar conexões remotas e solicitará a instalação se alguma estiver faltando. Coordene com seu departamento de TI para garantir que esses componentes estejam disponíveis.

**Dependências locais necessárias**

Sua máquina local deve ter os seguintes componentes instalados:
+ **[Remote-SSHExtensão — Extensão](https://code.visualstudio.com/docs/remote/ssh)** de desenvolvimento remoto para seu IDE (disponível no mercado de extensões para VS Code, Kiro e Cursor)
+ **[Plugin Session Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)** — necessário para o gerenciamento seguro de sessões
+ **Cliente SSH** — Componente padrão na maioria das máquinas (o [OpenSSH é recomendado para Windows](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse))
+ **Comando IDE CLI** — Normalmente incluído na instalação do IDE (por exemplo, para VS Code, `code` para Kiro, `kiro` `cursor` para Cursor)

**Platform-specific requisitos**
+ **Usuários do Windows** — PowerShell 5.1 ou posterior é necessário para conexões de terminal SSH

**Requisitos de conectividade de rede**

Sua máquina local deve ter acesso à rede aos [endpoints do Session Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html). Por exemplo, no Leste dos EUA (Norte da Virgínia) (us-east-1), eles podem ser:
+ ssm.us-east-1.amazonaws.com
+ ssm.us-east-1.api.aws
+ ssmmessages.us-east-1.amazonaws.com
+ ec2messages.us-east-1.amazonaws.com

## Requisitos de imagens
<a name="remote-access-image-requirements"></a>

**SageMaker Imagens de distribuição**

Ao usar o SageMaker Distribution com acesso remoto, use o [SageMaker Distribution](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-distribution.html) versão 2.7 ou posterior.

**Imagens personalizadas**

Ao usar [Traga sua própria imagem (BYOI)](studio-updated-byoi.md) o acesso remoto, certifique-se de seguir as [especificações personalizadas da imagem](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-byoi-specs.html) e garantir que as seguintes dependências estejam instaladas:
+ `curl`ou `wget` — Obrigatório para baixar AWS CLI componentes
+ `unzip`— Necessário para extrair arquivos de AWS CLI instalação
+ `tar`— Necessário para extração de arquivos
+ `gzip`— Necessário para manipulação de arquivos compactados

## Requisitos de instância
<a name="remote-access-instance-requirements"></a>
+ **Memória**: 8 GB ou mais.
+ **Tipos de instância**: use instâncias com pelo menos 8 GB de memória. Os tipos de instância a seguir *não* são compatíveis devido à falta de memória (menos de 8 GB): `ml.t3.medium`, `ml.c7i.large`, `ml.c6i.large`, `ml.c6id.large` e `ml.c5.large`. Para obter uma lista mais completa dos tipos de instância, consulte a página de [ On-Demandpreços do Amazon EC2](https://aws.amazon.com/ec2/pricing/on-demand/).

**Topics**
+ [Principais conceitos](#remote-access-key-concepts)
+ [Métodos de conexão](#remote-access-connection-methods)
+ [Um IDE compatível.](#remote-access-supported-ides)
+ [Requisitos da versão do IDE](#remote-access-ide-version-requirements)
+ [Requisitos de sistema operacional](#remote-access-os-requirements)
+ [Pré-requisitos da máquina local](#remote-access-local-prerequisites)
+ [Requisitos de imagens](#remote-access-image-requirements)
+ [Requisitos de instância](#remote-access-instance-requirements)
+ [Configurar o acesso remoto](remote-access-remote-setup.md)
+ [Configurar o IDE remoto](remote-access-local-ide-setup.md)
+ [Compatível AWS Regiões](remote-access-supported-regions.md)
+ [Instalando as habilidades de SageMaker IA da Amazon](remote-access-install-skills.md)