Skip to content

1.0.0-compat
Compare
Choose a tag to compare
@mreiferson mreiferson released this 22 Mar 19:58
· 520 commits to master since this release
v1.0.0-compat
c22751c

Upgrading from 0.3.8: Numerous backwards incompatible changes:

  • Deprecated nsqd features removed:
    • Pre-V1 HTTP endpoints / response format:
      • /{m,}put (use /{m,}pub)
      • /{create,delete,empty,pause,unpause}_{topic,channel} (use /{topic,channel}/<operation>)
    • --max-message-size flag (use --max-msg-size)
    • V2 protocol IDENTIFY command short_id and long_id properties (use client_id, hostname, and user_agent)
    • /stats HTTP response name property (use client_id)
  • Deprecated nsqlookupd features removed:
    • Pre-V1 HTTP endpoints / response format:
      • /{create,delete}_{topic,channel} (use /{topic,channel}/<operation>)
      • /tombstone_topic_producer (use /topic/tombstone)
  • Deprecated nsqadmin features removed:
    • --template-dir flag (not required, templates are compiled into binary)
    • --use-statsd-prefixes flag (use --statsd-counter-format and --statsd-gauge-format)
  • nsq_stat --status-every flag (use --interval)
  • --reader-opt on all binaries that had this flag (use --consumer-opt)
  • nsq_to_file --gzip-compression flag (use --gzip-level)
  • nsq_to_http --http-timeout and --http-timeout-ms flags (use --http-connect-timeout and --http-request-timeout)
  • nsq_to_http --round-robin flag (use --mode=round-robin)
  • nsq_to_http --max-backoff-duration flag (use --consumer-opt=max_backoff_duration,X)
  • nsq_to_http --throttle-fraction flag (use --sample=X)
  • nsq_to_nsq --max-backoff-duration flag (use --consumer-opt=max_backoff_duration,X)
  • nsqd --worker-id deprecated in favor of --node-id (to be fully removed in subsequent release)

This is a compatibility release that drops a wide range of previously deprecated features (#367) while introducing some new deprecations (#844) that we intend to fully remove in a subsequent 1.0 release.

Of note, all of the pre-1.0 HTTP endpoints (and response formats) are gone. Any clients or tools that use these endpoints/response formats won't work with this release. These changes have been available since 0.2.29 (released in July of 2014). Clients wishing to forwards-compatibly upgrade can either use the new endpoints or send the following header:

Accept: application/vnd.nsq version=1.0

Also, many command line flags have been removed — in almost all cases an alternative is available with a (hopefully) more obvious name. These changes have the same affect on config file option names.

On Linux, this release will automatically migrate nsq.<worker-id>.dat named metadata files to nsq.dat in a way that allows users to seamlessly downgrade from this release back to 0.3.8, if necessary. A subsequent release will clean up these convenience symlinks and observe only nsq.dat. See the discussion in #741 and the changes #844 for more details.

Performance wise, #741 landed which significantly reduces global contention on internal message ID generation, providing a ~1.75x speed improvement on multi-topic benchmarks.

Finally, a number of minor issues were resolved spanning contributions from 9 community members! Thanks!

Features:

  • #766 - use alpine base image for official Docker container (thanks @kenjones-cisco)
  • #775 - nsqadmin: /config API (thanks @kenjones-cisco)
  • #776 - nsqadmin, nsq_stat, nsq_to_file, nsq_to_http: HTTP client connect/request timeouts (thanks @kenjones-cisco)
  • #777/#778/#783/#785 - improve test coverage (thanks @kenjones-cisco)
  • #788 - to_nsq: add --rate message throttling option
  • #367 - purge deprecated features (see above)
  • #741 - nsqd: per-topic message IDs (multi-topic pub benchmarks up to ~1.75x faster)
  • #850 - nsqd, nsqlookupd, nsqadmin: add --log-prefix option (thanks @ploxiln)
  • #844 - nsqd: deprecate --worker-id for --node-id and drop ID from nsqd.dat file (thanks @ploxiln)

Bugs:

Assets 6
Loading