Operación: CLI, backup y actualización

La CLI aptabit instala, actualiza, realiza backups, restaura y diagnostica la Aptabit Platform a partir de un único archivo de configuración, config.yaml.

Comandos de la CLI

Los comandos avanzados, listados por aptabit help --all, incluyen logs, doctor, init, self-update, recover-root y uninstall. uninstall es el único comando que borra datos: solicita escribir la ruta de la instalación para confirmar.

Opciones frecuentes: --config elige la instalación cuando hay más de una (en la mayoría de los comandos también como --instance); --dry-run muestra lo que se haría en install, up, down, uninstall y backup rollback; --yes omite la confirmación; --lang pt-BR o --lang en elige el idioma en cualquier comando.

Actualización

aptabit update --check   # solo verifica si hay una versión nueva
aptabit update           # actualiza a la versión estable más reciente

La actualización:

1. Crea un backup de seguridad.
2. Descarga las nuevas imágenes.
3. Actualiza api, worker y web, uno a la vez, esperando la verificación de estado de cada uno, y solo entonces recrea el proxy.
4. Si la nueva versión no se inicia, vuelve automáticamente al backup creado en el paso 1.

Las migraciones de la base de datos se ejecutan automáticamente cuando se inicia la API. Para fijar una versión, utilice aptabit update:<version>; aptabit update --latest elimina la fijación. aptabit self-update actualiza la propia CLI, verificando el manifiesto firmado por Aptabit.

Backup y restauración

aptabit backup
aptabit backup list
aptabit backup rollback <id>

El backup es un punto de restauración local con los archivos de configuración y los volúmenes de PostgreSQL, MinIO, Milvus y etcd del stack. La plataforma se detiene unos instantes para garantizar la consistencia.

• Las dependencias externas (PostgreSQL, Redis, S3 o Milvus gestionados) no forman parte del backup de la CLI; utilice las herramientas de esos servicios.
• La carpeta identity/ no se copia, porque contiene la clave privada de la instalación.
• El backup se escribe en el disco local, sin cifrado; cópielo al sistema de backup de la organización.

Dependencias externas

Cada dependencia puede apuntar a un servicio que su organización ya opera. El comando avanzado aptabit init genera la configuración:

aptabit init \
  --config /opt/aptabit/produccion/config.yaml \
  --database external \
  --database-url postgres://usuario:contrasena@db.example.com:5432/aptabit \
  --redis external \
  --redis-url redis://redis.example.com:6379 \
  --storage s3-external \
  --storage-endpoint https://s3.example.com \
  --storage-bucket aptabit-prod \
  --storage-access-key <access-key> \
  --storage-secret-key <secret-key> \
  --vector external \
  --vector-endpoint http://milvus.example.com:19530 \
  --force

El docker-compose.yml generado omite los servicios y volúmenes locales correspondientes. Para validar sin iniciar contenedores:

docker compose -f /opt/aptabit/produccion/docker-compose.yml config --quiet
aptabit up --config /opt/aptabit/produccion/config.yaml --dry-run

Varias instalaciones en el mismo servidor

Cada instalación tiene carpeta, proyecto Compose, nombres de contenedores y red propios, y puede nombrarse con aptabit install --name <nombre>. Sin --config, los comandos actúan sobre la instalación actual; la CLI lista las demás cuando existen.

Diagnóstico

aptabit status --json
aptabit logs --service api --service worker --follow --tail 100
aptabit support-bundle

• Cada comando escribe un log de la ejecución en ~/.aptabit/logs/, con los secretos reemplazados por <redacted>; se conservan los 50 más recientes.
• Un fallo termina con un código estable, un ID y la ruta del log. Informe el ID al soporte.
• El paquete de soporte reúne la verificación de la máquina, la configuración, el estado de los contenedores con sus últimas 300 líneas de log, la situación del setup y de la licencia y los logs recientes, sin contraseñas, claves ni tokens.

Observabilidad

• Logs estructurados en JSON.
• Endpoints /health y /ready para verificaciones de disponibilidad.
• Exportación de trazas y logs mediante OpenTelemetry al colector de la organización, configurada en Configuración > Logs.
• Configuración > Sistema muestra la CPU, la memoria, los discos y las GPU de la máquina.

Límites actuales

• Cada instalación se ejecuta en un único servidor; la alta disponibilidad depende de dependencias gestionadas externamente.
• El proxy atiende HTTP; el TLS se termina en la infraestructura de la organización.
• El instalador guiado utiliza Docker; la compatibilidad con Podman es parcial.
• Existe un chart Helm inicial, pero la CLI no opera instalaciones en Kubernetes.