Ir para o conteúdo principal

Lançamentos canários

O Docusaurus possui um sistema de liberação canário.

It permits you to test new unreleased features as soon as the pull requests are merged.

É uma boa maneira de dar feedback aos mantenedores, garantindo que o recurso recém-implementado funcione como deveria.

note

Using a canary release in production might seem risky, but in practice, it's not.

A canary release passes all automated tests and is used in production by the Docusaurus site itself.

Tag canário npm dist​

Para qualquer commit relacionado ao código no main, a integração contínua publicará uma versão canário sob a tag @canary npm dist tag. Geralmente, leva até 10 minutos.

Você pode ver em npm as tags dist atuais:

  • latest: stable releases (example: 2.0.0-beta.9)
  • canary: canary releases (example: 0.0.0-4222)
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.

Usando um lançamento canário​

Take the latest version published under the canary npm dist tag (for example: 0.0.0-4222).

Use isto para todas as dependências @docusaurus/* no seu package.json:

-  "@docusaurus/core": "^2.0.0-beta.9",
-  "@docusaurus/preset-classic": "^2.0.0-beta.9",
+  "@docusaurus/core": "0.0.0-4222",
+  "@docusaurus/preset-classic": "0.0.0-4222",

Em seguida, instale as dependências novamente e inicie seu site:

npm install
npm start

You can also upgrade the @docusaurus/* packages with command line:

npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary
caution

Certifique-se de incluir todos os pacotes @docusaurus/*.

Para lançamentos canários, prefira usar uma versão exata em vez de um intervalo de semver (evite o prefixo ^).