Upgrading Confluent.Kafka 0.11 to 1

Breaking0.11.6 → 1.9.3Breaking25Security4Deprecated3New43Changed47Fixed27Other4

Full comparison Back to Confluent.Kafka

Fetching 96 releases from GitHub…88 / 96

SecurityUpgrades Newtonsoft.Json to 13.0.1 to address a security vulnerability in 9.0.1.Advisory ↗

BreakingUpgrade verdict

25 breaking changes and 4 security fixes.

In plain terms

Projects targeting .NET Framework 4.5.2 can no longer use the Schema Registry packages.
Code calling the callback-based ProduceAsync overloads must switch to Produce.
End-of-partition notices arrive through ConsumeResult and are off unless you turn them on.
The Avro package has a new name; update your package references and namespaces.

Must act Top 5 of 32 that need code or config changes

Target frameworks requirement changed in 1.9.2-RC2: .NETFramework4.5, .NETFramework4.6, .NETStandard1.3 → .NETFramework4.6.2, .NETStandard1.3, .NETStandard2.0, net6.0.

What you must change

Breaking25

Removes net452 as a target framework of Confluent.SchemaRegistry and Confluent.SchemaRegistry.Serdes due to the official Apache Avro package targeting only netstandard2.0.

Confluent.SchemaRegistryConfluent.SchemaRegistry.Serdesnet452netstandard2.0

1.4.0GitHub ReleaseSummarizedView source

Renames ProduceAsync variants with a callback to Produce.

ProduceAsyncProduce

1.0.0GitHub ReleaseSummarizedView source

PartitionEOF notification is now via ConsumeResult, not events, and is disabled by default.

ConsumeResult

1.0.0GitHub ReleaseSummarizedView source

Renames Confluent.Kafka.Avro to Confluent.SchemaRegistry.Serdes in preparation for additional serialization formats.

Confluent.Kafka.AvroConfluent.SchemaRegistry.Serdes

1.0.0GitHub ReleaseSummarizedView source

Renames AsyncAvroSerializer to AvroSerializer and AsyncAvroDeserializer to AvroDeserializer.

AsyncAvroSerializerAvroSerializerAsyncAvroDeserializerAvroDeserializer

1.0.0-RC7GitHub ReleaseSummarizedView source

Renames AvroSerializer to AsyncAvroSerializer and AvroDeserializer to AsyncAvroDeserializer.

AvroSerializerAsyncAvroSerializerAvroDeserializerAsyncAvroDeserializer

1.0.0-RC6CHANGELOG.mdSummarizedView source

Removes IAsyncDeserializer setter overloads from the ConsumerBuilder class.

IAsyncDeserializerConsumerBuilder

1.0.0-RC6CHANGELOG.mdSummarizedView source

Renames Producer.BeginProduce to Producer.Produce.

Producer.BeginProduceProducer.Produce

1.0.0-RC6CHANGELOG.mdSummarizedView source

Removes SerializationContext from non-async serde interfaces.

SerializationContext

1.0.0-RC4CHANGELOG.mdSummarizedView source

Removes the Confluent.Kafka.Serdes namespace.

Confluent.Kafka.Serdes

1.0.0-RC3CHANGELOG.mdSummarizedView source

Renames the Message.PersistenceStatus property to Message.Status.

Message.PersistenceStatusMessage.Status

1.0.0-RC1CHANGELOG.mdSummarizedView source

Removes unused CancellationToken parameters, to be added back when implemented.

CancellationToken

1.0.0-RC1CHANGELOG.mdSummarizedView source

Updates Protobuf serdes message framing to match Java (zigzag message indices); set UseDeprecatedFormat to true to disable.

ProtobufSerializerProtobufDeserializerUseDeprecatedFormat

1.8.0GitHub ReleaseSummarizedView source

The 1.0 API is not compatible with earlier versions of the library.

1.0.0GitHub ReleaseSummarizedView source

Construction is now via builder classes, which require event handlers to be specified at construction time.

1.0.0GitHub ReleaseSummarizedView source

Moves ListGroups and GetMetadata methods from the Producer and Consumer classes to AdminClient.

ListGroupsGetMetadataAdminClient

1.0.0GitHub ReleaseSummarizedView source

Moves SyncOverAsync functionality to the Confluent.Kafka.SyncOverAsync namespace.

Confluent.Kafka.SyncOverAsync

1.0.0-RC7GitHub ReleaseSummarizedView source

Replaces ISerializer interface with Serializer delegate.

ISerializerSerializer

1.0.0-RC4CHANGELOG.mdSummarizedView source

Replaces IDeserializer interface with Deserializer delegate.

IDeserializerDeserializer

1.0.0-RC4CHANGELOG.mdSummarizedView source

Replaces SetRebalanceHandler with SetPartitionsAssignedHandler and SetPartitionsRevokedHandler.

SetRebalanceHandlerSetPartitionsAssignedHandlerSetPartitionsRevokedHandler

1.0.0-RC1CHANGELOG.mdSummarizedView source

Prohibits calling Assign or Unassign inside the rebalance handlers.

AssignUnassign

1.0.0-RC1CHANGELOG.mdSummarizedView source

Moves GetWatermarkOffsets and QueryWatermarkOffsets from the admin client to the consumer.

GetWatermarkOffsetsQueryWatermarkOffsets

1.0.0-RC1CHANGELOG.mdSummarizedView source

Provides context to serdes via a SerializationContext class instance.

SerializationContext

1.0.0-RC1CHANGELOG.mdSummarizedView source

Builder classes now return interfaces instead of concrete classes.

1.0.0-RC1CHANGELOG.mdSummarizedView source

Makes the AdminClient, Producer, and Consumer classes internal.

AdminClientProducerConsumer

1.0.0-RC6CHANGELOG.mdSummarizedView source

Security4

Upgrades Newtonsoft.Json to 13.0.1 to address a security vulnerability in 9.0.1.

Newtonsoft.Json

1.9.2GitHub ReleaseSummarizedView source

Upgrades Google.Protobuf dependency to 3.15.0 to address CVE-2021-22570.

Google.Protobuf

1.9.0GitHub ReleaseSummarizedView source

Upgrades bundled zlib from 1.2.8 to 1.2.11 in librdkafka.redist, fixing CVE-2016-9840 through CVE-2016-9843.

1.8.0GitHub ReleaseSummarizedView source

Updates the System.Net.Http dependency to v4.3.4 to address CVE-2018-8292.

System.Net.Http

1.7.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated3

Marks ConsumeResult properties that delegate to ConsumeResult.Message properties as obsolete.

ConsumeResultConsumeResult.Message

1.4.0GitHub ReleaseSummarizedView source

Deprecates SchemaRegistryConfig properties with the superfluous SchemaRegistry prefix and adds corresponding unprefixed properties.

SchemaRegistryConfig

1.3.0GitHub ReleaseSummarizedView source

Marks DependentProducerBuilder as API-SUBJECT-TO-CHANGE.

DependentProducerBuilder

1.0.0-RC7GitHub ReleaseSummarizedView source