Installation

Il est possible d’installer le projet de deux façon différentes, en plus de celle du mode développement.

Pip

Prérequis

Installer

Dans les commandes suivantes, remplacer :

  • <personal_access_token_name> avec le nom de votre jeton (PAT). Exemple : oche

  • <personal_access_token_value> avec la valeur de votre jeton (PAT). Exemple : aBcdEfghIJKLMNoP9R7s

# Windows: py -3
python3 -m pip install -U gpf-pub-agent-rok4 --index-url https://<personal_access_token_name>:<your_personal_token>@gitlab.gpf-tech.ign.fr/api/v4/groups/55/-/packages/pypi/simple

Derrière un proxy

Pour les proxy de type socks, installer :

python3 -m pip install -U "PySocks<2"

Puis ajouter l’URL du proxy en option :

# Windows: py -3
python3 -m pip install -U gpf-pub-agent-rok4 --index-url https://<personal_access_token_name>:<your_personal_token>@gitlab.gpf-tech.ign.fr/api/v4/groups/55/-/packages/pypi/simple --proxy socks5://localhost:8645

Note

Nous utilisons ici l’identifiant du groupe geoplateforme (55). Cet identifiant est visible sous le nom, sur la page du groupe.
Il est aussi possible d’utiliser le registre lié au projet où des instructions détaillées sont fournies au clic sur le package :

Détails d'un package sur le registre GitLab

Docker

Note

L’image est configurée à des fins d’utilisation et non à des fins de développement.
A ce titre l’image ne contient que le code source et le nécessaire pour installer le programme. Donc, il n’y a pas les dossiers docs, tests, etc.

Si besoin, ajuster le fichier .dockerignore.

Prérequis

  • Docker >= 20.10

Builder l’image

docker build --pull --rm -f "Dockerfile" -t gpf-pub-agent-rok4:latest "."

Exécuter l’image dans un conteneur

Entrer dans le conteneur et exécuter des commandes de façon interactive :

> docker run --rm -it  gpf-pub-agent-rok4:latest
root@55c5de0191ee:/user/app# gpf-pub-agent-rok4 --version
0.2.0

Exécuter le programme dans le conteneur :

> docker run --rm gpf-pub-agent-rok4:latest gpf-pub-agent-rok4 --version
0.2.0