Carpetas

El panel Carpetas lista las carpetas de tu Mac que se comparten dentro de la VM de esta máquina (una máquina es un espacio de trabajo, en el editor de ajustes). Una carpeta compartida es donde el agente lee el código en el que trabaja y escribe sus cambios. Todo lo demás que la VM toca — su home, su disco de sistema — está aislado; una carpeta compartida no. Es una ventana viva, de lectura y escritura, a tu Mac.

El pie del panel: "Añade tus proyectos y carpetas personales para montarlos en este espacio de trabajo. Cada uno conserva su nombre dentro, y puedes añadir hasta 8." Sin ninguna configurada, dice No hay carpetas compartidas.

Cómo se comparten las carpetas

Cada carpeta se monta en /home/ubuntu/<nombre>, donde <nombre> es el nombre de la propia carpeta: ~/Documents aparece como ~/Documents dentro de la VM, y ~/code/bromure como /home/ubuntu/bromure. Solo se usa el último componente de la ruta, así que dos carpetas con el mismo nombre desde sitios distintos chocarían — renombra una si necesitas las dos.

La compartición es de lectura y escritura. El agente puede crear, cambiar y eliminar archivos en ella, y esos cambios son inmediatos y permanentes en tu Mac. Eso es lo que hace útil a la máquina: el agente edita tu copia de trabajo en el sitio, y git, tu editor y tus otras herramientas ven los cambios a medida que ocurren.

Las comparticiones se adjuntan cuando la VM arranca. Añadir o quitar una carpeta en una máquina en marcha pide reiniciarla (¿Reiniciar «nombre» para aplicar estos cambios?). En una máquina suspendida, guardar un cambio de carpetas pregunta primero ¿Descartar la VM suspendida de «nombre»? — el estado guardado no se puede reanudar con un conjunto distinto de comparticiones, así que el siguiente arranque es en frío. Los archivos del home de la máquina y de las carpetas compartidas no se ven afectados.

Advertencia: una carpeta compartida no forma parte del cajón de arena. Sobrevive a todo lo que restablece la VM: eliminar una máquina la deja en paz, y si una máquina alguna vez se marca como comprometida y se borra, sus carpetas compartidas no se borran y pueden seguir conteniendo archivos que el agente escribió. Comparte solo lo que el agente necesita, y revisa a mano una carpeta compartida después de una alerta de compromiso. Ver Credenciales y el límite de red.

Añadir y quitar carpetas

Haz clic en Añadir carpeta… para abrir un selector de carpetas; puedes seleccionar varias a la vez, y cada una se convierte en una fila. El botón se desactiva en cuanto la máquina tiene ocho carpetas.

Cada fila muestra el nombre de la carpeta y su ruta completa. El botón menos deja de compartirla; la carpeta y su contenido en el Mac nunca se tocan.

En los clientes de iPhone, iPad y Vision Pro, Añadir carpeta… pide la ruta en su lugar ("Introduce la ruta absoluta de la carpeta en el servidor; se monta dentro de la VM con su propio nombre."), porque la carpeta vive en el Mac que ejecuta la máquina.

Consejo: no hace falta compartir una carpeta para iniciar una sesión sobre un proyecto. La pantalla de nueva sesión también puede iniciar un agente en una carpeta nueva vacía o en una de tus carpetas recientes — ver Iniciar una sesión.

Archivos de configuración importados

Si la máquina la creó la configuración de primer arranque y el escaneo importó archivos de configuración de tu Mac, se listan bajo Archivos de configuración importados en el panel Credenciales, cada uno como ~/<ruta> con un recuento de sus ajustes, cuántos secretos se dejaron fuera, y qué ajustes se desactivaron. El pie explica: "Copiados a la VM tal cual. Los secretos se dejaron fuera — esos entran como credenciales más arriba, así que la VM solo ve un señuelo." El botón menos ("Quitar este archivo del espacio de trabajo") saca un archivo de la máquina.

Referencia de ajustes

Capítulos relacionados

• Conceptos y arquitectura — la VM, sus capas, y cómo se comparten las carpetas dentro.
• Máquinas — ejecutar, suspender y reiniciar una máquina.
• Credenciales y el límite de red — qué toca y qué no un borrado por compromiso.
• Referencia de ajustes — todos los paneles de un vistazo.