Comment préparer l'environnement
Prérequis techniques
Linux
nvm
: 0.35 ou supérieurnpm
: 6 ou supérieurdocker
: 19 ou supérieurdocker-compose
: 1.25 ou supérieurmake
: 4 ou supérieurphp
: 7 ou supérieurcomposer
: 1.9.1 ou supérieurxmllint
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 :
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
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)