Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
docs: update from pro
Signed-off-by: Carlos A Becker <caarlos0@users.noreply.github.com>
- Loading branch information
Showing
9 changed files
with
212 additions
and
37 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
# goreleaser continue | ||
|
||
Continues a previously prepared release | ||
|
||
## Synopsis | ||
|
||
If you have a previously prepared release (run with `goreleaser release --prepare` or `goreleaser release --split`), you can use this command to continue it. | ||
|
||
Environment variables will be re-evaluated here, so make sure they are | ||
available to the continue command as well. | ||
|
||
!!! success "GoReleaser Pro" | ||
This subcommand is [GoReleaser Pro feature](https://goreleaser.com/pro/). | ||
|
||
|
||
``` | ||
goreleaser continue [flags] | ||
``` | ||
|
||
## Options | ||
|
||
``` | ||
-d, --dist string dist folder to continue (default "./dist") | ||
-h, --help help for continue | ||
-k, --key string GoReleaser Pro license key [$GORELEASER_KEY] | ||
--merge Merges multiple parts of a --split release | ||
-p, --parallelism int Amount tasks to run concurrently (default: number of CPUs) | ||
--skip-after Skips global after hooks | ||
--timeout duration Timeout to the entire continue process (default 30m0s) | ||
``` | ||
|
||
## Options inherited from parent commands | ||
|
||
``` | ||
--debug Enable debug mode | ||
``` | ||
|
||
## See also | ||
|
||
* [goreleaser](/cmd/goreleaser/) - Deliver Go binaries as fast and easily as possible | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
# Splitting and Merging builds | ||
|
||
!!! success "GoReleaser Pro" | ||
This subcommand is [GoReleaser Pro feature](https://goreleaser.com/pro/). | ||
|
||
> Since GoReleaser v1.12.0. | ||
You can now split and merge builds. | ||
This can help in several areas: | ||
|
||
1. CGO, as you can build each platform in their target OS and merge later; | ||
1. Native packaging and signing for Windows and macOS (more features for this | ||
will be added soon); | ||
1. Speed up slow builds, by splitting them into multiple workers; | ||
|
||
## Usage | ||
|
||
You don't really need to set anything up. To get started, run: | ||
|
||
```bash | ||
goreleaser release --rm-dist --split | ||
``` | ||
|
||
Note that this step will push your Docker images as well. | ||
Docker manifests are not created yet, though. | ||
|
||
This will build only the artifacts for your current `GOOS`, and you should be | ||
able to find them in `dist/$GOOS`. | ||
|
||
You can run the other `GOOS` you want as well by either running in their OS, or | ||
by giving a `GOOS` to `goreleaser`. | ||
|
||
You should then have multiple `GOOS` folder inside your `dist` folder. | ||
|
||
Now, to continue, run: | ||
|
||
```bash | ||
goreleaser continue | ||
``` | ||
|
||
This last step will run some extra things that were not run during the previous | ||
step: | ||
|
||
- merge previous contexts and artifacts lists | ||
- pull previously built images | ||
- create the source archive (if enabled) | ||
- checksum all artifacts | ||
- sign artifacts (according to configuration) | ||
- SBOM artifacts (according to configuration) | ||
- run all the publishers | ||
- run all the announcers | ||
|
||
You can also run the publishing and announce steps separately: | ||
|
||
```bash | ||
goreleaser publish --merge | ||
goreleaser announce --merge | ||
``` | ||
|
||
## Customization | ||
|
||
You can choose by what you want your pipeline to be split by: | ||
|
||
```yaml | ||
# goreleaser.yaml | ||
partial: | ||
# By what you want to build the partial things. | ||
# | ||
# Valid options are `target` and `goos`: | ||
# - `target`: `GOOS` + `GOARCH`. | ||
# - `goos`: `GOOS` only | ||
# | ||
# Default: `goos`. | ||
by: target | ||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters