====== Garden Party ======

<WRAP center round important 60%>
Procédure en cours de rédaction
</WRAP>


===== Kécécé Garden Party =====

**[[https://garden-party.io/|Garden Party]]** est une application libre, sous licence MIT, de gestion de jardin.

Sur le papier le logiciel semble intéressant : il permet de gérer le plan d'un jardin, la position des différents plants, arbres, arbustes, parterres, les interactions entre les plantes. C'est un projet assez jeune.

Le logiciel est disponible pour YunoHost, Docker ou installable à partir des sources.

===== Installation sous Docker =====

<WRAP center round important 60%>
Procédure réalisée sous Debian
</WRAP>

Docker je connais mal et je ne suis pas fan (mettre un conteneur dans un conteneur, bof). Mais pour essayer c'est ce qui me semblait être la solution la plus simple (même si YunoHost est théoriquement encore plus simple).

==== Installer Docker ====

J'ai suivi [[https://docs.docker.com/engine/install/debian/|la documentation officielle de Docker]].

Ajouter le dépôt :

<code bash>
apt install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
</code>

Installer Docker :

<code bash>
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</code>

Vérifier le lancement du service :

<code bash>
systemctl status docker
</code>

==== Restaurer le conteneur ====

[[https://doc.garden-party.io/pages/generated-production-docker|Documentation Docker de Garden Party]]

Télécharger les fichiers ''docker-compose.yml'' et ''.env'' dans un dossier.

<code bash>
mkdir gardenparty
cd gardenparty
wget https://gitlab.com/experimentslabs/garden-party/garden-party/-/blob/develop/docker/docker-compose.yml
wget https://gitlab.com/experimentslabs/garden-party/garden-party/-/blob/develop/docker/.env
</code>

Modifier le fichier ''.env'' en ajoutant des chaînes de 32 caractères sur ''SECRET_KEY_BASE'' et ''INSTANCE_SECRET_KEY_JWT''.

La documentation propose de les générer avec la commande suivante :

<code bash>
head -c 48 /dev/urandom | base64
</code>

''DATABASE_PASSWORD'' correspond au mot de passe qui sera utilisé sur la base PostgreSQL.

<code>
SECRET_KEY_BASE=BO7IeuK5Les0PIjltNBC/TG0KVpsWVz+uJCVDxsq+JHEs5ypQ4MCPBaKmKsxLJkR
[...]
INSTANCE_SECRET_KEY_JWT=iuH2z8oRQ7GZOnE2U6614ro2MnCNneumL1eb+7/1gmhtOCIE19lLNRIW7W4yLMjg
[...]
DATABASE_PASSWORD=MonSuperMotDePasseQuiPoutre
</code>

Profitez-en aussi pour changer la langue de l'instance :

<code>
INSTANCE_LOCALE=fr
</code>

Lancer le conteneur Docker :

<code bash>
docker-compose up
</code>

Docker va faire des blips et des bloups et le logiciel devrait finir par être accessible via navigateur web sur le port 3000 de la machine (ex : http://192.168.1.206:3000).

Ayant testé Garden Party sur un conteneur LXC accessible uniquement sur mon LAN, j'ai dû désactiver le SSL dans ''.env'' :

<code bash>
RAILS_FORCE_SSL=false
</code>


==== Accéder à Garden Party ====

Se connecter à http://IP_DE_LA_MACHINE:3000.

Le compte administrateur par défaut est le suivant : 

  * Adresse : ''admin@example.com''
  * Mot de passe : ''password''

==== Ajouter des données ====

De base le logiciel est vide. Il n'y a pas de familles ou de plantes. Il faut ajouter une source de données.

Des sources de données sont disponibles [[https://gitlab.com/experimentslabs/garden-party/data/-/tree/main/data|le dépôt git du projet]].

Il est donc possible d'ajouter ces sources de données dans la configuration (''.env'') du conteneur. Par exemple avec les données de l'instance sarthoise :

<code>
# URL to the trusted datasource.
INSTANCE_TRUSTED_DATASOURCE_URL=https://gitlab.com/experimentslabs/garden-party/data/-/raw/main/data/fr_72.yml
</code>

Redémarrer le conteneur et se connecter en tant qu'administrateur. Il sera possible d'importer les données via le menu **Import**. Par contre je n'ai pas trouvé comme importer toutes les données dans cliquer environs 4000 fois sur le bouton "importer".