-
Language:
English
-
Language:
English
AMQ Streams 1.2 on OpenShift Container Platform Release Notes
Release Notes for AMQ Streams 1.2
Abstract
Chapter 1. Features
The features added in this release, and that were not in previous releases of AMQ Streams, are outlined below.
1.1. Kafka 2.2.1 support
AMQ Streams now supports Kafka 2.2.1.
You must upgrade the Cluster Operator to 1.2 before you can upgrade to Kafka 2.2.1. For instructions, see AMQ Streams and Kafka upgrades.
After you have performed an upgrade, custom resources that use kafka.strimzi.io/v1alpha1 must be updated as the API version is deprecated.
Refer to the Kafka 2.2.0 and Kafka 2.2.1 Release Notes for additional information.
Kafka 2.1.x is supported only for upgrade purposes.
1.2. OpenShift Container Platform 3.11 and 4.x support
As a requirement for the new features, AMQ Streams now supports OpenShift Container Platform 3.11 and 4.x.
OpenShift Container Platform 3.9 and 3.10 is no longer supported.
AMQ Streams can be installed on OpenShift 4.x:
- Manually using AMQ Streams YAML files
- Through the OpenShift Container Platform Operator Hub
1.3. Custom Resource Definition (CRD) versions
The YAML files describing the CRDs provided with AMQ Streams now support multiple versions. The change means that there is now support for a schema specific to an API version.
See Custom resources
1.4. Add or remove volumes from JBOD storage
It is now possible to add or remove volumes from JBOD storage to respond to new requirements for storing data. To make the change, the volumes spec for the Kafka resource is edited and updated. Following the update, new topics can be assigned to the disks or existing partitions can be reassigned.
1.5. Resize persistent volumes
To respond to an increased demand for storage, you can now increase the size of the persistent volumes used for the storage of messages and logs in an existing AMQ Streams cluster.
A persistent volume can be resized if:
- Your OpenShift cluster supports persistent volume resizing.
- The persistent volume was created by using a storage class that supports volume expansion.
Persistent volume size is defined in the size field in the spec.kafka.storage and spec.zookeeper.storage properties:
apiVersion: kafka.strimzi.io/v1beta1
kind: Kafka
metadata:
name: my-cluster
spec:
kafka:
# ...
storage:
type: persistent-claim
size: 2000Gi
class: my-storage-class
# ...
zookeeper:
# ...Chapter 2. Enhancements
The enhancements made to AMQ Streams 1.2.
2.1. Container images
This release includes the following changes to the management of container images for AMQ Streams on OpenShift.
2.1.1. New image registry
All AMQ Streams container images are now hosted on the new Red Hat Registry, registry.redhat.io. Unlike registry.access.redhat.com, the new registry requires authentication for access to container images.
Your OpenShift installation should be already connected and authenticated against the new registry. If it is not authenticated, you can configure your installation according to the OpenShift version:
- If using OpenShift 3.11, see Creating Service Accounts and Authentication Tokens for the Red Hat Registry.
- If using OpenShift 4.1, see Authentication enabled Red Hat registry.
Alternatively, you can create your own OpenShift Secret with the registry credentials, and configure AMQ Streams to use it in the STRIMZI_IMAGE_PULL_SECRETS environment variable in the Cluster Operator configuration or through the imagePullSecrets property in the template of your custom resource.
Additional resources
2.1.2. Reduced number of images
The number of container images for AMQ Streams has been significantly reduced. Four container images are now provided:
| AMQ Streams Component | Container Image |
|---|---|
| Cluster Operator |
|
| Kafka version 2.1 |
|
| Kafka version 2.2 |
|
| AMQ Streams Kafka Bridge (Tech Preview) |
|
Previous releases of AMQ Streams provided separate images, for example, for Kafka Connect. These images have been incorporated into the Cluster Operator and Kafka images.
This release includes a new image for the AMQ Streams Kafka Bridge (as a Technology Preview).
| Image | Incorporates |
|---|---|
| amq-streams-operator |
|
| amq-streams-kafka-2.1 |
|
| amq-streams-kafka-2.2 |
|
| amq-streams-kafka-bridge | New image |
You can access the AMQ Streams container images in the Red Hat Container Catalog.
Chapter 3. Technology previews
Technology Preview features are not supported with Red Hat production service-level agreements (SLAs) and might not be functionally complete; therefore, Red Hat does not recommend implementing any Technology Preview features in production environments. This Technology Preview feature provides early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process. For more information about support scope, see Technology Preview Features Support Scope.
3.1. AMQ Streams Kafka Bridge
The AMQ Streams Kafka Bridge provides a RESTful interface to AMQ Streams, offering the advantages of a web API that is easy to use and connect with AMQ Streams without the need to interpret the Kafka protocol.
The HTTP Bridge supports HTTP producer and consumer requests to:
- Produce records
- Consume records
- Create consumers
- Delete consumers
- Retrieve data from topics and partitions
- Commit offsets to partitions and topics
The methods provide JSON responses and HTTP response code error handling.
AMQP is not currently supported, even for Technology Preview.
3.2. Status property for a custom resource
The new status property for a AMQ Streams-specific custom resource publishes the current state of the resource to users and tools that need the information.
Chapter 4. Deprecated features
The features deprecated in this release, and that were supported in previous releases of AMQ Streams, are outlined below.
4.1. API version v1alpha1
API version v1alpha1 has been deprecated for this release of AMQ Streams.
Custom resources that use kafka.strimzi.io/v1alpha1 must be updated to use kafka.strimzi.io/v1beta1.
Chapter 5. Fixed issues
The following table lists the issues fixed in AMQ Streams 1.2.
| Issue Number | Description |
|---|---|
| KubernetesClientException when upgrading Strimzi from 0.11.4 to 0.12.0-rc1 | |
| Fix problem with 0 validity in UO when custom CA is used | |
| Auto-generated passwords starting with digit prevent the password from being tokenized | |
| TO loop receiving MODIFIED events and creating znodes | |
| ClusterOperator not honouring jvmOptions for Kafkamirror CR | |
| User external listener overrides without specifying node ports triggers NPE and breaks reconciliation | |
| Parsing or memory limits and requests is failing for some numbers | |
| An error during deploying Kafka cluster in another namespace than CO | |
| ZK rolling update throws strange errors in case of disaster during rolling update | |
| Make sure Kafka pods can do things such as rebuilding indexes at startup | |
| Storage type changes not handled properly when accompanied with other changes | |
| Cluster Operator fails to start — can’t parse certificate | |
| Unhandled exception during scale down zookeeper instances |
Chapter 6. Known issues
There are no known issues for AMQ Streams 1.2.
Chapter 7. Important links
Revised on 2019-07-15 15:33:03 UTC
