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 ```