EMQX Operator 2.3.0-rc.1

EMQX Operator 2.3.0 RC1

‼️ This is a pre-release.

Highlights

• EMQX Custom Resource Definition (CRD) has been refined and promoted to apps.emqx.io/v2. (#1148, #1160)
  • EMQX 5.9, 5.10 and 6.x releases are now exclusively supported. (#1152)
  • CRD apps.emqx.io/v2beta1 is now deprecated, earlier versions are no longer supported.
• Operator now supports EMQX Durable Storage maintenance and automatic rebalancing. (#1128, #1152)
• Configuration specified in EMQX CR is now mapped to base.hocon file for predictable configuration management. (#1156)
• EMQX Controller has been simplified and optimized for better performance and reliability. (#1150)
  • Controller does not include any webhooks now, and there's no dependency on cert-manager anymore.

Fixes & Improvements

• Corrected an issue where ownerRef could be lost during resource updates. (#1163)
• Ensured that configuration changes are now applied consistently. (#1157)
• Operator now correctly handles scaling down pods that are not associated with a node. (#1158)

Internal

• Added a new end-to-end test suite for release upgrades. (#1155)
• Added a CodeQL workflow for security analysis. (#1153)
• Increased test coverage.

Please refer to README.md for further details.

EMQX Operator 2.2.29 Released

Release Note 🍻

EMQX Operator 2.2.29 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Fix 🐞

• Fix the issue that the replicas of the statefulSet is not current when the emqx CR is updated

• Correct TopologySpreadConstraints reference in generateReplicaSet function

Chore 🏗

• Helm chart

  • Make webhook into namespace scope when singleNamespace=true @

  • Remove wrong usage of imagePullSecrets

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.29
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• fix: change scale down strategy when blue green update by @Rory-Z in #1108
• make webhook into namespace scope when singleNamespace=true by @phosae in #1116
• helm chart README: fix typo by @phosae in #1114
• Helm Chart: Remove wrong image pull usage in SA by @K4iM4k3r in #1119
• fix: correct TopologySpreadConstraints reference in generateReplicaSet by @bluicezhen in #1122
• docs: use consistent docker image tag by @id in #1127
• chore(rbac): add patch permission for event by @Rory-Z in #1133
• fix(blue-green update): fix set sts replicas less than 0 by @Rory-Z in #1132

New Contributors

• @phosae made their first contribution in #1116
• @K4iM4k3r made their first contribution in #1119
• @bluicezhen made their first contribution in #1122

Full Changelog: 2.2.28...2.2.29

EMQX Operator 2.2.29-beta.2 Released

Release Note 🍻

EMQX Operator 2.2.29-beta.2 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Fix 🐞

• Fix the issue that the replicas of the statefulSet is not current when the emqx CR is updated

• Correct TopologySpreadConstraints reference in generateReplicaSet function

Chore 🏗

• Helm chart

  • Make webhook into namespace scope when singleNamespace=true @

  • Remove wrong usage of imagePullSecrets

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.29-beta.2
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• make webhook into namespace scope when singleNamespace=true by @phosae in #1116
• helm chart README: fix typo by @phosae in #1114
• Helm Chart: Remove wrong image pull usage in SA by @K4iM4k3r in #1119
• fix: correct TopologySpreadConstraints reference in generateReplicaSet by @bluicezhen in #1122
• docs: use consistent docker image tag by @id in #1127
• chore(rbac): add patch permission for event by @Rory-Z in #1133
• fix(blue-green update): fix set sts replicas less than 0 by @Rory-Z in #1132

New Contributors

• @phosae made their first contribution in #1116
• @K4iM4k3r made their first contribution in #1119
• @bluicezhen made their first contribution in #1122

Full Changelog: 2.2.29-beta.1...2.2.29-beta.2

EMQX Operator 2.2.29-beta.1 Released

Release Note 🍻

EMQX Operator 2.2.29-beta.1 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Fix 🐞

• Fix the issue that the replicas of the statefulSet is not current when the emqx CR is updated

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.29-beta.1
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• fix: change scale down strategy when blue green update by @Rory-Z in #1108

Full Changelog: 2.2.28...2.2.29-beta.1

EMQX Operator 2.2.28 Released

Release Note 🍻

EMQX Operator 2.2.28 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Fixes 🛠

• Fix the Helm template formatting issue, thanks to Rouke Broersma for their contribution in PR#1102

Enhancements 🚀

• Better documents

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.28
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• update docs by @id in #1106
• fix: Indent ENABLE_WEBHOOKS env variable under container by @rouke-broersma in #1102
• docs(CRD): change volumeClaimTemplates describe by @Rory-Z in #1107

New Contributors

• @id made their first contribution in #1106

Full Changelog: 2.2.27...2.2.28

EMQX Operator 2.2.27 Released

Release Note 🍻

EMQX Operator 2.2.27 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Enhancements 🚀

• EMQX operator helm chart can support the podSecurityContext and containerSecurityContext configuration, which can be used to configure the security context of the operator pod.

• EMQX operator helm chart can disable web hooks by webhook.enabled: false in the values.yaml file, it will disable the web hooks of the operator, if you have any apps.emqx.io/v2alpha1 or apps.emqx.io/v1beta3 resources, please make sure the web hooks are enabled, otherwise the resources can not convert to the apps.emqx.io/v2beta1 and apps.emqx.io/v1beta4 resources.

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.27
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• chore: add CRDs file to release assets by @Rory-Z in #1099
• chore: add security context for helm by @Rory-Z in #1100
• chore: can disable webhook in helm by @Rory-Z in #1101

Full Changelog: 2.2.26...2.2.27

EMQX Operator 2.2.26 Released

Release Note 🍻

EMQX Operator 2.2.26 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Enhancements 🚀

• apps.emqx.io/v2beta1 EMQX.

  • Users can now configure the Pod Disruption Budget (PDB) for the EMQX cluster by setting minAvailable or maxUnavailable in spec.coreTemplate.spec or spec.replicantTemplate.spec within the EMQX CRD. The default setting is {"minAvailable": 1}.

• EMQX operator can now be deployed in a single namespace scope, where it will only manage resources within that namespace. Just set singleNamespace: true in the values.yaml file of Helm chart, and then the operator will only manage resources in the namespace where it is deployed.

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.26
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• ci: change args for install cert-manager by @Rory-Z in #1080
• chore: fix status field name error by @Rory-Z in #1082
• docs: add new document for hello operator by @Rory-Z in #1079
• docs: update huaweicloud link by @Rory-Z in #1085
• feat(deploy): support single namespace by @Rory-Z in #1091
• feat: user can set PDB by himself by @Rory-Z in #1093
• fix(pdb): fix PDB can not update by @Rory-Z in #1095
• chore: delete default value of minAvailable by @Rory-Z in #1096

Full Changelog: 2.2.25...2.2.26

EMQX Operator 2.2.26-rc.2 Released

Release Note 🍻

EMQX Operator 2.2.26-rc.2 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Enhancements 🚀

• apps.emqx.io/v2beta1 EMQX.

  • Users can now configure the Pod Disruption Budget (PDB) for the EMQX cluster by setting minAvailable or maxUnavailable in spec.coreTemplate.spec or spec.replicantTemplate.spec within the EMQX CRD. The default setting is {"minAvailable": 1}.

• EMQX operator can now be deployed in a single namespace scope, where it will only manage resources within that namespace. Just set singleNamespace: true in the values.yaml file of Helm chart, and then the operator will only manage resources in the namespace where it is deployed.

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.26-rc.2
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• feat: user can set PDB by himself by @Rory-Z in #1093
• fix(pdb): fix PDB can not update by @Rory-Z in #1095
• chore: delete default value of minAvailable by @Rory-Z in #1096

Full Changelog: 2.2.26-rc.1...2.2.26-rc.2

EMQX Operator 2.2.26-rc.1 Released

Release Note 🍻

EMQX Operator 2.2.26-rc.1 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Enhancements 🚀

• EMQX operator can now be deployed in a single namespace scope, where it will only manage resources within that namespace. Just set singleNamespace: true in the values.yaml file of Helm chart, and then the operator will only manage resources in the namespace where it is deployed.

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.26-rc.1
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• ci: change args for install cert-manager by @Rory-Z in #1080
• chore: fix status field name error by @Rory-Z in #1082
• docs: add new document for hello operator by @Rory-Z in #1079
• docs: update huaweicloud link by @Rory-Z in #1085
• feat(deploy): support single namespace by @Rory-Z in #1091

Full Changelog: 2.2.25...2.2.26-rc.1

EMQX Operator 2.2.25 Released

Release Note 🍻

EMQX Operator 2.2.25 has been released.

Supported version

• apps.emqx.io/v2beta1

  • EMQX at 5.1.1 and later
  • EMQX Enterprise at 5.1.1 and later

• apps.emqx.io/v1beta4

  • EMQX at 4.4.14 and later
  • EMQX Enterprise at 4.4.14 and later

Enhancements 🚀

• apps.emqx.io/v2beta1 EMQX.

  • Fix sometimes got EOF error when request EMQX API

How to install/upgrade EMQX Operator 💡

Need make sure the cert-manager is ready

helm repo add emqx https://repos.emqx.io/charts
helm repo update
helm upgrade --install emqx-operator emqx/emqx-operator \
  --namespace emqx-operator-system \
  --create-namespace \
  --version 2.2.25
kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system

Warning 🚨

apps.emqx.io/v1beta3 and apps.emqx.io/v2alpha1 will be dropped soon

What's Changed

• chore: dump controller-gen version by @Rory-Z in #1077
• fix: try to fix EOF error by @Rory-Z in #1076

Full Changelog: 2.2.24...2.2.25