|
2 | 2 |
|
3 | 3 | ## Binaries
|
4 | 4 |
|
| 5 | +### 1.0.0-compat - 2017-03-21 |
| 6 | + |
| 7 | +**Upgrading from 0.3.8**: Numerous backwards incompatible changes: |
| 8 | + |
| 9 | + * Deprecated `nsqd` features removed: |
| 10 | + * Pre-V1 HTTP endpoints / response format: |
| 11 | + * `/{m,}put` (use `/{m,}pub`) |
| 12 | + * `/{create,delete,empty,pause,unpause}_{topic,channel}` (use `/{topic,channel}/<operation>`) |
| 13 | + * `--max-message-size` flag (use `--max-msg-size`) |
| 14 | + * `V2` protocol `IDENTIFY` command `short_id` and `long_id` properties (use `client_id`, `hostname`, and `user_agent`) |
| 15 | + * `/stats` HTTP response `name` property (use `client_id`) |
| 16 | + * Deprecated `nsqlookupd` features removed: |
| 17 | + * Pre-V1 HTTP endpoints / response format: |
| 18 | + * `/{create,delete}_{topic,channel}` (use `/{topic,channel}/<operation>`) |
| 19 | + * `/tombstone_topic_producer` (use `/topic/tombstone`) |
| 20 | + * Deprecated `nsqadmin` features removed: |
| 21 | + * `--template-dir` flag (not required, templates are compiled into binary) |
| 22 | + * `--use-statsd-prefixes` flag (use `--statsd-counter-format` and `--statsd-gauge-format`) |
| 23 | + * `nsq_stat` `--status-every` flag (use `--interval`) |
| 24 | + * `--reader-opt` on all binaries that had this flag (use `--consumer-opt`) |
| 25 | + * `nsq_to_file` `--gzip-compression` flag (use `--gzip-level`) |
| 26 | + * `nsq_to_http` `--http-timeout` and `--http-timeout-ms` flags (use `--http-connect-timeout` and `--http-request-timeout`) |
| 27 | + * `nsq_to_http` `--round-robin` flag (use `--mode=round-robin`) |
| 28 | + * `nsq_to_http` `--max-backoff-duration` flag (use `--consumer-opt=max_backoff_duration,X`) |
| 29 | + * `nsq_to_http` `--throttle-fraction` flag (use `--sample=X`) |
| 30 | + * `nsq_to_nsq` `--max-backoff-duration` flag (use `--consumer-opt=max_backoff_duration,X`) |
| 31 | + * `nsqd` `--worker-id` deprecated in favor of `--node-id` (to be fully removed in subsequent release) |
| 32 | + |
| 33 | +This is a compatibility release that drops a wide range of previously deprecated features (#367) |
| 34 | +while introducing some new deprecations (#844) that we intend to fully remove in a subsequent 1.0 |
| 35 | +release. |
| 36 | + |
| 37 | +Of note, all of the pre-1.0 HTTP endpoints (and response formats) are gone. Any clients or tools |
| 38 | +that use these endpoints/response formats won't work with this release. These changes have been |
| 39 | +available since 0.2.29 (released in July of 2014). Clients wishing to forwards-compatibly upgrade |
| 40 | +can either use the new endpoints or send the following header: |
| 41 | + |
| 42 | + Accept: application/vnd.nsq version=1.0 |
| 43 | + |
| 44 | +Also, many command line flags have been removed — in almost all cases an alternative is available |
| 45 | +with a (hopefully) more obvious name. These changes have the same affect on config file option |
| 46 | +names. |
| 47 | + |
| 48 | +On Linux, this release will automatically migrate `nsq.<worker-id>.dat` named metadata files to |
| 49 | +`nsq.dat` in a way that allows users to seamlessly _downgrade_ from this release back to 0.3.8, if |
| 50 | +necessary. A subsequent release will clean up these convenience symlinks and observe only |
| 51 | +`nsq.dat`. See the discussion in #741 and the changes #844 for more details. |
| 52 | + |
| 53 | +Performance wise, #741 landed which significantly reduces global contention on internal message ID |
| 54 | +generation, providing a ~1.75x speed improvement on multi-topic benchmarks. |
| 55 | + |
| 56 | +Finally, a number of minor issues were resolved spanning contributions from 9 community members! |
| 57 | +Thanks! |
| 58 | + |
| 59 | +Features: |
| 60 | + |
| 61 | + * #766 - use `alpine` base image for official Docker container (thanks @kenjones-cisco) |
| 62 | + * #775 - `nsqadmin:` `/config` API (thanks @kenjones-cisco) |
| 63 | + * #776 - `nsqadmin`, `nsq_stat`, `nsq_to_file`, `nsq_to_http`: HTTP client connect/request timeouts (thanks @kenjones-cisco) |
| 64 | + * #777/#778/#783/#785 - improve test coverage (thanks @kenjones-cisco) |
| 65 | + * #788 - `to_nsq`: add `--rate` message throttling option |
| 66 | + * #367 - purge deprecated features (see above) |
| 67 | + * #741 - `nsqd`: per-topic message IDs (multi-topic pub benchmarks up to ~1.75x faster) |
| 68 | + * #850 - `nsqd`, `nsqlookupd`, `nsqadmin`: add `--log-prefix` option (thanks @ploxiln) |
| 69 | + * #844 - `nsqd`: deprecate `--worker-id` for `--node-id` and drop ID from `nsqd.dat` file (thanks @ploxiln) |
| 70 | + |
| 71 | +Bugs: |
| 72 | + |
| 73 | + * #787 - `nsqlookupd`: properly close TCP connection in `IOLoop` (thanks @JackDrogon) |
| 74 | + * #792 - `nsqdmin`: fix root CA verification (thanks @joshuarubin) |
| 75 | + * #794 - `nsq_to_file`: require `--topic` or `--topic-pattern` (thanks @judwhite) |
| 76 | + * #816/#823 - `nsqadmin`: fix handling of IPv6 broadcast addresses (thanks @magnetised) |
| 77 | + * #805/#832 - `nsqd`: fix requeue and deferred message accounting (thanks @sdbaiguanghe) |
| 78 | + * #532/#830 - `nsqd`: switch to golang/snappy to fix snappy deadlock |
| 79 | + * #826/#831/#837/#839 - `nsqd`: fix default `--broadcast-address` and error when `nsqlookupd` reqs fail (thanks @ploxiln @stephensearles) |
| 80 | + * #822/#835 - `nsqd`: prevent panic in binary `/mpub` (thanks @yangyifeng01) |
| 81 | + * #841 - `nsqadmin`: allow ctrl/meta+click to open a new tab |
| 82 | + * #843 - `nsqd`: check for exit before requeing |
| 83 | + |
5 | 84 | ### 0.3.8 - 2016-05-26
|
6 | 85 |
|
7 | 86 | **Upgrading from 0.3.7**: Binaries contain no backwards incompatible changes.
|
|
0 commit comments