Lançamentos canários
O Docusaurus possui um sistema de liberação canário.
Ele permite que você teste novos recursos não lançados assim que os pull-requests forem aceitos.
É uma boa maneira de dar feedback aos mantenedores, garantindo que o recurso recém-implementado funcione como deveria.
note
Usar uma versão canário em produção pode parecer arriscado, mas na prática não é.
Uma versão canária passa por todos os testes automatizados e é usada em produção pelo próprio site Docusaurus.
Tag canário npm dist#
Para qualquer commit relacionado ao código no master, a integração contínua publicará uma versão canário sob a tag @canary npm dist. Geralmente, leva até 10 minutos.
Você pode ver em npm as tags dist atuais:
latest: lançamentos estáveis (exemplo:2.0.0-beta.0)canary: canary releases (example:0.0.0-1234+4a6de5cf7)
tip
Certifique-se de usar a versão canário mais recente e verifique a data de publicação (às vezes, o processo de publicação falha).
note
Canary versions follow the naming convention 0.0.0-commitNumber+commitHash.
Usando um lançamento canário#
Take the latest version published under the canary npm dist tag (for example: 0.0.0-1234+4a6de5cf7).
Use it for all the @docusaurus/* dependencies in your package.json:
- "@docusaurus/core": "^2.0.0-beta.0",- "@docusaurus/preset-classic": "^2.0.0-beta.0",+ "@docusaurus/core": "0.0.0-1234+4a6de5cf7",+ "@docusaurus/preset-classic": "0.0.0-1234+4a6de5cf7",Then, install the dependencies again and start your site:
npm installnpm startYou can also upgrade the @docusaurus/* packages with a command line:
npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canarycaution
Make sure to include all the @docusaurus/* packages.
For canary releases, prefer using an exact version instead of a semver range (avoid the ^ prefix).