34 lines
2.3 KiB
Markdown
34 lines
2.3 KiB
Markdown
# YAML et Docker Compose
|
|
|
|
Chaque fichier `.yaml` / `.yml` est lu comme du YAML.
|
|
|
|
## Édition
|
|
|
|
- **Couleurs** : clés, ancres / alias / `<<`, étiquettes (`!php/const`, `!tagged_iterator`), scalaires de bloc, `${VAR:-default}`.
|
|
- **Problèmes pendant la frappe** : erreurs de syntaxe avec ligne et colonne ; dans les fichiers Compose, clés inconnues, un service
|
|
sans image ni build, ports / volumes / environment / restart mal écrits, `depends_on` / réseaux / volumes nommés que personne ne
|
|
déclare ; les clés du `config/services.yaml` de Symfony.
|
|
- **Complétion** : clés et valeurs de Compose, services prêts à l'emploi sous `services:`, noms et étiquettes d'`image:` depuis Docker
|
|
Hub, clés de service de Symfony, les `config/*.yaml` de JumPHP.
|
|
- **Survol** d'`image:` : la description, les étoiles et les téléchargements de Docker Hub.
|
|
- Repli, et le plan dans **Structure** (`Ctrl+F12`).
|
|
|
|
## Navigation
|
|
|
|
`Ctrl+clic` / `F12` va à la définition, `Shift+F12` / `Alt+F7` liste les usages, le survol montre la définition, `Shift+F6` renomme.
|
|
Les valeurs qui mènent à un fichier sont des liens.
|
|
|
|
| Dans | Mène à |
|
|
|---|---|
|
|
| le YAML lui-même | alias `*x` → ancre `&x` ; le survol de `<<: *x` montre les clés fusionnées |
|
|
| `config/` de Symfony | `imports` / `resource` → fichiers ; une classe ou `controller: X::method` → le code ; `@service` → sa définition ; `%parameter%` → `parameters:` ; `%env(X)%` → les lignes du `.env` ; `!tagged_iterator` → les services étiquetés ; `!php/const` → la constante |
|
|
| traductions | clés de `translations/*.yaml` ↔ `'key'\|trans` dans Twig et `->trans('key')` en PHP |
|
|
| Compose | `extends`, `env_file`, `build`, chemins de l'hôte, `configs` / `secrets`, `depends_on` / réseaux / volumes ↔ leurs déclarations |
|
|
| JumPHP | `start_scene` → la classe, chemins d'assets → fichiers, actions de `input.yaml` ↔ `isPressed('…')`, clés de `lang.yaml` ↔ `Lang::t('…')`, événements de formulaires → méthodes |
|
|
|
|
Depuis PHP ou Twig, `Ctrl+clic` sur une telle chaîne ouvre son YAML.
|
|
|
|
## Docker Compose dans la fenêtre Docker
|
|
|
|
**Docker > Compose** : les fichiers compose du projet par dossier, créer l'override, **Add a service** (modèles), **Check**
|
|
(`docker compose config`, erreurs dans Problems), **Apply**. Voir [Docker](docker.md).
|