Comment ? / How To ?

Comment préparer l'environnement

Prérequis techniques

  • Linux
  • nvm : 0.35 ou supérieur
  • npm : 6 ou supérieur
  • docker : 19 ou supérieur
  • docker-compose : 1.25 ou supérieur
  • make : 4 ou supérieur
  • php : 7 ou supérieur
  • composer : 1.9.1 ou supérieur
  • xmllint
  • jq

Vous devez ensuite utiliser nvm pour installer la version 12 de nodejs :

nvm install v12

Attention

Il est important de créer le dossier servant de répertoire pour notre projet et d'aller dedans avant de continuer ce chapitre.

Il est nécessaire de récupérer le module permettant de développer des projets Anakeen Platform. Passons donc à la configuration de npm permettant d'avoir accès à ce fameux module.

npm config set @anakeen:registry https://npm.ap4.anakeen.com/

Informations

Ce module contient un ensemble de Makefiles facilitant la connexion aux différentes ressources Anakeen :

  • la registry docker https://registry.ap4.anakeen.com
  • la registry npm https://npm.ap4.anakeen.com
  • le dépôt a4ppm https://a4ppm.ap4.anakeen.com

Ainsi qu'une commande d'initialisation de projet

Comment procéder ?

La commande suivante initialise un nouveau projet :

Attention

Le nom du projet doit respecter la norme kebab-case :

  • Mots en minuscule
  • S'il y en a plusieurs, liés par des tiret ( - )
npx @anakeen/anakeen-project-utils init --name restauratec

Ce message vous indique que tout s'est bien passé ...

npx : 662 installé(s) en 15.314s
info project restauratec initialized in /path/to/MonProjet

... et ces fichiers ont été générés :

Résultat d'initialisation d'un projet

Informations

Le login et password nécessaires à la connexion aux dépots vous sont communiqués avec le contrat qui vous lie à Anakeen. Le mail n'est pas utilisé donc n'importe quelle adresse fera l'affaire.

Voici la commande pour se connecter aux dépôts Anakeen (registry a4ppm et npm) :

npx @anakeen/anakeen-project-utils login --login <Login> --password <Password> --mail <Mail>

Et ensuite pour se connecter à notre registry docker (toujours avec les mêmes login et mot de passe) :

docker login https://registry.ap4.anakeen.com/

Si tout s'est bien passé, vous devriez obtenir trois code 2xx comme ci-dessous :

npx : 662 installé(s) en 16.799s
info NPM Login
info attempt registry request try #1 at 10:05:23
http request PUT https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>
http 201 https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>
info attempt registry request try #1 at 10:05:23
http request GET https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>?write=true
http 200 https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>?write=true
info attempt registry request try #1 at 10:05:23
http request PUT https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>/-rev/undefined
http 201 https://npm.ap4.anakeen.com/-/user/org.couchdb.user:<Login>/-rev/undefined
info NPM Update project dependencies
info A4PPM Login

La dernière étape consiste à initialiser et lancer l'environnement (Le contexte d'Anakeen Platform).

make env-start

Informations

Cette commande démarre un conteneur docker avec :

  • Le serveur Apache
  • La base de données
  • Un bouchon pour les mails

Astuce

Il existe la possibilité de créer à la racine du projet, un fichier nommé Makefile.local.mk. Ce dernier permet de redéfinir les variables utilisées dans le Makefile, notamment les ports à utiliser par défaut lors de l'initialisation du projet. Cela peut s'avérer utile si d'autres programmes ou projets utilisent les ports définis par défaut.

Par défaut (Makefile.mk) :

[...]
PROJECT_PSQL_PORT = 54320 # Postgres
PROJECT_HTTP_PORT = 8080  # PHP
PROJECT_MAIL_PORT = 8081  # Mail
[...]

Makefile.local.mk

[...]
PROJECT_PSQL_PORT = 54420 # Postgres
PROJECT_HTTP_PORT = 8888  # PHP
PROJECT_MAIL_PORT = 8889  # Mail
[...]

Une fois l'initialisation du contexte d'Anakeen Platform effectuée, un rappel des ports qui sont exposés sont affichés en console. Pour le moment, seul le port exposé de la partie php nous intéresse (Par défaut: 8080).

La plateforme est bien initialisée et est dorénavant accessible à l'adresse suivante :

localhost:8080

Résultat

Une fois sur la page de login, nous pouvons nous connecter avec les informations suivante : admin/anakeen

Page de connexion

Une fois connecté, vous avez accès à deux interfaces utilisateurs fournies avec Anakeen Platform 4 :

  • Le centre d'administration (Admin Center)
  • Le centre de développement (Development Center)

Page connecté

Et ensuite ?

Comment initialiser une application