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.
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
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:
--yes. Los mandos guardados y las credenciales
no se eliminan.
Pruebas de integración
Usa la instancia de prueba independiente, con el puerto predeterminado2021:
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: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.