◐ Shell
clean mode source ↗

doc: add FAQ to releases section · nodejs/node@e64cef8

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