SSP Cloud et GitHub
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.
Bash
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.. Les scripts Distances routières et Données météo montrent comment les ouvrir en R aveclab. sspcloud. fr 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- et les scripts .R) :
Bash
Pour corriger une source, modifier sources/ 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.