molinaig/agy repository overview

⁠Antigravity CLI en Docker

Contenedor Docker para ejecutar Antigravity CLI en un entorno aislado y acceder a él mediante SSH.

La idea es disponer de un entorno persistente para trabajar con Antigravity CLI desde un equipo remoto, sin tener que instalar sus dependencias directamente en el sistema anfitrión.

⁠Características

• Ejecución de Antigravity CLI dentro de un contenedor Docker.
• Acceso remoto mediante SSH.
• Puerto SSH configurable desde el host (en el ejemplo, 2222).
• Persistencia de la configuración de Antigravity CLI.
• Persistencia de los proyectos y archivos de trabajo.
• Reinicio automático del contenedor si se detiene.

⁠Requisitos

• Docker.
• Docker Compose (plugin docker compose).
• Un cliente SSH para conectarse al contenedor.

⁠Uso con Docker Compose

Crea un directorio para el servicio y, dentro, un archivo llamado compose.yml:

services:
  antigravity:
    image: molinaig/agy:latest
    container_name: antigravity
    restart: unless-stopped
    init: true

    ports:
      - "2222:22"

    environment:
      ROOT_PASSWORD: "123456"
      TERM: "xterm-256color"

    volumes:
      - ./config:/root/.gemini/antigravity-cli
      - ./workspace:/root/workspace

La estructura de directorios quedará así:

.
├── compose.yml
├── config/
└── workspace/

Los directorios config y workspace se crean en el equipo anfitrión y se montan dentro del contenedor.

⁠Iniciar el contenedor

Desde el directorio donde se encuentra compose.yml, ejecuta:

docker compose up -d

Comprobar el estado:

docker compose ps

Consultar los registros:

docker compose logs -f antigravity

⁠Conectarse por SSH

Desde el propio equipo anfitrión:

ssh root@localhost -p 2222

Desde otro equipo de la red, sustituye localhost por la dirección IP del servidor:

ssh root@IP_DEL_SERVIDOR -p 2222

Introduce la contraseña definida en ROOT_PASSWORD.

Una vez dentro, el directorio de trabajo es:

cd /root/workspace

⁠Volúmenes persistentes

Directorio del host Directorio del contenedor Uso

./config /root/.gemini/antigravity-cli Configuración de Antigravity CLI

⁠./workspace /root/workspace Proyectos y archivos de trabajo

Los datos guardados en estos directorios permanecen en el host aunque se elimine y vuelva a crear el contenedor.

⁠Variables de entorno

Variable Descripción

ROOT_PASSWORD Contraseña del usuario root, utilizada para el acceso SSH.

⁠TERM Tipo de terminal anunciado al conectarse.

⁠Puertos

Puerto del contenedor Puerto del host en el ejemplo Servicio

22 2222 SSH

Puedes cambiar el puerto del host modificando el lado izquierdo de la asignación. Por ejemplo, "2200:22" permitiría conectarse usando ssh -p 2200.

⁠Detener y actualizar

Detener y eliminar el contenedor (los directorios montados se conservan):

docker compose down

Descargar la última versión de la imagen y recrear el servicio:

docker compose pull
docker compose up -d

⁠Seguridad

El ejemplo utiliza 123456 únicamente como contraseña ilustrativa. Cámbiala por una contraseña robusta antes de utilizar el contenedor.

No publiques el puerto SSH directamente en Internet sin proteger el acceso. Limita el acceso mediante firewall o VPN cuando sea posible y evita reutilizar contraseñas.

⁠Publicar la imagen en Docker Hub

Si quieres construir y publicar tu propia versión, consulta las instrucciones de publicación de Docker Hub en la documentación oficial de Docker:

https://docs.docker.com/docker-hub/repos/manage/hub-images/push/⁠