...

Parametrización Portal UI

En el proyecto de Portal UI, no debemos cambiar el .env salvo que se de permiso para ello. 

Será necesario incluir estas dos variables en un archivo .env.local antes de desplegar nuestro proyecto Portal UI en local:

VUE_APP_API_ENVIRONMENT=https://micampusdesa.um.es
VUE_LOCAL_URL=atica-67-543.atica.um.es

La primera corresponde a la dirección por la que se proxyfican las llamadas a /api, como las de login, por ejemplo. En la segunda, tenemos que indicar nuestro dominio .um.es, no se puede utilizar localhost. El que hay es sólo un ejemplo, cada uno tendrá que poner el suyo.

Cómo funciona la parametrización en proyectos Vue

Parámetros independientes del entorno de despliegue

Podemos parametrizar nuestra aplicación utilizando variables de entorno, que podemos añadirlas en el archivo.env en la carpeta raiz del proyecto. El archivo, según su nombre, especificará lo siguiente:

...

Dentro de estos archivos, las variables se definen de la forma nombre=valor, teniendo en cuenta que sólo se incluyen las que empiecen por VUE_APP_ por ejemplo:

VUE_APP_FOO=bar
VUE_APP_SECRET=secretURL=http://loquesea.com

# Podemos incluir otras variables de entorno con $
# Esto resultaría en http://loquesea.com/bar
VUE_APP_COMBINADA = $VUE_APP_URL/$VUE_APP_FOO

Para utilizar estas variables, se referencian en el código JavaScript con process.env.NOMBRE_VARIABLE.

Como la imagen de la aplicación que se despliega es la misma en los diferentes entornos, no se pueden incluir parámetros dependientes del entorno en el que nos encontremos.

Parametrizar endpoint del backend

Para especificar el endpoint de nuestra api, podemos hacerlo en un archivo javascript:

const ENDPOINT_ROUTE = '/api';
export const ENDPOINT = (typeof(process.env.VUE_APP_BACKEND) != "undefined" ? process.env.VUE_APP_BACKEND : window.location.origin) + ENDPOINT_ROUTE;

Lo que está haciendo es comprobar si se ha definido la variable de entorno VUE_APP_BACKEND, y si o está coge la ruta base y le añade /api. La variable de entorno podemos defirla en un archivo .env.local, que no se subirá a gitlab, con nuestro backend en local. Si no, como ambas partes de la aplicación estarán desplegadas bajo la misma ruta, podemos utilizar window.location.origin.

Parámetros dependientes del entorno de despliegue

Los parámetros que dependan del entorno en el que se encuentra la aplicación debemos obtenerlo a través de llamadas al backend. El backend deberá ofrecer un servicio REST para obtener estos parámetros, que podemos almacenar en una tabla que creemos en base de datos.