goreleaser/www/content/deprecations.md

title	menu	weight	hideFromIndex
Deprecation notices	true	500	true

This page will be used to list deprecation notices across GoReleaser.

Deprecate code will be removed after ~6 months from the time it was deprecated.

Active deprecation notices

sign

since 2019-07-20

Sign was deprecated in favor of its plural form.

Change this:

sign:
  # etc

to this:

signs:
  -
    # etc

brew

since 2019-06-09

Brew was deprecated in favor of its plural form.

Change this:

brew:
  # etc

to this:

brews:
  -
    # etc

s3

since 2019-06-09

S3 was deprecated in favor of the new blob, which supports S3, Azure Blob and GCS.

Change this:

s3:
-
  # etc

to this:

blob:
-
  provider: s3
  # etc

snapcraft

since 2019-05-39

We now allow multiple Snapcraft configs, so the snapcraft statement will be removed.

Change this:

snapcraft:
  publish: true
  # ...

to this:

snapcrafts:
  -
    publish: true
    # ...

nfpm

since 2019-05-07

We now allow multiple NFPM config, so the nfpm statement will be removed.

Change this:

nfpm:
  formats:
    - deb

to this:

nfpms:
  -
    formats:
      - deb

archive

since 2019-04-16

We now allow multiple archives, so the archive statement will be removed.

Change this:

archive:
  format: zip

to this:

archives:
  - id: foo
    format: zip

docker.binary

since 2018-10-01

You can now create a Docker image with multiple binaries.

Change this:

dockers:
- image: foo/bar
  binary: foo

to this:

dockers:
- image: foo/bar
  binaries:
  - foo

docker.image

since 2018-10-20

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.

Change this:

dockers:
- image: foo/bar
  tag_templates:
    - '{{ .Tag }}'

to this:

dockers:
- image_templates:
    - 'foo/bar:{{ .Tag }}'

docker.tag_templates

since 2018-10-20

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.

Change this:

dockers:
- image: foo/bar
  tag_templates:
    - '{{ .Tag }}'

to this:

dockers:
- image_templates:
    - 'foo/bar:{{ .Tag }}'

Expired deprecation notices

The following options were deprecated for ~6 months and are now fully removed.

git.short_hash

since 2018-10-03, removed 2019-01-19

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).

Change this:

git:
  short_hash: true

fake:
  foo_template: 'blah {{ .Commit }}'

to this:

fake:
  foo_template: 'blah {{ .ShortCommit }}'

fpm

since 2018-02-17, removed 2017-08-15

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.yaml file.

Change this:

fpm:
  # ...

to this:

nfpm:
  # ...

docker.tag_template

since 2018-01-19, removed 2017-08-15

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.

Change this:

dockers:
- image: foo/bar
  tag_template: '{{ .Tag }}'

to this:

dockers:
- image: foo/bar
  tag_templates:
    - '{{ .Tag }}'

docker.latest

since 2018-01-19, removed 2017-08-15

The latest field in Docker config is deprecated in favor of the newer tag_templates field.

Change this:

dockers:
- image: foo/bar
  latest: true

to this:

dockers:
- image: foo/bar
  tag_templates:
    - '{{ .Tag }}'
    - latest