Pastas

O painel Pastas lista as pastas do seu Mac que estão partilhadas para a VM desta máquina (uma máquina é um espaço de trabalho, no editor de definições). Uma pasta partilhada é onde o agente lê o código em que trabalha e escreve as suas alterações. Tudo o mais que a VM toca — a sua home, o seu disco de sistema — está isolado; uma pasta partilhada não está. É uma janela viva, de leitura e escrita, para o seu Mac.

A legenda do painel: «Acrescente os seus projetos e pastas pessoais para montar neste espaço de trabalho. Cada um mantém o seu nome lá dentro, e pode acrescentar até 8.» Sem nenhuma configurada, lê-se Nenhuma pasta partilhada.

Como as pastas são partilhadas

Cada pasta é montada em /home/ubuntu/<nome>, onde <nome> é o nome da própria pasta: ~/Documents aparece como ~/Documents dentro da VM, e ~/code/bromure como /home/ubuntu/bromure. Só o último componente do caminho é usado, pelo que duas pastas com o mesmo nome vindas de lugares diferentes colidiriam — mude o nome de uma se precisar das duas.

A partilha é de leitura e escrita. O agente pode criar, alterar e eliminar ficheiros nela, e essas alterações são imediatas e permanentes no seu Mac. É isso que torna a máquina útil: o agente edita a sua cópia de trabalho no lugar, e o git, o seu editor e as suas outras ferramentas veem as edições à medida que acontecem.

As partilhas são ligadas quando a VM arranca. Acrescentar ou remover uma pasta numa máquina em execução pede para a reiniciar (Reiniciar «nome» para aplicar estas alterações?). Numa máquina suspensa, gravar uma alteração de pastas pergunta primeiro Descartar a VM suspensa de «nome»? — o estado gravado não pode ser retomado com um conjunto diferente de partilhas, pelo que o arranque seguinte é a frio. Os ficheiros na home da máquina e nas pastas partilhadas não são afetados.

Aviso: uma pasta partilhada não faz parte da caixa de areia. Sobrevive a tudo o que reinicia a VM: eliminar uma máquina deixa-a em paz, e se uma máquina for algum dia assinalada como comprometida e limpa, as suas pastas partilhadas não são limpas e podem ainda conter ficheiros que o agente escreveu. Partilhe apenas o que o agente precisa, e revise uma pasta partilhada à mão depois de um alerta de comprometimento. Ver Credenciais e a fronteira de transmissão.

Acrescentar e remover pastas

Clique em Adicionar pasta… para abrir um seletor de pastas; pode selecionar várias de uma vez, e cada uma torna-se uma linha. O botão fica desativado quando a máquina tem oito pastas.

Cada linha mostra o nome da pasta e o caminho completo. O botão de menos deixa de a partilhar; a pasta e o seu conteúdo no Mac nunca são tocados.

Nos clientes iPhone, iPad e Vision Pro, Adicionar pasta… pede o caminho em vez disso («Introduza o caminho absoluto da pasta no servidor; é montada na VM sob o seu próprio nome.»), porque a pasta vive no Mac que faz correr a máquina.

Dica: não tem de partilhar uma pasta para iniciar uma sessão num projeto. O ecrã de nova sessão também pode iniciar um agente numa pasta nova vazia ou numa das suas pastas recentes — ver Iniciar uma sessão.

Ficheiros de configuração importados

Se a máquina foi criada pela configuração de primeira execução e a análise importou ficheiros de configuração do seu Mac, eles são listados sob Ficheiros de configuração importados no painel Credenciais, cada um como ~/<caminho> com uma contagem das suas definições, quantos segredos ficaram de fora, e que definições foram desativadas. A legenda explica: «Copiados para a VM tal e qual. Os segredos ficaram de fora — esses entram como credenciais acima, pelo que a VM só vê um falso.» O botão de menos («Remover este ficheiro do espaço de trabalho») retira um ficheiro da máquina.

Referência de definições

Capítulos relacionados

• Conceitos e Arquitetura — a VM, as suas camadas, e como as pastas são partilhadas para lá.
• Máquinas — correr, suspender e reiniciar uma máquina.
• Credenciais e a fronteira de transmissão — o que uma limpeza por comprometimento toca e não toca.
• Referência de Definições — todos os painéis num relance.