Saltar al contenido principal

Inicia Twenty localmente

Instala e inicia Docker y, a continuación, ejecuta:
local start ejecuta la interfaz web, la API, el worker y las bases de datos. Funciona fuera de una carpeta de aplicación, espera a que el entorno esté listo e imprime su URL. El inicio de sesión es un paso independiente. Para instalar tu aplicación después, ejecuta twenty app apply --create --remote local desde su directorio. Para una instancia nueva, especifica una versión explícitamente o deja que la CLI seleccione la versión publicada más alta que coincida con engines.twenty de tu aplicación. Fuera de una aplicación con esa configuración, usa latest. Las instancias existentes conservan su versión y sus datos. Para una instancia existente, la compatibilidad con engines.twenty se comprueba mediante la APP_VERSION de la imagen, incluso cuando su etiqueta es latest. Una versión ausente, no válida o incompatible genera una advertencia y el inicio continúa.
Las instancias nuevas escuchan solo en loopback, en el puerto 2020. Usa --port \<port> al crear una instancia para elegir otro puerto. Usa un contexto de socket local de Docker; los motores Docker remotos no son compatibles con estos comandos.

Actualizar o restablecer

La actualización descarga la imagen solicitada antes de reemplazar la instancia. Conserva sus puertos, la base de datos y los volúmenes de archivos, así como las anulaciones de entorno. Nuevos valores predeterminados de CLI se aplican a las nuevas instancias creadas; las actualizaciones preservan los valores de entorno existentes. Sin una versión, sigue la misma selección de versión que un nuevo comienzo. Almacenamiento personalizado diseños rechazados. Los niveles bajos son rechazados antes de reemplazar el contenedor, incluyendo al usar una etiqueta como latest. Ambas imágenes deben declarar una APP_VERSION válida para que la CLI pueda comparar sus versiones reales. Pase 2.53 para iniciar o actualizar usando la etiqueta de imagen v2.53 flotante, o 2.53.1 para seleccionar una versión de parche específica. Si la creación de reemplazo falla o se cancela, la CLI restaura el contenedor y ajustes anteriores. Una vez que se inicia la nueva versión, actualizaciones fallidas retienen los volúmenes de datos pero no deshacen las migraciones de la base de datos. stop conserva todos los datos. Para eliminar permanentemente la instancia y sus datos, ejecutar:
Reiniciar solicitud de confirmación. Los scripts deben pasar --yes. Los mandos guardados y las credenciales no se eliminan.

Pruebas de integración

Usa la instancia de prueba independiente, con el puerto predeterminado 2021:
Configura TWENTY_API_KEY con una clave para esa instancia. Las pruebas de integración instalan y desinstalan una aplicación, así que mantenlas separadas de tu espacio de trabajo de desarrollo. Pasa --test a los registros, detener, actualizar o reiniciar al administrar esta instancia. El workflow de CI generado aprovisiona una instancia aislada mediante twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main e instala la CLI independiente por separado.

Otras configuraciones locales

Para una copia del código fuente de Twenty, el entorno de desarrollo existente también funciona:
Usa la URL y el puerto reales de tu servidor. Para espacios de trabajo con subdominios, usa el nombre de host del espacio de trabajo. Para la implementación en producción, sigue la guía de autoalojamiento.

Dependencias del proyecto

twenty app init declara twenty-sdk, twenty-client-sdk y twenty-ui en devDependencies, pero no los instala. Con la CLI twenty instalada globalmente, ejecuta yarn install desde el directorio de la aplicación generada antes de ejecutar twenty app typecheck, twenty app build o twenty app apply.