Desenvolvimento remoto

​

Conecte um ambiente remoto

Um ambiente remoto executa o agente, as operações de arquivos e os terminais em um host SSH, uma distribuição WSL ou um contêiner Docker. A interface desktop permanece no seu computador. Ambientes WSL e Docker podem ser executados nesse mesmo computador. O repositório e as ferramentas de desenvolvimento já devem existir nesse ambiente; a conexão não copia seu checkout local. Prepare o ambiente antes de conectar: Depois, conecte o ambiente:

1. Em uma nova sessão de Código, abra o menu da pasta e escolha Ambiente remoto… em Executar em.
2. Escolha o tipo de conexão, informe os dados e selecione uma pasta de projeto existente no destino.
3. Se a tarefa precisar de ferramentas locais, selecione-as em Ferramentas e credenciais. Incluir as credenciais exige uma seleção separada.
4. Escolha Conectar. O diálogo mostra o progresso da preparação ou o erro que impediu a conexão.

As ferramentas e configurações selecionadas são copiadas uma vez, no momento da conexão. Mudanças locais posteriores não são sincronizadas continuamente. As autorizações OAuth dos conectores não são copiadas; configure a autenticação no ambiente de destino para os conectores que precisarem dela. O local de execução fica definido quando a sessão começa; para trabalhar em outra máquina, crie uma sessão. Desconectar separa a interface desktop do ambiente sem cancelar uma tarefa remota ativa. Use o controle de parada da sessão para cancelar o trabalho. Ferramentas transferidas e credenciais persistentes permanecem na máquina remota após a desconexão.

​

Informe os dados da conexão

Para SSH, informe host e pasta remota. Acrescente usuário, porta e caminho da chave privada se não estiverem na configuração SSH. Estabeleça confiança pelo procedimento normal de SSH: o aplicativo espera o host em known_hosts e autenticação sem perguntas interativas. Para WSL, escolha a distribuição instalada. Para Docker, informe nome ou ID de um contêiner existente em execução e, se necessário, o contexto Docker. Use uma Pasta remota existente, como ~/project ou /home/user/project; ela será o diretório de trabalho da sessão. Antes de editar, peça para ler o README remoto e informar a localização do projeto e o comando de testes. Assim você confere se selecionou o checkout correto.

​

Reconecte ao trabalho existente

Use Conexões salvas para reutilizar um destino. Desconectar fecha a conexão; Esquecer remove a entrada salva. Nenhuma muda o destino de uma sessão existente. Para parar uma tarefa remota, use seu controle de parada antes de desconectar. Se atualizar uma skill ou conector localmente, não suponha que a cópia remota mudou. A transferência acontece uma vez e a autenticação remota precisa continuar válida. Confira o destino quando uma ferramenta funcionar localmente, mas estiver ausente ou sem autorização no remoto.

​

Use um ambiente na nuvem quando disponível

Se sua conta oferecer a opção de nuvem no seletor, escolha um ambiente salvo em vez de SSH, WSL ou Docker. Ele define repositórios e preparação de uma nova sessão. A disponibilidade depende da conta e organização. Em Ajustes → Ambientes na nuvem, crie ou abra um ambiente. Adicionar repositórios exige uma conexão GitHub na conta. Escolha cada repositório e branch, ou deixe a branch vazia para usar o padrão mostrado. Também é possível configurar script de preparação, variáveis e acesso de rede: Inclua apenas configuração não secreta nas variáveis: os valores são visíveis aos usuários do ambiente. O script Bash opcional roda no início de cada sessão, antes do agente, com o acesso de rede escolhido. Selecione o ambiente antes da primeira mensagem. Ela cria a sessão e prepara os repositórios. Abra o indicador do ambiente para conferir o estado. Se a preparação falhar, tente novamente quando o diálogo oferecer; se o script falhar, pode haver uma opção de executar a preparação outra vez. Examine o erro antes de repetir. Mudanças no nível de rede salvo afetam sessões novas. As existentes mantêm o acesso original; mudar de ambiente exige outra sessão. Continue com Tarefas agendadas.