Deprecation notices
This page is used to list deprecation notices across GoReleaser.
Deprecated options will be removed after ~6 months from the time they were deprecated.
You can check your use of deprecated configurations by running:
goreleaser check
Active deprecation notices¶
docker.builds¶
since 2021-01-07 (v0.154.0)
builds
is deprecated in favor of ids
, since now it also allows to copy nfpm packages:
Change this:
dockers:
-
builds: ['a', 'b']
dockers:
-
ids: ['a', 'b']
docker.binaries¶
since 2021-01-07 (v0.154.0)
binaries
is deprecated and now does nothing. If you want to filter something out, use the ids
property.
Change this:
dockers:
-
binaries: ['foo']
dockers:
-
ids: ['foo']
nfpms.files¶
since 2020-12-21 (v0.149.0)
files
is deprecated in favor of contents
(check this page for more details):
Change this:
nfpms:
-
files:
foo: bar
nfpms:
-
contents:
- src: foo
dst: bar
nfpms.config_files¶
since 2020-12-21 (v0.149.0)
config_files
is deprecated in favor of contents
(check this page for more details):
Change this:
nfpms:
-
config_files:
foo: bar
nfpms:
-
contents:
- src: foo
dst: bar
type: config
nfpms.symlinks¶
since 2020-12-21 (v0.149.0)
symlinks
is deprecated in favor of contents
(check this page for more details):
Change this:
nfpms:
-
symlinks:
foo: bar
nfpms:
-
contents:
- src: foo
dst: bar
type: symlink
nfpms.rpm.ghost_files¶
since 2020-12-21 (v0.149.0)
rpm.ghost_files
is deprecated in favor of contents
(check this page for more details):
Change this:
nfpms:
-
rpm:
ghost_files:
- foo
nfpms:
-
contents:
- dst: bar
type: ghost
packager: rpm # optional
nfpms.rpm.config_noreplace_files¶
since 2020-12-21 (v0.149.0)
rpm.config_noreplace_files
is deprecated in favor of contents
(check this page for more details):
Change this:
nfpms:
-
rpm:
config_noreplace_files:
foo: bar
nfpms:
-
contents:
- src: foo
dst: bar
type: config|noreplace
packager: rpm # optional
nfpms.deb.version_metadata¶
since 2020-12-21 (v0.149.0)
deb.version_metadata
is deprecated in favor of version_metadata
(check this page for more details):
Change this:
nfpms:
-
deb:
version_metadata: beta1
nfpms:
-
version_metadata: beta1
Expired deprecation notices¶
The following options were deprecated in the past and were already removed.
brews.github¶
since 2020-07-06 (v0.139.0), removed 2021-01-04 (v0.152.0)
GitHub section was deprecated in favour of tap
which reflects Homebrew's naming convention. GitHub will be picked automatically when GitHub token is passed.
Change this:
brews:
-
github:
owner: goreleaser
name: homebrew-tap
brews:
-
tap:
owner: goreleaser
name: homebrew-tap
brews.gitlab¶
since 2020-07-06 (v0.139.0), removed 2021-01-04 (v0.152.0)
GitLab section was deprecated in favour of tap
which reflects Homebrew's naming convention. GitLab will be picked automatically when GitLab token is passed.
Change this:
brews:
-
gitlab:
owner: goreleaser
name: homebrew-tap
brews:
-
tap:
owner: goreleaser
name: homebrew-tap
puts¶
since 2019-11-15, removed 2020-04-14 (v0.132.0)
The HTTP upload support was extended to also accept POST
as a method, so the name puts
kind of lost its meaning.
puts:
- ...
uploads:
- ...
Also note that secrets environment variable name prefixes have changed from PUT_
to UPLOAD_
.
nfpms.name_template¶
since 2019-11-15, removed 2020-04-14 (v0.132.0)
The name_template
field was deprecated in favor of a more clear one, file_name_template
.
nfpms:
- name_template: foo
nfpms:
- file_name_template: foo
blob¶
since 2019-08-02, removed 2020-03-22 (v0.130.0)
Blob was deprecated in favor of its plural form. It was already accepting multiple inputs, but its pluralized now so its more clear.
blob:
# etc
blobs:
# etc
sign¶
since 2019-07-20, removed 2020-03-22 (v0.130.0)
Sign was deprecated in favor of its plural form.
sign:
# etc
signs:
-
# etc
brew¶
since 2019-06-09, removed 2020-01-26 (v0.125.0)
Brew was deprecated in favor of its plural form.
Change this:
brew:
# etc
brews:
-
# etc
s3¶
since 2019-06-09, removed 2020-01-07 (v0.125.0)
S3 was deprecated in favor of the new blob
, which supports S3, Azure Blob and GCS.
s3:
-
# etc
blobs:
-
provider: s3
# etc
ACLs should be set on the bucket, the acl
option does not exist anymore.
archive¶
since 2019-04-16, removed 2019-12-27 (v0.124.0)
We now allow multiple archives, so the archive
statement will be removed.
archive:
format: zip
archives:
- id: foo
format: zip
snapcraft¶
since 2019-05-27, removed 2019-12-27 (v0.124.0)
We now allow multiple Snapcraft configs, so the snapcraft
statement will be removed.
snapcraft:
publish: true
# ...
snapcrafts:
-
publish: true
# ...
nfpm¶
since 2019-05-07, removed 2019-12-27 (v0.124.0)
We now allow multiple NFPM config, so the nfpm
statement will be removed.
nfpm:
formats:
- deb
nfpms:
-
formats:
- deb
docker.binary¶
since 2018-10-01, removed 2019-08-02 (v0.114.0)
You can now create a Docker image with multiple binaries.
dockers:
- image: foo/bar
binary: foo
dockers:
- image: foo/bar
binaries:
- foo
docker.image¶
since 2018-10-20, removed 2019-08-02 (v0.114.0)
This property was deprecated in favor of more flexible image_templates
. The idea is to be able to define several images and tags using templates instead of just one image with tag templates. This flexibility allows images to be pushed to multiple registries.
dockers:
- image: foo/bar
tag_templates:
- '{{ .Tag }}'
dockers:
- image_templates:
- 'foo/bar:{{ .Tag }}'
docker.tag_templates¶
since 2018-10-20, removed 2019-08-02 (v0.114.0)
This property was deprecated in favor of more flexible image_templates
. The idea is to be able to define several images and tags using templates instead of just one image with tag templates.
dockers:
- image: foo/bar
tag_templates:
- '{{ .Tag }}'
dockers:
- image_templates:
- 'foo/bar:{{ .Tag }}'
git.short_hash¶
since 2018-10-03, removed 2019-01-19 (v0.98.0)
This property was being used to tell GoReleaser to use short git hashes instead of the full ones. This has been removed in favor of specific template variables (.FullCommit
and .ShortCommit
).
git:
short_hash: true
fake:
foo_template: 'blah {{ .Commit }}'
fake:
foo_template: 'blah {{ .ShortCommit }}'
fpm¶
since 2018-02-17, removed 2017-08-15 (v0.83.0)
FPM is deprecated in favor of nfpm, which is a simpler alternative written in Go. The objective is to remove the ruby dependency thus simplify the CI/CD pipelines.
Just replace the fpm
keyword by nfpm
in your .goreleaser.yml
file.
fpm:
# ...
nfpm:
# ...
docker.tag_template¶
since 2018-01-19, removed 2017-08-15 (v0.83.0)
This property was deprecated in favor of the pluralized tag_templates
. The idea is to be able to define several tags instead of just one.
dockers:
- image: foo/bar
tag_template: '{{ .Tag }}'
dockers:
- image: foo/bar
tag_templates:
- '{{ .Tag }}'
docker.latest¶
since 2018-01-19, removed 2017-08-15 (v0.83.0)
The latest
field in Docker config is deprecated in favor of the newer tag_templates
field.
dockers:
- image: foo/bar
latest: true
dockers:
- image: foo/bar
tag_templates:
- '{{ .Tag }}'
- latest