Aller au contenu

Déployer et exécuter

Déclarer le projet dans AntFlow

AntFlow ne parcourt pas tout GitLab : sur UrbiVerde, il ne liste que les projets qui portent le topic antflow-urbiverde. Tant que ce topic est absent, votre chaîne reste invisible, même si le dépôt est parfaitement configuré. Ajoutez-le ici :

Settings → General → Topics → antflow-urbiverde

Le projet apparaît alors dans https://process.urbiverde.com/#/processings. Chaque référence du dépôt (branche ou tag) y expose les processes décrits par ses packages CWL : publier une nouvelle version revient à pousser un nouveau tag.

Pour tout le reste (l'interface, la gestion des exécutions, l'API), reportez-vous à la documentation générale d'AntFlow : https://antflow.csgroup.space/.

Dans la documentation AntFlow

Soumettre une exécution

Le plus simple reste l'interface : https://process.urbiverde.com/#/processings.

Pour automatiser, AntFlow expose une OGC API Processes. Un point est à comprendre avant de construire la moindre URL : les processes ne forment pas un catalogue global, ils sont rattachés à un projet Git et à une référence. C'est la conséquence directe de la façon dont vos chaînes arrivent sur la plateforme - un package CWL versionné dans un dépôt - et cela vous permet de faire coexister plusieurs versions d'une même chaîne, chacune sur sa branche ou son tag.

Tous les chemins commencent donc par le projet et sa référence :

/api/projects/<groupe>/<projet>/ref/<référence>/processes

Pour lister les processes exposés par une référence donnée :

curl -H "Authorization: Bearer $TOKEN" \
  "https://process.urbiverde.com/api/projects/urbiverde-if-pathfinder/<projet>/ref/main/processes"

Puis pour lancer une exécution, en reprenant le même préfixe :

curl -X POST \
  "https://process.urbiverde.com/api/projects/urbiverde-if-pathfinder/<projet>/ref/v1.0.0/processes/<mon-process>/execution" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"entree_path": "s3://<votre-bucket>/donnees/entree.tif"}}'

La référence est une branche, un tag ou un commit - exactement celle que vous auriez choisie pour un déploiement. En production, visez un tag plutôt qu'une branche : main suit les évolutions du dépôt, et une exécution relancée six mois plus tard n'exécuterait pas forcément la même chaîne.

Explorer l'API

Le Swagger de l'instance liste tous les endpoints et leurs paramètres, avec de quoi les essayer directement : https://process.urbiverde.com/api/docs.

Dans la documentation AntFlow

Publier les résultats

Une fois le traitement terminé, ses produits rejoignent le catalogue STAC avec leurs métadonnées : emprise, période d'observation, date de production et sources d'entrée. C'est ce qui les rend exploitables par le reste de la plateforme - ils apparaissent dans le STAC Browser et deviennent directement affichables par TiTiler. Pour qu'un raster produit par votre chaîne apparaisse aussi dans le géoportail, suivez la publication cloud native.

Dans la documentation AntFlow