# Frames

[![pipeline status](http://gitlab.2iopenservice.com/opentalent/frames/badges/master/pipeline.svg)](http://gitlab.2iopenservice.com/opentalent/frames/-/commits/master)

Frames est une application Nuxt proposant des iframes à inclure sur des sites tierces.

Iframes implémentées:

* [Recherche des structures des fédérations](https://ressources.opentalent.fr/display/SPEC/Les+societes+adherentes)

A voir:

* [vuejs.org](https://vuejs.org/v2/guide/)
* [nuxtjs.org](https://fr.nuxtjs.org/docs/2.x/get-started/installation)
* [vuetifyjs.com](https://vuetifyjs.com/en/)
* [typescriptlang.org](https://www.typescriptlang.org/)
* [jestjs.io](https://jestjs.io/docs/getting-started)
* [cypress.io](https://docs.cypress.io/guides/getting-started/installing-cypress)
* [pm2.keymetrics.io](https://pm2.keymetrics.io/docs/usage/quick-start//)


## Opérations courantes

## Déploiement

### Premier déploiement en tant que service

> Prérequis 1 : PM2 doit être installé de manière globale sur la machine hôte (https://nuxtjs.org/deployments/pm2/)

On commence par cloner le projet app, puis par se placer dans le répertoire ainsi créé.
On créé un symlink vers le fichier .env.xxx voulu sous le nom de .env (selon l'environnement)

    ln -s .env.xxx .env

Pour déployer le projet en mode SSR, on commence par mettre à jour et compiler :

    yarn install
    yarn build

On lance ensuite le service avec :

    pm2 start

Vérifier le statut avec :

    pm2 show frames

On pourra ensuite interagir avec le service ainsi :

    pm2 restart frames
    pm2 stop frames
    pm2 logs frames

On enregistre le service pour qu'il soit relancé lors du boot de la machine:
https://pm2.keymetrics.io/docs/usage/startup/

En tant que non-root:

    pm2 startup

Puis, comme la commande précédente le suggère, on lance **en tant que root**:

    

On sauvegarde la nouvelle configuration avec:

    pm2 save

### Mettre à jour

Se placer dans le répertoire de l'application, puis lancer:

    yarn deploy

Cette commande est un alias qui équivaut à lancer:

    git pull
    yarn install
    yarn build
    pm2 restart

## Run tests

To run unit tests:

    yarn test

To run end-to-end tests with [Cypress](https://docs.cypress.io/guides/):

    yarn cypress

To run it in command line:

    yarn cypress:run