Versions
Utilisez cette page pour savoir ce que contient une version et où elle
atterrit. Un tag git démarre chaque version, et le préfixe du tag choisit
l’artefactà : v* publie des images de conteneurs versionnées, et un
préfixe de paquet publie un paquet npm.
Le principe des versions
Section intitulée « Le principe des versions »Facet livre deux types d’artefacts depuis un seul dépôtà :
| Artefact | Déclencheur | Où il atterrit |
|---|---|---|
| Images de conteneurs | un tag git v* |
GHCRà: ghcr.io/wearefacet/facet, ghcr.io/wearefacet/facet-frontend |
| Paquets npm | un préfixe de tag de paquet (sdk-v*, chat-v*, cli-v*) |
le registre npm, plus une GitHub Release |
Les deux pipelines de release passent leurs contrôlesà :
- Pipeline conteneurs — construit et soumet les deux architectures à un test de fumée avant que quoi que ce soit n’atteigne le registre.
- Pipeline npm — lance lint, la vérification de types et les tests avant de publier.
Images de conteneurs
Section intitulée « Images de conteneurs »Un mainteneur pousse un tag v*. Le workflow de release construit alors les
images backend et frontend pour amd64 et arm64, fait tourner la pile de tests
de fumée sur les deux architectures, et publieà :
| Tag d’image | Signification |
|---|---|
X.Y.Z |
Une version exacte |
X.Y |
La dernière version d’une série mineure |
latest |
La dernière version — uniquement des tags de version, jamais des builds de branche |
Un push sur master publie le canal glissantà : les tags d’image master
et nightly avancent à chaque build vert. Un test de fumée en échec laisse le
registre intact.
Paquets npm
Section intitulée « Paquets npm »Chaque paquet sous packages/ possède un préfixe de tag, et un tag démarre
exactement une version :
| Tag | Paquet |
|---|---|
sdk-v* |
@facetapp/sdk |
chat-v* |
@facetapp/chat |
cli-v* |
@facetapp/cli |
La version du tag doit égaler le champ version du package.json du
paquetà : un tag sans montée de version ne publie rien. Une version avec
un -, par exemple 0.0.2-beta.1, est une préversion : elle se publie
sous le dist-tag beta et ne devient jamais latest. Chaque version ouvre
une GitHub Release avec des notes générées.
Notes de version
Section intitulée « Notes de version »Lisez les notes de chaque version sur sa GitHub Release. Elles commencent avec la première version.
Voir aussi
Section intitulée « Voir aussi »- Déployez les images de releaseà : Exploitation
- Le pipeline de construction et de publication des conteneurs (doc du dépôt) : doc/ops/container-images.md
- Le flux de release des paquets npm (doc du dépôt) : doc/packages/release.md