Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document publishing process configuration #2580

Merged
merged 1 commit into from
Nov 27, 2023
Merged

Document publishing process configuration #2580

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions website/docs/commands/publishing/publish.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down