Skip to content

Commit 2010601

Browse files
RafaelGSSnodejs-github-bot
authored andcommitted
doc: add FAQ to releases section
PR-URL: nodejs#55992 Reviewed-By: Ruy Adorno <[email protected]> Reviewed-By: Richard Lau <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Antoine du Hamel <[email protected]>
1 parent 49bc1ce commit 2010601

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

doc/contributing/releases.md

+36
Original file line numberDiff line numberDiff line change
@@ -1383,6 +1383,42 @@ Infrastructure team is able to perform the switch of the default. An issue
13831383
should be opened on the [Node.js Snap management repository][] requesting this
13841384
take place once a new LTS line has been released.
13851385

1386+
## FAQ
1387+
1388+
Due to how `tools/release.sh` work, it isn't uncommon to face some errors
1389+
during the promotion process as it depends on network communication and machine
1390+
availability. This section aims to guide the releaser through potential
1391+
failures.
1392+
1393+
### Error on dist-indexer while promoting
1394+
1395+
```bash
1396+
node:events:491
1397+
throw er; // Unhandled 'error' event
1398+
^
1399+
1400+
Error: read ECONNRESET
1401+
at TLSWrap.onStreamRead (node:internal/stream_base_commons:217:20)
1402+
Emitted 'error' event on DestroyableTransform instance at:
1403+
at ClientRequest.<anonymous> (/usr/lib/node_modules/nodejs-dist-indexer/node_modules/hyperquest/index.js:14:19)
1404+
at ClientRequest.emit (node:events:513:28)
1405+
at TLSSocket.socketErrorListener (node:_http_client:494:9)
1406+
at TLSSocket.emit (node:events:513:28)
1407+
at emitErrorNT (node:internal/streams/destroy:157:8)
1408+
at emitErrorCloseNT (node:internal/streams/destroy:122:3)
1409+
at processTicksAndRejections (node:internal/process/task_queues:83:21) {
1410+
errno: -104,
1411+
code: 'ECONNRESET',
1412+
syscall: 'read'
1413+
}
1414+
```
1415+
1416+
Typical resolution: sign the release again.
1417+
1418+
```bash
1419+
./tools/release.sh -s vX.Y.Z
1420+
```
1421+
13861422
[Build issue tracker]: https://github.com/nodejs/build/issues/new
13871423
[CI lockdown procedure]: https://github.com/nodejs/build/blob/HEAD/doc/jenkins-guide.md#restricting-access-for-security-releases
13881424
[Node.js Snap management repository]: https://github.com/nodejs/snap

0 commit comments

Comments
 (0)