DevCollective.io

Devcollective.io

Desarrollo local

1. Instale Docker

Deberá instalar Docker para habilitar Postgres. Usuarios de Windows, asegúrese de instalar extensiones WSL2, ya que son necesarias para que Postgres funcione correctamente.

2. Instale el hilo

Por una variedad de razones, este proyecto depende del hilo. Puede instalarlo usando:

npm install -g yarn

3. Instalación del hilo

Esto instalará sus dependencias.

yarn

4. Inicie su base de datos

yarn dbup

Este paso crea 2 bases de datos Postgres en Docker. El del puerto 10800 es el desarrollo, mientras que el del puerto 10801 es para pruebas unitarias.

Usuarios de Windows:

Si ve este error:

 The command 'docker-compose' could not be found in this WSL 2 distro.

Luego, asegúrese de que en su escritorio Docker en Configuración/General que "use el motor basado en WSL 2" esté marcado.

5. Ejecute Pristine para crear todas sus bases de datos.

Tenemos un comando conveniente, yarn pristine , que recrea y vuelve a sembrar la base de datos. Puede usar este comando en cualquier momento para borrar su base de datos y restablecerla.

yarn pristine

Ejecute prístino cada vez que cambia el DB.

Pristine debe ejecutarse después de cada cambio de DB para actualizar su base de datos con las últimas migraciones.

Pristine se puede usar para restablecer su base de datos

Pristine se puede ejecutar en cualquier momento para restablecer su base de datos a un estado limpio. Esto puede ser útil en muchas situaciones.

Si te encuentras con problemas que Pristine no resuelve

Si encuentra problemas más profundos, es posible que desee destruir sus instancias de Postgres y comenzar desde el rasguño absoluto. Hay un comando que destruirá todas las imágenes de Docker, contenedores, volúmenes que actualmente no se están ejecutando. Primero, querrá detener todos los procesos de Docker relacionados con este proyecto, y luego ejecutar docker system prune -a . Nota: Este es un comando peligroso que destruirá todo lo que no se ejecuta actualmente en Docker, incluidos los proyectos que no son DCC.io.

6. Declarar el número de puerto personalizado para iniciar la aplicación

** La creación de este archivo es opcional. Si no crea este archivo en el entorno Dev, los valores predeterminados se utilizarán desde el archivo dev.env presente en la carpeta Dev.

Primero cree el archivo dev-override.env en la carpeta de desarrollo presente en el directorio root. Luego copie y pegue los siguientes campos en su archivo.

 PORT= *

En lugar de * puede declarar su propio número de puerto que está disponible en su máquina.

7. Inicie su servidor

Finalmente, puede ejecutar el comando yarn dev (Windows: yarn dev:win ) para iniciar el servidor. Esto servirá tanto al frontend como al backend en el puerto 3000.

8. Opcional: Configurar las extensiones de VScode

El menú de depuración en VScode, que se basa en Launch.json, se ha poblado con un par de opciones de ejecución. Uno ejecuta el servidor, mientras que el otro ejecuta las pruebas unitarias. Ambos están habilitados con puntos de interrupción y pueden ser una excelente manera para usted también depurar su código cuando sea necesario.

Este proyecto está configurado para jugar bien con VScode Jest. Ejecutará sus pruebas en segundo plano y también le dará botones útiles de "depuración" para pruebas específicas. Muy recomendable para cualquier trabajo de backend.

La instalación de VSCODE GraphQL habilita la resaltar de sintaxis GraphQL. Recomendado para el trabajo de GQL.

Docios útiles

Cómo hacer su primera solicitud de extracción: ¡gracias, Julio Alcantara! Cómo crear nuevas entidades Cómo sincronizar su repositorio con código actualizado

Configuración de producción

Si se implementa en la producción, primero coloque sus archivos de configuración en /etc/mintbean-v4/config/* . Luego ejecuta yarn start .