# Applications et environnements

> Décrivez une fois l'architecture de votre application, puis déployez-la dans autant d'environnements dev, staging et prod que nécessaire.

Une application hébergée sur Wakastart se décrit en deux temps. Vous déclarez d'abord son **architecture** : ses dépôts Git, ses services, ses bases de données, ses buckets et ses URLs. Vous créez ensuite des **environnements** — développement, recette, production — qui reçoivent chacun leurs propres exemplaires de ces ressources.

Votre application est créée par Wakastart ; contactez-nous pour en ouvrir une. Tout le reste se pilote depuis la console Wakastart (`https://app.wakastart.app`), dans le menu de votre application : **Architecture**, **Builds**, **Environnements**.

## Comment ça marche

```mermaid
flowchart LR
  subgraph ARCH["Architecture — déclarée une fois"]
    direction TB
    R["Dépôts Git"] --> SD["Définitions de service"]
    DB["Définitions de base"]
    BK["Définitions de bucket"]
    URL["URLs publiques"]
  end
  subgraph DEV["Environnement dev-team-a (type dev)"]
    direction TB
    SI1["Instances de service"]
    DI1["Bases, buckets, routes"]
  end
  subgraph PROD["Environnement prod (type prod)"]
    direction TB
    SI2["Instances de service"]
    DI2["Bases, buckets, routes"]
  end
  SD -->|"valeurs par défaut"| SI1
  SD -->|"valeurs par défaut"| SI2
  DB --> DI1
  DB --> DI2
```

Chaque élément de l'architecture est une [définition](/v1.0/glossaire#définition) : elle porte des valeurs par défaut (ressources CPU, version de base, région…). Dans chaque [environnement](/v1.0/glossaire#environnement), une **instance** reprend ces valeurs et peut en surcharger certaines : plus de mémoire en production, une autre version de base en développement. Quand vous modifiez une valeur par défaut, Wakastart redéploie les instances qui ne la surchargent pas.

Toutes les opérations sont asynchrones : la console enregistre votre demande, puis la plateforme l'applique en quelques secondes à quelques minutes. Le [cycle de vie des ressources](/v1.0/applications/cycle-de-vie) détaille les statuts que vous verrez passer.

## Choisissez votre approche

::::cards{cols=2}
:::card{title="Construire dans la console" href="/v1.0/services/creer-un-service" icon="MousePointerClick"}
Déclarez dépôts, services et dépendances écran par écran. Recommandé pour une première application.
:::
:::card{title="Importer une architecture JSON" href="/v1.0/applications/exporter-et-importer-l-architecture" icon="FileJson"}
Reprenez l'architecture d'une autre application, ou générez-la avec un assistant IA, puis importez-la d'un bloc.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Créer un environnement" href="/v1.0/applications/creer-un-environnement" icon="Cloud"}
Ajoutez un environnement dev, staging ou prod à votre application.
:::
:::card{title="Déployer un service" href="/v1.0/services/deployer-un-service" icon="Rocket"}
Faites tourner un service de votre architecture dans un environnement.
:::
:::card{title="Vérifier qu'un environnement est prêt" href="/v1.0/applications/verifier-qu-un-environnement-est-pret" icon="ListChecks"}
Lisez l'encart « Ce qu'il reste à configurer » et corrigez chaque écart.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Plusieurs environnements par type" href="/v1.0/applications/architecture-et-environnements" icon="Layers"}
Créez dev-team-a et dev-team-b, chacun isolé, avec sa propre référence Git.
:::
:::card{title="Préfixe d'URL" href="/v1.0/applications/configurer-un-environnement" icon="Link"}
Publiez `api.staging.votre-domaine` à côté de `api.votre-domaine` sans collision.
:::
:::card{title="Export et import JSON" href="/v1.0/applications/format-architecture-json" icon="Braces"}
Un format versionné, sans identifiant propre à l'application, pour copier une architecture.
:::
:::card{title="Rapport de préparation" href="/v1.0/applications/verifier-qu-un-environnement-est-pret" icon="ClipboardCheck"}
Services non instanciés, variables vides, builds manquants : tout ce qui manque, au même endroit.
:::
:::card{title="Réparation de l'infrastructure" href="/v1.0/applications/reparer-l-infrastructure" icon="Wrench"}
Recréez le registre d'images et le coffre de secrets de l'application s'ils manquent.
:::
:::card{title="Liste de contrôle de production" href="/v1.0/applications/liste-de-controle" icon="ShieldCheck"}
Les points à vérifier avant d'ouvrir un environnement de production.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Services" href="/v1.0/services" icon="Container"}
Définissez vos conteneurs et dimensionnez-les par environnement.
:::
:::card{title="Builds et déploiements" href="/v1.0/builds-et-deploiements" icon="Hammer"}
Construisez vos images depuis Git et déployez-les.
:::
:::card{title="Variables et secrets" href="/v1.0/variables-et-secrets" icon="KeyRound"}
Fournissez sa configuration à chaque service, environnement par environnement.
:::
::::

## Ressources

- [Référence des écrans et des champs](/v1.0/applications/reference)
- [Format de l'architecture JSON](/v1.0/applications/format-architecture-json)
- [Résoudre les problèmes d'environnement](/v1.0/applications/depannage)
- [Limites et quotas](/v1.0/limites)
