From c0832c70fab3936e1b12b35e71984a5812a712f9 Mon Sep 17 00:00:00 2001 From: Maciej Gajek Date: Fri, 24 Nov 2023 15:57:30 +0100 Subject: [PATCH] Add docs for connection params configuration and staging repo configuration for Sonatype --- website/docs/commands/publishing/publish.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/website/docs/commands/publishing/publish.md b/website/docs/commands/publishing/publish.md index cbb0f2519c..44932ed096 100644 --- a/website/docs/commands/publishing/publish.md +++ b/website/docs/commands/publishing/publish.md @@ -288,6 +288,18 @@ Specify publish repository authentication either on the command-line or via using directives. See user / password / realm in the [settings table](#settings) and the [CI overrides](#ci-overrides). +### Connection parameters configuration + +When publishing large packages or when the internet connection is spotty one may use the following options to configure the connection parameters: +- `--connection-timeout-seconds` - the connection timeout in seconds +- `--response-timeout-seconds` - the response timeout in seconds +- `--connection-timeout-retries` - the number of times to retry the connection on timeout + +Publishing to Sonatype uses a staging repository which may sometimes cause problems when transitioning through states. +If a publishing process fails with status `500` and message `"Staging repository is already transitioning"` you can try to tweak the following parameters taht are Sonatype specific: +- `--staging-repo-retries` - the number of times to retry the staging repository transition +- `--staging-repo-wait-time-milis` - the base time to wait between retries in milliseconds + ## Publishing Once all the necessary settings are set, publish a Scala CLI project with a command