Platform For AI:Remote connection: Direct SSH connection

Etapa 1: Ativar a resolução DNS privada

As instâncias DSW são implantadas em Virtual Private Clouds (VPCs), e as conexões SSH dependem do DNS privado para resolver os endereços IP das instâncias. Ative a resolução DNS privada antes de se conectar a uma instância DSW. Para mais informações, consulte Activate Private DNS.

Etapa 2: Gerar um par de chaves SSH

Execute o seguinte comando no seu cliente para gerar um par de chaves SSH. Quando solicitado, defina uma senha para o par de chaves. Se você planeja usar o remote_ikernel para se conectar à instância (consulte o exemplo de cenário neste tópico), deixe a senha em branco e pressione Enter.

ssh-keygen

ssh-keygen -f /your/path/example_rsa # Generates example_rsa.pub and example_rsa in /your/path

Etapa 3: Configurar as definições SSH para a instância DSW

Ao Create a DSW instance, configure os seguintes parâmetros de rede.

Para uma instância existente, clique em Change Settings para modificar os parâmetros e, em seguida, clique em OK para aplicar as alterações.

Etapa 4: Instalar o servidor SSH

Imagens base oficiais e imagens personalizadas derivadas delas já possuem o servidor SSH instalado e iniciado por padrão.

No terminal da instância DSW, execute service ssh status para verificar o status do serviço, ou execute pgrep sshd para confirmar se o processo sshd existe. Caso o serviço SSH não esteja em execução, rode os comandos abaixo para instalar o servidor SSH.

sudo apt-get update
sudo apt-get install openssh-server
sudo service ssh start

Se o comando sudo não for encontrado, execute apt-get install sudo primeiro e tente novamente os comandos anteriores.

Em sistemas CentOS ou Red Hat Enterprise Linux (RHEL), execute yum install openssh-server ou dnf install openssh-server.

Etapa 5: Conectar-se à instância DSW

1. Visualize os métodos de acesso.

   Na página do DSW, clique no nome da instância para acessar a página de detalhes. Na aba Instance Settings, localize a seção Network Settings e verifique o método de acesso público e o método de acesso à VPC.

   Nota

   Se o acesso público não estiver selecionado na configuração SSH, apenas o método de acesso à VPC será exibido.

2. Conecte-se à instância DSW.

   Conexão via SSH

   • Acesso à rede pública

     A partir da sua linha de comando local ou de outro terminal, conecte-se à instância DSW utilizando o método de acesso público obtido na Etapa 1.

     ssh root@xx.xx.xx.xx -p 1024 
     # If the private key is not in the default path, specify the key location
     ssh -i /your/path/example_rsa root@xx.xx.xx.xx -p 1024

     Importante

     Nos comandos acima, o parâmetro -p especifica a porta de acesso público configurada para SSH. Neste exemplo, a porta é 1024.

   • Acesso à VPC

     A partir de outro terminal na VPC, como uma instância ECS, conecte-se à instância DSW utilizando o método de acesso à VPC obtido na Etapa 1.

     ssh root@dsw-notebook-xxxx.dsw-xxxx.dsw.pai.alibaba.com -p 22
     # If the private key is not in the default path, specify the key location
     ssh -i /your/path/example_rsa root@dsw-notebook-xxxx.dsw-xxxx.dsw.pai.alibaba.com -p 22

   Conexão a partir do VS Code local

   1. Abra o VS Code e instale a extensão Remote - SSH na visualização de Extensões.

      Após a instalação, abra a Paleta de Comandos, insira remote-ssh e escolha o comando Remote-SSH: Connect to Host... para iniciar a conexão remota.

   2. Clique em no canto inferior esquerdo para abrir a caixa de diálogo Remote-SSH e selecione Connect to Host... > Add New SSH Host....

   3. Insira o comando de conexão SSH.

      ssh root@xx.xx.xx.xx -p 1024 
      # If the private key is not in the default path, specify the key location
      ssh -i /your/path/example_rsa root@xx.xx.xx.xx -p 1024

   4. Clique em Open no canto inferior direito. O status da conexão aparecerá no canto inferior esquerdo.

   5. Abra um diretório na instância DSW para iniciar o desenvolvimento e a depuração remotos.

      Clique no ícone Explorer na barra de atividades à esquerda, clique no botão Open Folder, insira /mnt/workspace na caixa de diálogo Open File or Folder e clique em OK para abrir o diretório.

   6. Para executar código, conecte-se a um kernel na instância DSW.

      Na lista suspensa Select a Jupyter Kernel na parte superior do VS Code, selecione o kernel recomendado Python 3 (ipykernel).

Pré-requisitos

Conclua as Etapas 1 a 4 deste tópico para configurar a conexão SSH direta. Ao gerar o par de chaves SSH, deixe a senha em branco.

Procedimento

1. No seu terminal local, instale o remote_ikernel e adicione um kernel remoto.

   pip install remote_ikernel

   remote_ikernel manage --add \
   --kernel_cmd="ipython kernel -f {connection_file}" \  # No changes required
   --name="Remote Python" \
   --interface=ssh \
   --host=root@*.*.*.*:1024  # Replace this with your host address. If the private key is not in the default path, use --host="-i /your/path/example_rsa root@*.*.*.*:1024"

   Se a mensagem abaixo aparecer, o kernel remoto foi adicionado com sucesso.

   Added kernel ['rik_ssh_root_121_40_*_*_1024_remotepython']: SSH root@121.40.*.*:1024 Remote Python.

   Para visualizar a configuração do kernel remoto, execute o seguinte comando:

   remote_ikernel manage --show

2. No VS Code da sua máquina local, abra um arquivo de notebook e alterne o kernel no canto superior direito. Pesquise por Remote Python e selecione-o.

P: Quais são as diferenças entre a conexão SSH direta e o proxy ProxyClient?

P: Como solucionar falhas de conexão SSH, tempos limite ou rejeição de chave ao me conectar a uma instância DSW?

Solucione o problema por categoria:

• Falhas de conexão à rede pública

  • Verifique se as regras de entrada do grupo de segurança permitem tráfego na porta TCP 22 a partir do endereço IP do seu cliente.

  • Caso existam múltiplos gateways NAT da Internet na VPC, consulte Deploy single-AZ NAT gateways for high availability para verificar as relações de roteamento entre os gateways NAT, vSwitches e tabelas de rotas.

  • Se houver apenas um gateway NAT, utilize a solução de problemas autosserviço para analisar a conectividade de rede.

• Falhas de conexão à VPC

  • Confirme se o cliente e a instância DSW estão na mesma VPC. Execute o comando dig para testar a resolução DNS do nome de domínio da VPC da instância DSW. Se NXDOMAIN for retornado, a resolução DNS não está funcionando. Verifique as configurações de DNS privado da VPC.

  • Ao utilizar uma imagem personalizada, certifique-se de que o serviço SSH esteja instalado e iniciado. Para mais informações, consulte Etapa 4: Instalar o servidor SSH.

  • Garanta que as regras de entrada do grupo de segurança permitam tráfego na porta TCP 22.

  • Execute ssh -v root@IP -p port para obter informações detalhadas sobre a conexão. Connection timed out indica problema no grupo de segurança ou na conectividade de rede. Connection refused sinaliza que a porta não está escutando (sshd não está em execução). Connection reset aponta para um problema de autenticação.

• Rejeição de chave (Permission denied)

  • Assegure-se de que a chave pública (todo o conteúdo de id_rsa.pub) foi adicionada à configuração SSH da instância DSW.

  • Verifique se a chave privada usada no comando SSH corresponde à chave pública. Se a chave privada não estiver no caminho padrão (~/.ssh/id_rsa), especifique-a usando o parâmetro -i.

  • Valide se as permissões do arquivo ~/.ssh/authorized_keys estão definidas como 600. Execute ls -l ~/.ssh/authorized_keys para conferir. Permissões incorretas fazem com que o SSH rejeite a chave pública.

• Falhas de conexão no VS Code

  • Confirme se a extensão Remote - SSH está instalada e se você inseriu um comando SSH completo, como ssh root@xx.xx.xx.xx -p 1024.

  • Teste a conexão executando o comando SSH em um terminal local. Após estabelecer a conexão básica, revise a configuração do VS Code.

  • Caso surja um erro sobre pipe inexistente, reinicie o VS Code ou reinstale a extensão Remote - SSH.

P: Posso usar uma IDE local como PyCharm para me conectar remotamente a uma instância DSW?

Todos os recursos baseados no protocolo SSH são suportados. Ao se conectar via PyCharm, a IDE baixa e instala automaticamente os componentes do lado do servidor na instância DSW. Por isso, a instância DSW precisa ter acesso à rede pública.

P: Como visualizo o endereço IP público de uma instância?

Se um gateway NAT da Internet estiver configurado, visualize o endereço IP público seguindo estas etapas:

P: Uma instância DSW suporta múltiplos usuários com logins SSH separados?

Por padrão, uma instância DSW fornece apenas o usuário root para logins SSH. O DSW não suporta a criação de múltiplos usuários independentes com logins SSH isolados. É possível criar usuários adicionais manualmente dentro da instância, mas essa não é uma prática oficialmente suportada.

P: Por que não consigo ver os arquivos do workspace ao me conectar a uma instância DSW a partir de uma IDE local como VS Code ou PyCharm?

Após o login SSH, o diretório padrão pode ser o diretório home do usuário root (/root). Os arquivos do workspace geralmente ficam armazenados em um diretório no disco de dados montado, como /mnt/workspace. No VS Code, escolha File > Open Folder para abrir o diretório de trabalho correto.