Aller au contenu
Hackathon

SSP Cloud et GitHub

En bref
Pour qui
Développeurs et data scientists de chaque équipe.
Lecture
4 min
Mise à jour
10 novembre 2026

Travailler sur les données du SSP Cloud, déposer le code de l'équipe sur GitHub sans clé, faire tourner le portail ou l'application.

Données utilisées

Projet SSP Cloud projet-hackathon-gestion-flux-isere (stockage S3) ; dépôt GitHub hackathon_dge_gestion_des_flux.

Le dépôt GitHub

Le dépôt hackathon_dge_gestion_des_flux est le répertoire GitHub du hackathon. Les bouts de code présents dans la branche principale (main) sont fournis comme des aides à destination des participants pour l'utilisation des outils fournis, notamment des APIDonnées et outils : Interface de programmation. Adresse web qu'un programme interroge pour recevoir des données (souvent en JSON) au lieu de télécharger un fichier. Certaines demandent une clé d'accès, à ne jamais publier. : ils sont repris page par page dans Codes et API.

Pour déposer un code, chaque équipe peut se créer une branche dans ce dépôt. Une branche est une version parallèle du code : l'équipe y travaille sans modifier la branche principale ni le travail des autres équipes.

TerminalBash
git switch -c equipe-nom-de-l-equipe # créer la branche de l'équipe et s'y placer git push -u origin equipe-nom-de-l-equipe
Clés d'accès

Certaines clés d'accès aux API sont indiquées dans le document Excel mis à disposition sur le SSP CloudDonnées et outils : Plateforme de travail de l'Insee pour la statistique publique (logiciel Onyxia) : RStudio, Jupyter ou VS Code dans le navigateur, et un stockage S3 où sont déposées les données du hackathon. avec les données disponibles, dans la rubrique « Codes ». Ne jamais les recopier dans le dépôt : les lire depuis une variable d'environnement, par exemple Sys.getenv("DATATOURISME_API_KEY") en R ou os.environ["DATATOURISME_API_KEY"] en Python.

Le SSP Cloud

Le SSP Cloud (datalab.sspcloud.fr, plateforme Onyxia de l'Insee) donne accès à toutes les données mises à disposition, dans le projet projet-hackathon-gestion-flux-isere.

  • Les fichiers sont sur le stockage S3Données et outils : Protocole de stockage de fichiers en ligne, rangés dans des buckets. Le SSP Cloud l'offre avec le logiciel MinIO ; on y accède depuis R, Python ou DuckDB avec des clés temporaires. (MinIO) du SSP Cloud, minio.lab.sspcloud.fr. Les scripts Distances routières et Données météo montrent comment les ouvrir en R avec arrow ; il faut régler les clés d'accès selon les paramètres d'emplacement du fichier.
  • Les fonds de carte de l'IGNTerritoire : Institut national de l'information géographique et forestière. Établissement public qui produit les cartes et les données géographiques de référence : BD TOPO, limites administratives, photos aériennes. Il les diffuse par la Géoplateforme (téléchargement et services web). (BD TOPOTerritoire : Base de données topographique de l'IGN : bâtiments, routes, cours d'eau, lieux nommés, équipements, zones protégées, en 3D et à précision métrique. Fournie pour l'Isère en GeoPackage et en Parquet. de l'Isère en GeoPackageDonnées et outils : Format géographique ouvert, en un seul fichier (base SQLite), qui peut contenir plusieurs couches. C'est le format de la BD TOPO de l'Isère déposée sur le SSP Cloud. et en Parquet) y sont aussi : voir Données et services IGN.
  • Les exports Parquet produits par data.gouv.fr se chargent directement dans un service du SSP Cloud : voir Exports Parquet, GeoJSON, PMTiles.

Pour toute question sur le SSP Cloud, l'experte de l'Insee est présente pendant le hackathon (Experts).

Ce portail

Le portail est construit avec Récit dans le dossier docs/ du dépôt. La plupart des pages sont générées depuis les fichiers du dépôt (dossier sources/ : hackathon-gestion-flux-tourisque.md et les scripts .R) :

TerminalBash
cd docs pnpm install pnpm dev # régénère les pages puis lance le portail sur http://localhost:3003 pnpm build # site statique dans docs/dist

Pour corriger une source, modifier sources/hackathon-gestion-flux-tourisque.md puis relancer pnpm generate : les pages générées portent un commentaire qui le rappelle.

Le même dépôt contient aussi l'application Plutôt là : le code de l'application est dans app/, sa logique et ses données dans packages/, et l'ensemble se gère avec pnpm depuis la racine du dépôt. Les commandes et les règles de travail sont dans Plutôt là · Développer.

Limites

À garder en tête

  • Les droits d'écriture sur le dépôt GitHub (qui peut créer une branche, qui fusionne) sont gérés par les organisateurs : cette page ne les décrit pas.
  • Les réglages d'accès au stockage du SSP Cloud changent selon le service ouvert (RStudio, Jupyter, VS Code) ; suivre les paramètres affichés par la plateforme.
  • La partie « Ce portail » s'adresse à qui veut modifier la documentation ; elle n'est pas nécessaire pour participer au hackathon.