Construire un package Arii

De SOS Paris
Aller à : navigation, rechercher

Jusqu'à la version 2.0, Ari'i était livré sous forme de modules à ajouter sur une installation basique de Symfony. L'intérêt principal étant l'intégration de nouveaux outils à un portail existant.

Les évolutions d'Ari'i en ont fait un produit à part entière avec un noyau et des modules qui forment un ensemble cohérent pour le suivi de production. Cet ensemble est maintenant proposé sous la forme d'une édition Symfony comprenant le portail, les modules et une configuration de base.

Cet article reprend les étapes pour construire symfony-arii-edition.

Portail

Github

La première étape est de créer un nouveau référentiel sur github.

On crée ensuite le référentiel local:

  • On clone le référentiel
git clone https://github.com/AriiPortal/symfony-arii-edition.git
Cloning into 'symfony-arii-edition'...
warning: You appear to have cloned an empty repository.
  • On obtient un répertoire symfony-arii-edition.git
cd symfony-arii-edition.git
  • On copie l'ensemble des fichiers du package

On prend soin de supprimer:

  • les répertoires .git
  • les fichiers temporaires ~
  • le fichier parameters.yml
  • Ajouter les fichiers
git add *
  • Faire un premier commit
git commit -m "Init"
  • Mettre à jour le référentiel distant
git push origin master

Packagist

Soumission du package

On peut se connecter à Packagist avec le compte GitHub AriiPortal.

et on clique sur Check.

  • Si le package est trouvé, on clique sur le même bouton dont l'intitulé est devenu Submit.

Mise à jour automatique

Le package est soumis mais il faut maintenant le mettre en mise à jour automatique sur github en utilisant l'url https://packagist.org/about#how-to-update-packages

  • On retourne sur GitHub dans le référentiel https://github.com/AriiPortal/symfony-arii-edition
  • On clique sur Settings
  • Puis sur Intégrations & services
  • Puis on ajoute le service en précisant "Packagist" dans la liste
  • On ajoute indique ensuite les coordonnées (User,Token et Domain)
  • Clic sur Add service

Test

Pour tester le résultat, il suffit de cloner le package puis exécuter un composer install.

Environnement

Le plus simple est de reprendre la version portable dans laquelle on retrouve l'ensemble des outils nécessaire (git, composer, etc...). Il faut ensuite renommer le répertoire symfony si il existe déjà.

cd \ARII
ren symfony symfony_OLD

Lancer le serveur LAMP:

arii start

Puis exécuter arii install

arii install

On arrive ensuite à la partie paramètres, vous pouvez accepter chaque entrée pour une installation basique.

Modules

Le portail peut évoluer en fonction des besoins par l'ajout de modules fournis par SOS Paris ou développé par vos équipes.

GitHub