Instalación

Requisitos de sistema

• NodeJS >= 14.18.0
• yarn >= 1.22.19

Configuración inicial

Mercury es un proyecto privado, por lo que para poder instalarlo es necesario acceder al repositorio de npm con las credenciales de acceso.

1. Instalar y configurar gcloud siguiendo las instrucciones de Google Cloud SDK.

2. Editar (o crear) el archivo ~/.npmrc para incorporar la información de acceso al repositorio de npm:

   @mercury:registry=https://europe-west1-npm.pkg.dev/etailers-gcp/mercury/
   //europe-west1-npm.pkg.dev/etailers-gcp/mercury/:always-auth=true

3. Generar token de acceso al repositorio privado npm:

   npx google-artifactregistry-auth --repo-config=$(realpath ~/.npmrc)

Crear nueva aplicación

Para crear una nueva aplicación de Mercury, ejecutar el siguiente comando:

yarn create @mercury/mercury-app

Luego de seguir los pasos en pantalla, se creará una nueva carpeta con el nombre de la aplicación.

Instalación

Para instalar una aplicación de Mercury ya existente, ejecutar el siguiente comando:

Instalación de dependencias

npx google-artifactregistry-auth && yarn

Configuración de variables de entorno

Copiar el archivo de ejemplo

cp mercury/.env.local.dist mercury/.env.local

Ajustar las variables de entorno según corresponda:

NODE_TLS_REJECT_UNAUTHORIZED=0
TET_API_SECRET=token
NEXT_PUBLIC_IMAGE_DOMAIN=magento.test
NEXT_PUBLIC_API_ENDPOINT=https://magento.test/graphql

Ejecutar aplicación

yarn dev