> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/docs/sample-projects/nuxt-on-edgegap.md).

# NuxtJS

Déployez une application web Nuxt sur Edgegap et servez-la à proximité de vos utilisateurs depuis le réseau edge mondial.

### Prise en main

Edgegap vous offre une plateforme très intuitive pour déployer une application web sans serveur, où que vous en ayez besoin. Dans ce tutoriel, nous passerons en revue les étapes pour déployer une application Nuxt. Avant de vérifier quoi que ce soit d'autre, assurez-vous d'avoir Yarn ou un autre logiciel de gestion de paquets comme npm ou npx. Pour ce tutoriel, nous utiliserons Yarn. Vous devez l'exécuter dans le répertoire de votre application, qui peut être, au départ, simplement un dossier vide.

Ouvrez votre terminal à l'emplacement de votre dossier et exécutez la commande suivante :

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn
```

{% endcode %}

Une fois que toutes les dépendances sont installées, assurez-vous que tout s'est bien installé en exécutant cette commande :

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn dev
```

{% endcode %}

Yarn dev devrait renvoyer la version de Yarn installée si tout s'est bien déroulé. Maintenant que cela est fait, nous pouvons examiner les autres prérequis pour mener à bien ce tutoriel.

### Prérequis

### Conteneuriser votre application

Conteneuriser la plupart des applications est simple. Vous devez créer un Dockerfile puis exécuter ce fichier dans Docker pour créer l'image. Visual Studio Code est une bonne plateforme pour créer votre Dockerfile, car, par défaut, il n'ajoute pas d'extension à chaque nouveau fichier que nous créons. C'est exactement ce dont nous avons besoin. Créez simplement un nouveau fichier et nommez-le Dockerfile. Vous verrez le petit logo Docker apparaître à côté.

Vous pouvez maintenant copier-coller ce script dedans pour obtenir les principales dépendances. Gardez à l'esprit que cela créera une image d'un peu plus de 1 Go. Dans le cadre de ce tutoriel, cela convient. Mais pour une application en production, vous devrez l'optimiser :

{% code collapsedlinecount="10" %}

```dockerfile
FROM node:lts as builder

WORKDIR /app

COPY . .

RUN yarn install \
  --prefer-offline \
  --frozen-lockfile \
  --non-interactive \
  --production=false

RUN yarn build

RUN rm -rf node_modules && \
  NODE_ENV=production yarn install \
  --prefer-offline \
  --pure-lockfile \
  --non-interactive \
  --production=true

FROM node:lts

WORKDIR /app

COPY --from=builder /app  .

ENV HOST 0.0.0.0
EXPOSE 80

CMD [ "yarn", "start" ]
```

{% endcode %}

Après avoir enregistré votre Dockerfile, il est temps de créer l’image. Vous pouvez facilement le faire en exécutant la commande suivante :

{% hint style="warning" %}
Pour les utilisateurs de processeurs ARM (Mac M1, M2, etc.), consultez la [page dédiée](broken://pages/1dc258657373c6841c443705e163a00299b41df2).
{% endhint %}

{% code collapsedlinecount="10" %}

```sh
docker build . -t registry.edgegap.com/<YOUR_REPO>/demo-nuxt-edgegap:<YOUR_VERSION_NUMBER>
```

{% endcode %}

Il est préférable d'ajouter un numéro de version suivant le versionnage sémantique, mais si vous ne prévoyez pas de mettre à jour votre build sur Edgegap après votre premier déploiement, vous pouvez omettre entièrement le numéro de version.

Mais avant cela, vous devez pousser la nouvelle image Docker que vous venez de créer vers le dépôt d'images de votre choix. N'oubliez pas que nous proposons des dépôts privés via Harbor, qui offrent une série d'avantages en matière de sécurité que vous n'auriez pas nécessairement en utilisant le dépôt Docker par défaut.

Mais avant cela, vous devez pousser la nouvelle image Docker que vous venez de créer vers le dépôt d'images de votre choix. N'oubliez pas que nous proposons des dépôts privés via Edgegap Registry, qui offrent une série d'avantages en matière de sécurité que vous n'auriez pas nécessairement en utilisant le dépôt Docker par défaut.

Pour pousser votre image vers notre dépôt, vous devrez d'abord vous connecter avec vos identifiants en utilisant cette commande :

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

Maintenant, il ne reste plus qu’à pousser votre image comme ceci :

{% code collapsedlinecount="10" %}

```sh
docker push registry.edgegap.com/<YOUR_REPO>/demo-nuxt-edgegap:<YOUR_VERSION_NUMBER>
```

{% endcode %}

Génial ! Maintenant, vous n’êtes plus qu’à une étape de déployer votre application Nuxt sur la plateforme d’Edgegap.

### Déployez votre application sur Edgegap

Il existe deux façons de déployer une application sur Edgegap. Dans les deux cas, vous devrez avoir un compte chez nous, que vous pouvez créer gratuitement en cliquant sur le lien juste ici. Tout d’abord, voyons comment déployer notre application conteneurisée via notre site web.

#### Déploiement d'une application via le tableau de bord d'Edgegap :

Vous devrez vous rendre à l'adresse web suivante et saisir vos identifiants. Une fois cela fait, vous serez automatiquement redirigé vers votre tableau de bord. Si vous venez de créer votre compte, vous verrez immédiatement une option pour lancer votre première application. Sinon, rendez-vous simplement dans l'onglet « Applications and games » du menu à gauche de votre écran. Vous verrez une option pour créer une nouvelle application dans le coin droit :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-fc4b2486acb434863c2a6fd0e3772e02bfd2e214%2Fcreate-app-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

Une fois que vous cliquez dessus, le formulaire suivant devrait apparaître :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-488e9bf3f56918ab3e01c15c9364a8fe321a40b5%2Fapp-form-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous devez remplir tous les champs obligatoires et, une fois terminé, il y a quelques éléments que vous devrez modifier par rapport aux valeurs par défaut :

* Numéro de port : Cette application doit avoir le port 3000 ouvert, veuillez donc l'ajouter dans la section « ports » du formulaire de création.
* Temps maximal de déploiement : Comme mentionné précédemment dans ce tutoriel, notre image NuxtJS pèse environ 1 Go. Pour déployer une image aussi volumineuse sur Edgegap, vous devrez augmenter le temps maximal de déploiement à environ 300 secondes.

Une fois que vous avez terminé de remplir le formulaire avec les informations appropriées, il vous suffit de le soumettre, et vous serez prêt pour le déploiement. Sélectionnez simplement la région et le nombre de joueurs que vous souhaitez émuler.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-3f94772bc292c12029b2fcf24a8e4f22df406d08%2Fnuxt-js-app-launch-1.png?alt=media" alt=""><figcaption></figcaption></figure>

Une fois vos choix confirmés, votre application sera en ligne sous peu. Voici ce que vous verrez une fois qu’elle aura été déployée. Vous pouvez y accéder vous-même en cliquant sur l’icône que nous avons entourée sur cette image.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-7963d541fcb7a40b3733247854e0fe3e346475b9%2Fnuxt-js-app-launch-2.png?alt=media" alt=""><figcaption></figcaption></figure>

Cela ouvrira un nouvel onglet où vous trouverez la page d’accueil par défaut de votre application Nuxt.

#### Déployer une application via l’API d’Edgegap

Bien que notre tableau de bord web soit le moyen le plus convivial de déployer une application, vous pouvez également le faire via une requête API très simple. Pour cela, vous pouvez utiliser Postman. Il est important que vous visitiez le tableau de bord pour [créer un jeton API](broken://pages/b31f6591fdc12253ba77ba75ff9b58db3ba91365) via les options de votre profil. Voici un guide simple pour créer votre jeton API.

Une fois que vous avez le jeton API en main, il ne reste plus qu’à formuler une requête de déploiement avec le nom de votre application, sa version, les adresses IP, la région dans laquelle vous souhaitez effectuer votre déploiement et, bien sûr, votre jeton comme partie des paramètres d’autorisation. Vous pouvez voir à quoi ressemble une requête complète dans notre documentation ici.

Une fois la requête envoyée, vous devriez voir une réponse sur votre ligne de commande ou dans Postman, qui devrait ressembler à ceci :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-4963dbbc9a5be5f79c9e449038b40eb250489bba%2Fnuxt-js-app-launch-api.png?alt=media" alt=""><figcaption></figcaption></figure>

C’est tout ce que vous devez faire pour déployer une application via une CLI. Pour confirmer que votre application a été déployée, vous pouvez retourner au tableau de bord et voir votre déploiement actif en cliquant sur l’onglet « déploiements actifs ».
