Release Channel
Introduction
Release channels in our platform provide users with the flexibility to choose between two main update streams: LTS (Long-Term Support) and Rapid. The LTS channel focuses on stability and long-term support, making it ideal for production environments that require minimal disruption. On the other hand, the Rapid channel offers access to the latest features and improvements at a faster pace, suitable for users who prioritize innovation and can adapt to frequent updates. This document aims to clarify the differences between these channels, helping users make informed decisions based on their specific requirements and use cases.
Release Channel Overview
Release Channel | Current version in channel |
---|---|
Rapid channel | 3.3.1.3 |
LTS channel | 3.0.6.4 |
LTS (Long-Term Support) Channel
- LTS releases prioritize stability and long-term API consistency.
- New features are introduced on a slower cadence.
- Non-GA (Generally Available) features are not accessible in LTS releases.
- LTS releases are recommended for production workloads and environments requiring stability and minimal disruption.
Rapid Channel
- Rapid releases offer access to the latest features and improvements at a faster pace.
- New features are introduced approximately every three months.
- Users can access features in Private Preview or Public Preview through controlled flags.
- Rapid releases are suitable for users who prioritize innovation, are willing to adapt to frequent updates, and can accommodate potential changes in features and APIs.
Channel limitation
- LTS channel clusters can’t access to the Private Preview or Public Preview features.
- There is a temporary restriction that the release channel cannot be changed after the cluster deployment. If you want to upgrade a cluster to a different release channel, please reach out to the StreamNative support team.
Choose the release channel
In the cluster provision process, there is a new step for selecting the release channel:
After cluster provision, you can view the current enrolled channel through the Configuration tab on the Pulsar Clusters page:
In the cluster provision process, there is a new step for selecting the release channel:
After cluster provision, you can view the current enrolled channel through the Configuration tab on the Pulsar Clusters page:
To specify the release channel when creating a Pulsar cluster using snctl
, you can use the --release-channel
flag. Here’s how to do it:
-
Create a new Pulsar cluster with a specific release channel:
Replace
<cluster-name>
with your desired cluster name and<channel>
with eitherlts
orrapid
.For example, to create a cluster named “my-cluster” using the LTS channel:
-
View the release channel of an existing cluster:
Look for the
releaseChannel
field in the output: -
If you need to update the release channel of an existing cluster, you can use the
patch
command:Note: As mentioned in the channel limitation section, changing the release channel after deployment is currently restricted. Please contact StreamNative support if you need to change the release channel of an existing cluster.
Remember that the releaseChannel
field in the PulsarCluster spec determines which channel the cluster will use for updates. The available options are lts
for the Long-Term Support channel and rapid
for the Rapid channel.
Alternatively, you can also include the release channel in the PulsarCluster custom resource YAML file when creating a new cluster:
To specify the release channel when creating a cluster using StreamNative Terraform Provider, you can use the release_channel
field in the streamnative_pulsar_cluster
resource. Here’s an example of how to structure the resource:
For more details about how to create a cluster using StreamNative Terraform Provider, see create a pulsar cluster. You can also find more examples in the StreamNative Terraform Provider GitHub repository.
Key Considerations
Stability
- Both LTS and Rapid channels provide stable releases.
- Stability is not compromised in either channel; the primary difference lies in the frequency of feature updates.
Feature Availability
- LTS: Prioritizes stability over feature availability, with new features introduced on a yearly basis.
- Rapid: Offers the latest features and improvements every three months, allowing users to access cutting-edge functionalities.
Support
- Both LTS and Rapid channels receive support.
- Users can expect assistance and maintenance regardless of the chosen release channel.
Compatibility
- Rapid releases eventually transition into LTS releases, ensuring compatibility and forward version upgradeability.
- Users need to consider compatibility when selecting the appropriate release channel, especially for long-term projects and deployments.
Recommendations
- Active Development Projects: The Rapid release channel is recommended for projects that are actively evolving and require access to the latest features and improvements.
- Stable Environments: The LTS release channel is suitable for stable environments and production workloads where long-term stability and minimal disruption are paramount.
Best Practices
- Clear Channel Mapping: Ensure a clear mapping of clusters to different release channels, especially in environments with multiple Pulsar clusters.
- Communication and Training: Educate users about the implications of choosing between LTS and Rapid channels, including potential impacts on development workflows, feature availability, and long-term support.
- Continuous Integration and Deployment (CI/CD): Incorporate release channel selection into CI/CD pipelines to ensure alignment with project requirements and compatibility considerations.
Conclusion
Understanding the differences between LTS and Rapid release channels is essential for making informed decisions regarding software updates and maintenance. By aligning channel selection with project requirements and considering factors such as stability, feature availability, and compatibility, users can optimize their experience with our platform and maximize the value derived from new features and improvements.