Pastas

O painel Pastas lista as pastas do seu Mac que são partilhadas para a VM deste espaço de trabalho. Uma pasta partilhada é a ponte entre o seu sistema de ficheiros real e a sandbox: é onde o agente lê o código em que trabalha e escreve as alterações que faz. Tudo o resto que a VM toca — o seu diretório home, o seu disco de sistema — é descartável e isolado; uma pasta partilhada não é. É uma janela viva, de leitura-escrita, para o seu Mac.

A legenda do painel enuncia a regra exatamente: Cada pasta é montada na VM com o seu nome real (por exemplo, ~/Documents → ~ubuntu/Documents). Limitado a 8 pastas por espaço de trabalho. Sem pastas configuradas, apresenta Nenhuma pasta partilhada.

Como as pastas são partilhadas

Cada pasta que adiciona é anexada à VM como uma partilha virtiofs e montada em /home/ubuntu/<basename>, onde <basename> é o próprio nome da pasta. Partilhar ~/Documents faz com que apareça dentro da VM como ~ubuntu/Documents (ou seja, /home/ubuntu/Documents); partilhar ~/code/bromure aparece como /home/ubuntu/bromure. Apenas o último componente do caminho é usado para o nome de montagem, portanto duas pastas com o mesmo basename de locais diferentes entrariam em conflito — dê a uma delas um nome de diretório distinto se precisar de ambas.

A partilha é de leitura-escrita. O agente dentro da VM pode criar, modificar e eliminar ficheiros numa pasta partilhada exatamente como um processo local no seu Mac poderia, e essas alterações são imediatas e permanentes do lado do anfitrião. É isto que torna o espaço de trabalho útil: o agente edita a sua cópia de trabalho no local, e o git, o seu editor e as suas outras ferramentas no Mac veem as edições à medida que acontecem.

Como as partilhas são anexadas quando a VM é configurada no arranque, uma alteração a esta lista aplica-se da próxima vez que a VM do espaço de trabalho arrancar. Adicionar ou remover uma pasta enquanto uma sessão está em execução não a liga a quente — guarde a alteração e depois reinicie a sessão para a aplicar.

Aviso: Uma pasta partilhada não faz parte da sandbox. Sobrevive a tudo o que repõe a VM. Eliminar um espaço de trabalho deixa-a explicitamente intacta — a caixa de diálogo de confirmação diz "A pasta do anfitrião montada permanece intacta." — e se um espaço de trabalho for alguma vez marcado como comprometido e apagado, as suas pastas partilhadas não são apagadas e podem ainda conter ficheiros que o agente escreveu. Partilhe apenas as pastas de que o agente realmente precisa e reveja manualmente uma pasta partilhada após qualquer evento de comprometimento. Consulte Credenciais e a fronteira de transmissão para o fluxo de comprometimento.

Adicionar e remover pastas

Para partilhar uma pasta, clique em Adicionar pasta… na parte inferior do painel. Isto abre um seletor de diretórios no qual pode selecionar uma ou mais pastas de uma só vez; cada diretório selecionado torna-se uma nova linha. O botão fica desativado assim que o espaço de trabalho já tem oito pastas — o máximo por espaço de trabalho.

Cada pasta configurada aparece como uma linha que mostra o nome da pasta e o seu caminho completo no seu Mac. Clique no botão de menos numa linha para deixar de partilhar essa pasta; remover uma linha aqui nunca elimina a pasta nem o seu conteúdo no anfitrião — apenas a desanexa da VM no próximo arranque.

A lista de pastas atualmente partilhadas também é visível a partir da sessão em execução: o painel de informação da janela da sessão mostra uma lista de Pastas partilhadas para que possa confirmar de relance o que o agente consegue alcançar. Consulte Sessões.

Referência de definições

Capítulos relacionados

• Conceitos — como a VM, as suas camadas descartáveis e as partilhas virtiofs se encaixam.
• Sessões — a janela da sessão em execução e a sua lista de pastas partilhadas.
• Credenciais e a fronteira de transmissão — o que um apagamento por comprometimento afeta e não afeta.
• Referência de definições — todos os painéis num relance.