Dependencies update procedure
Dependency updates doen we bij voorkeur aan het begin van een sprint zodat we de nieuwe versies zelf kunnen ervaren. Dit sluit bevindingen van afnemers natuurlijk niet uit.
Inventariseer voor welke packages er patches zijn gemaakt in /patches
. Voor een update van een package met 'n patch betekent onderzoek naar de gevolgen.
Yarn update
Installeer de nieuwste Yarn.
yarn set version berry
Dependencies update
Niet elke dependency maakt gebruik van SemVer, in het bijzonder sass
. Elke breaking release behoeft onderzoek. Kijk naar GitHub releases, CHANGELOG, blogposts, etc.
Angular en Storybook hebben een eigen update procedure. Prettier, Stylelint en ESLint updaten we in een eigen issue.
De dependencies typescript
en tslib
moeten voor alle packages onderling identiek zijn. Hetzelfde geldt voor de Angular en Storybook dependencies.
Let erop dat er aan het einde van de update procedure geen onverklaarbare node_modules
directories in onze packages zijn ontstaan. Dit kan duiden op versie conflicten.
yarn upgrade-interactive
yarn dedupe --check # zonder --check als nodig
Danger.yml
In .github/workflows/danger.yml
de packages TypeScript en Danger meenemen.
Node / Cypress
Let op de Docker base image in de Dockerfile.
Storybook
In /storybook
:
yarn dlx storybook@latest upgrade
In /packages/react
:
yarn dlx storybook@latest upgrade
In /angular-workspace
:
yarn dlx storybook@latest upgrade
Doorzoek alle package.json
in de repository op de oude versie van Storybook, er zijn meer @storybook/
packages die buiten een Storybook installatie worden gebruikt. Let erop dat alle Storybook packages exact dezelfde versie hebben.
Daarna weer dedupe:
yarn dedupe --check # zonder --check als nodig
Angular
Zolang https://github.com/angular/angular-cli/issues/14841 niet is opgelost heeft de Angular CLI geen ondersteuning voor Yarn Workspaces. Het update proces gaat fout door de entries met workspace:^
in /angular-workspace/package.json
.
Het update proces is een handmatige handeling waarbij een beetje met yarn workspace angular-workspace ng update @angular/cli @angular/core
wordt gedaan en versie nummers updaten (handmatig of met yarn upgrade-interactive
).
Als er een major release zijn er mogelijk migrations zijn:
ng update @angular/cli --from 10 --to 11 --migrate-only
Zie ook https://update.angular.io/
Sub dependencies update
yarn up * --recursive
En dedupe:
yarn dedupe --check # zonder --check als nodig
Afronden
- Volledige lokale build: lint, build, build-www en e2e.
- Aanbieden als PR.
- Nieuw issue aanmaken voor volgende dependency update.