github.com/goreleaser/goreleaser@v1.25.1/www/docs/customization/nightlies.md (about)

     1  # Nightlies
     2  
     3  !!! success "GoReleaser Pro"
     4      The nightly build feature is a [GoReleaser Pro feature](/pro/).
     5  
     6  Whether if you need beta builds or a rolling-release system, the nightly builds
     7  feature will do it for you.
     8  
     9  To enable it, you must use the `--nightly` flag in the [`goreleaser release` command](/cmd/goreleaser_release/).
    10  
    11  You also have some customization options available:
    12  
    13  ```yaml
    14  # .goreleaser.yml
    15  nightly:
    16    # Allows you to change the version of the generated nightly release.
    17    #
    18    # Note that some pipes require this to be semantic version compliant (nfpm,
    19    # for example).
    20    #
    21    # Default is `{{ incpatch .Version }}-{{ .ShortCommit }}-nightly`.
    22    # Templates: allowed
    23    name_template: '{{ incpatch .Version }}-devel'
    24  
    25    # Tag name to create if publish_release is enabled.
    26    tag_name: devel
    27  
    28    # Whether to publish a release or not.
    29    # Only works on GitHub.
    30    publish_release: true
    31  
    32    # Whether to delete previous pre-releases for the same `tag_name` when
    33    # releasing.
    34    # This allows you to keep a single pre-release.
    35    keep_single_release: true
    36  ```
    37  
    38  ## How it works
    39  
    40  When you run GoReleaser with `--nightly`, it will set the `Version` template
    41  variable to the evaluation of `nightly.name_template`. This means that if you
    42  use `{{ .Version }}` on your name templates, you'll get the nightly version.
    43  
    44  !!! tip
    45      Learn more about the [name template engine](/customization/templates/).
    46  
    47  ## What is skipped when using `--nightly`?
    48  
    49  - Go mod proxying;
    50  - GitHub/GitLab/Gitea releases (unless specified);
    51  - Homebrew taps;
    52  - Scoop manifests;
    53  - Arch User Repositories;
    54  - Krew Plugin Manifests;
    55  - Milestone closing;
    56  - All announcers;
    57  
    58  Everything else is executed normally.
    59  Just make sure to use the `Version` template variable instead of `Tag`.
    60  You can also check if it is a nightly build inside a template with:
    61  
    62  ```
    63  {{ if .IsNightly }}something{{ else }}something else{{ end }}
    64  ```
    65  
    66  !!! info "Maybe you are looking for something else?"
    67      - If just want to build the binaries, and no packages at all, check the
    68        [`goreleaser build` command](/cmd/goreleaser_build/);
    69      - If you actually want to create a local "snapshot" build, check out the
    70        [snapshots documentation](/customization/snapshots/).