@@ -1383,6 +1383,42 @@ Infrastructure team is able to perform the switch of the default. An issue
|
1383 | 1383 | should be opened on the [Node.js Snap management repository][] requesting this |
1384 | 1384 | take place once a new LTS line has been released. |
1385 | 1385 | |
| 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 | + |
1386 | 1422 | [Build issue tracker]: https://github.com/nodejs/build/issues/new |
1387 | 1423 | [CI lockdown procedure]: https://github.com/nodejs/build/blob/HEAD/doc/jenkins-guide.md#restricting-access-for-security-releases |
1388 | 1424 | [Node.js Snap management repository]: https://github.com/nodejs/snap |
|