# SSP Cloud et GitHub

::::summary{title="En bref" audience="Développeurs et data scientists de chaque équipe." reading="4 min" updated="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.

:::details[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 <Terme mot="API" /> : ils sont repris page par page dans [Codes et API](/codes).

**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
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
```

:::caution{title="Clés d'accès"}
Certaines clés d'accès aux API sont indiquées dans le document Excel mis à disposition sur le <Terme mot="SSP Cloud" /> 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 <Terme mot="S3" /> (MinIO) du SSP Cloud, `minio.lab.sspcloud.fr`. Les scripts [Distances routières](/codes/distances-routieres) et [Données météo](/codes/meteo) 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'<Terme mot="IGN" /> (<Terme mot="BD TOPO" /> de l'Isère en <Terme mot="GeoPackage" /> et en Parquet) y sont aussi : voir [Données et services IGN](/codes/ign).
- Les exports Parquet produits par data.gouv.fr se chargent directement dans un service du SSP Cloud : voir [Exports Parquet, GeoJSON, PMTiles](/sources/outils-d-acces-aux-donnees/exports-parquet-geojson-pmtiles-hydra).

Pour toute question sur le SSP Cloud, l'experte de l'Insee est présente pendant le hackathon ([Experts](/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`) :

```bash
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à](/plutotla) : 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](/plutotla/developper).

## Limites

:::limits
- 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.
:::
