github.com/fitzix/goreleaser@v0.92.0/www/content/deprecations.md (about)

     1  ---
     2  title: Deprecation notices
     3  menu: true
     4  weight: 500
     5  hideFromIndex: true
     6  ---
     7  
     8  This page will be used to list deprecation notices accross GoReleaser.
     9  
    10  Deprecate code will be removed after ~6 months from the time it was deprecated.
    11  
    12  # Active deprecation notices
    13  
    14  ## docker.image
    15  
    16  > since 2018-10-20
    17  
    18  This property was deprecated in favor of more flexible `image_templates`.
    19  The idea is to be able to define several images and tags using templates instead of just one image with tag templates.
    20  This flexibility allows images to be pushed to multiple registries.
    21  
    22  Change this:
    23  
    24  ```yaml
    25  dockers:
    26  - image: foo/bar
    27    tag_templates:
    28      - '{{ .Tag }}'
    29  ```
    30  
    31  to this:
    32  
    33  ```yaml
    34  dockers:
    35  - image_templates:
    36      - 'foo/bar:{{ .Tag }}'
    37  ```
    38  
    39  ## docker.tag_templates
    40  
    41  > since 2018-10-20
    42  
    43  This property was deprecated in favor of more flexible `image_templates`.
    44  The idea is to be able to define several images and tags using templates instead of just one image with tag templates.
    45  
    46  Change this:
    47  
    48  ```yaml
    49  dockers:
    50  - image: foo/bar
    51    tag_templates:
    52      - '{{ .Tag }}'
    53  ```
    54  
    55  to this:
    56  
    57  ```yaml
    58  dockers:
    59  - image_templates:
    60      - 'foo/bar:{{ .Tag }}'
    61  ```
    62  
    63  
    64  <!--
    65  
    66  Template for new deprecations:
    67  
    68  ## property
    69  
    70  > since yyyy-mm-dd
    71  
    72  Description.
    73  
    74  Change this:
    75  
    76  ```yaml
    77  ```
    78  
    79  to this:
    80  
    81  ```yaml
    82  ```
    83  
    84   -->
    85  
    86  ## git.short_hash
    87  
    88  > since 2018-10-03
    89  
    90  This property was being used to tell GoReleaser to use short git hashes
    91  instead of the full ones. This has been removed in favor of specific
    92  template variables (`.FullCommit` and `.ShortCommit`).
    93  
    94  Change this:
    95  
    96  ```yaml
    97  git:
    98    short_hash: true
    99  
   100  fake:
   101    foo_template: 'blah {{ .Commit }}'
   102  ```
   103  
   104  to this:
   105  
   106  ```yaml
   107  fake:
   108    foo_template: 'blah {{ .ShortCommit }}'
   109  ```
   110  
   111  # Expired deprecation notices
   112  
   113  The following options were deprecated for ~6 months and are now unsupported.
   114  
   115  ## fpm
   116  
   117  > since 2018-02-17
   118  >
   119  > removed 2017-08-15
   120  
   121  FPM is deprecated in favor of nfpm, which is a simpler alternative written
   122  in Go. The objective is to remove the ruby dependency thus simplify the
   123  CI/CD pipelines.
   124  
   125  Just replace the `fpm` keyword by `nfpm` in your `goreleaser.yaml` file.
   126  
   127  Change this:
   128  
   129  ```yaml
   130  fpm:
   131    # ...
   132  ```
   133  
   134  to this:
   135  
   136  ```yaml
   137  nfpm:
   138    # ...
   139  ```
   140  
   141  ## docker.tag_template
   142  
   143  > since 2018-01-19
   144  >
   145  > removed 2017-08-15
   146  
   147  This property was deprecated in favor of the pluralized `tag_templates`.
   148  The idea is to be able to define several tags instead of just one.
   149  
   150  Change this:
   151  
   152  ```yaml
   153  dockers:
   154  - image: foo/bar
   155    tag_template: '{{ .Tag }}'
   156  ```
   157  
   158  to this:
   159  
   160  ```yaml
   161  dockers:
   162  - image: foo/bar
   163    tag_templates:
   164      - '{{ .Tag }}'
   165  ```
   166  
   167  ## docker.latest
   168  
   169  > since 2018-01-19
   170  >
   171  > removed 2017-08-15
   172  
   173  The `latest` field in Docker config is deprecated in favor of the newer
   174  `tag_templates` field.
   175  
   176  Change this:
   177  
   178  ```yaml
   179  dockers:
   180  - image: foo/bar
   181    latest: true
   182  ```
   183  
   184  to this:
   185  
   186  ```yaml
   187  dockers:
   188  - image: foo/bar
   189    tag_templates:
   190      - '{{ .Tag }}'
   191      - latest
   192  ```