NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #2577 by repository stars
Latest stable
v0.8.3
Last release 4 years ago
no release in 18 months
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 16 of 17 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
28 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Docker Image: ` docker run natsio/nats-operator:0.8.3 kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.8.3/00-prereqs.ya
Installing
Docker Image:
docker run natsio/nats-operator:0.8.3
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.8.3/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.8.3/10-deployment.yaml
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- v0.8.2 - a2c3c71 - - Compare
v0.8.2
a2c3c71
Compare
Nothing published for this version
docker run connecteverything/nats-operator:0.7.4
Docker Image:
docker run connecteverything/nats-operator:0.7.4
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.4/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.4/10-deployment.yaml---
apiVersion: nats.io/v1alpha2
kind: NatsCluster
metadata:
name: example-nats-cluster
spec:
size: 3
version: "2.1.7"
pod:
volumeMounts:
- name: user-credentials
mountPath: /etc/nats-creds
readOnly: true
leafnodeConfig:
remotes:
- url: nats://1.2.3.4:7422
credentials: /etc/nats-creds/user.ncreds
template:
spec:
volumes:
- name: user-credentials
secret:
secretName: user-credentialsFixed config reloader sidecar also watches TLS certs (#281)
Fixed support for using gateways when no external ip access is enabled (#282)
nats:2.1.8connecteverything/nats-operator:0.7.2
Docker Image:
connecteverything/nats-operator:0.7.2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.2/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.2/10-deployment.yamlreject_unknown option from gatewaysconnecteverything/nats-operator:0.7.0
Docker Image:
connecteverything/nats-operator:0.7.0
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.0/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.7.0/10-deployment.yaml$ minikube start \
--extra-config=apiserver.service-account-signing-key-file=/var/lib/minikube/certs/sa.key \
--extra-config=apiserver.service-account-key-file=/var/lib/minikube/certs/sa.pub \
--extra-config=apiserver.service-account-issuer=api \
--extra-config=apiserver.service-account-api-audiences=api,spire-server \
--extra-config=apiserver.authorization-mode=Node,RBAC \
--extra-config=kubelet.authentication-token-webhook=true
$ kubectl apply -f example/nats-operator-cluster-scoped-rbac.yaml
$ kubectl apply -f example/nats-operator-cluster-scoped.yaml
$ kubectl get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
kube-system coredns-66bff467f8-7fqmb 1/1 Running 0 5m57s
kube-system coredns-66bff467f8-s9q4q 1/1 Running 0 5m57s
kube-system etcd-minikube 1/1 Running 0 5m58s
kube-system kube-apiserver-minikube 1/1 Running 0 5m58s
kube-system kube-controller-manager-minikube 1/1 Running 0 5m58s
kube-system kube-proxy-7s8w5 1/1 Running 0 5m57s
kube-system kube-scheduler-minikube 1/1 Running 0 5m58s
kube-system storage-provisioner 1/1 Running 0 5m56s
my-admin-app-ns nats-admin-user-pod 1/1 Running 0 92s
my-app-ns nats-user-pod 1/1 Running 0 92s
nats-io nats-operator-6f545874b4-hvl75 1/1 Running 0 2m52s
nats-system nats-cluster-1 2/2 Running 0 84s
nats-system nats-cluster-2 2/2 Running 0 74s
nats-system nats-cluster-3 2/2 Running 0 68s
$ kubectl exec -n my-app-ns -it nats-user-pod -- /bin/sh
$ nats-sub -s nats://nats-user:`cat /var/run/secrets/nats.io/token`@nats-cluster.nats-system foo.bar
$ nats-sub -s nats://nats-user:`cat /var/run/secrets/nats.io/token`@nats-cluster.nats-system foo.asdfAdded support to define tls ciphers
Added support to define tls ciphers
Example:
---
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "tls-nats"
spec:
# Number of nodes in the cluster
size: 3
tls:
# Certificates to secure the NATS client connections
serverSecret: "nats-server-tls"
# Name of the CA in serverSecret
serverSecretCAFileName: "ca.crt"
# Name of the key in serverSecret
serverSecretKeyFileName: "tls.key"
# Name of the certificate in serverSecret
serverSecretCertFileName: "tls.crt"
cipherSuites:
- TLS_...
curvePreferences:
- example...connecteverything/nats-operator:0.6.0
Docker Image:
connecteverything/nats-operator:0.6.0
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.6.0/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.6.0/10-deployment.yamlconnecteverything/nats-operator:0.5.0-v1alpha2
Docker Image:
connecteverything/nats-operator:0.5.0-v1alpha2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.5.0/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.5.0/10-deployment.yamlThis version adds support for NATS v2 new decentralized auth features, and super clusters using gateway and leafnodes. Full example below:
---
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-super-cluster"
spec:
size: 3
version: "edge-v2.0.0-RC12"
serverImage: "synadia/nats-server"
natsConfig:
debug: true
trace: true
tls:
# TLS timeout for client connections
clientsTLSTimeout: 5
# TLS timeout for gateway connections
gatewaysTLSTimeout: 5
# Certificates to secure the NATS client connections:
serverSecret: "nats-server-tls"
serverSecretCAFileName: "ca.crt"
serverSecretKeyFileName: "tls.key"
serverSecretCertFileName: "tls.crt"
# Certificates to secure the routes.
gatewaySecret: "nats-gateways-tls"
gatewaySecretCAFileName: "ca.crt"
gatewaySecretKeyFileName: "tls.key"
gatewaySecretCertFileName: "tls.crt"
# Certificates to secure the leafnode.
leafnodeSecret: "nats-leafnodes-tls"
leafnodeSecretCAFileName: "ca.crt"
leafnodeSecretKeyFileName: "tls.key"
leafnodeSecretCertFileName: "tls.crt"
pod:
enableClientsHostPort: true
advertiseExternalIP: true
gatewayConfig:
name: example
hostPort: 32328
gateways:
- name: example
url: nats://example.com:32328
leafnodeConfig:
hostPort: 4224
operatorConfig:
secret: operator-jwt
systemAccount: "AASYS..."
resolver: URL(https://example.com/jwt/v1/accounts/)
template:
spec:
# Required to be able to lookup public ip address from a server.
serviceAccountName: "nats-server"Nothing published for this version
connecteverything/nats-operator:0.4.5-v1alpha2
Docker Image:
connecteverything/nats-operator:0.4.5-v1alpha2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.5/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.5/10-deployment.yamlapiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: nats-auth-file-example
namespace: default
spec:
size: 1
version: "1.4.1"
natsConfig:
maxPayload: 20971520
pod:
enableConfigReload: true
volumeMounts:
- name: authconfig
mountPath: /etc/nats-config/authconfig
auth:
# Needs to be under /etc/nats-config where nats looks
# for its config file, or it won't be able to be included
# by /etc/nats-config/gnatsd.conf
clientsAuthFile: "authconfig/auth.json"
template:
spec:
initContainers:
- name: secret-getter
image: "busybox"
command: ["sh", "-c", "echo 'users = [ { user: 'foo', pass: 'bar' } ]' > /etc/nats-config/authconfig/auth.json"]
volumeMounts:
- name: authconfig
mountPath: /etc/nats-config/authconfig
volumes:
- name: authconfig
emptyDir: {}apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats"
spec:
size: 3
serverImage: "nats"
version: "1.4.1"
tls:
verify: true
serverSecret: "nats-certs"Updated default reloader sidecar version to connecteverything/nats-server-config-reloader:0.4.5-v1alpha2
Updated RBAC to use less permissions (#143)
` connecteverything/nats-operator:0.4.4-v1alpha2 `
Docker Image:
connecteverything/nats-operator:0.4.4-v1alpha2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.4/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.4/10-deployment.yaml
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats"
spec:
size: 3
tls:
serverSecret: "nats-clients-tls"
routesSecret: "nats-routes-tls"
clientsTLSTimeout: 5
routesTLSTimeout: 5
Reversed order of CRD init operations (https://github.com/nats-io/nats-operator/pull/155)
Updated metrics prometheus-nats-exporter to version 0.2.0, add channelz and serverz to the arguments of the metrics container (#151)
Nothing published for this version
Docker Image: connecteverything/nats-operator:0.4.3-v1alpha2
Docker Image: connecteverything/nats-operator:0.4.3-v1alpha2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.3/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.3/10-deployment.yaml
---
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-custom"
spec:
size: 3
version: "1.4.1"
natsConfig:
debug: true
trace: true
# Duration within quotes
writeDeadline: "5s"
# In bytes, in this case 5MB
maxPayload: 5242880
maxConnections: 10
maxSubscriptions: 10
maxPending: 1024 # In bytes
disableLogtime: true
maxControlLine: 2048
pod:
# NOTE: Only supported in Kubernetes v1.12+.
enableConfigReload: true
# Defaults but can be customized to be a different image
reloaderImage: "connecteverything/nats-server-config-reloader"
reloaderImageTag: "0.2.2-v1alpha2"
reloaderImagePullPolicy: "IfNotPresent"
Docker Image: connecteverything/nats-operator:0.4.2-v1alpha2
Docker Image: connecteverything/nats-operator:0.4.2-v1alpha2
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.2/00-prereqs.yaml
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.4.2/10-deployment.yaml
extraRoutes field to extend a cluster mesh with other NATS clusters (https://github.com/nats-io/nats-operator/pull/130)apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-dev-v2"
spec:
size: 3
version: "1.4.1"
extraRoutes:
# Explicit route endpoint
- route: "nats://example.com:6222"
# Discover implicit routes from nats-dev-v1 cluster
- cluster: "nats-dev-v1"
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-dev-v1"
spec:
pod:
# Disable istio on nats pods
annotations:
sidecar.istio.io/inject: "false"
nats-io namespace to work cluster wide,
and it can be enabled by setting the flag --feature-gates=ClusterScoped=true when starting the operator (https://github.com/nats-io/nats-operator/pull/118)apiVersion: apps/v1
kind: Deployment
metadata:
name: nats-operator
namespace: nats-io
spec:
replicas: 1
selector:
matchLabels:
name: nats-operator
template:
metadata:
labels:
name: nats-operator
spec:
serviceAccountName: nats-operator
containers:
- name: nats-operator
image: connecteverything/nats-operator:0.4.2-v1alpha2
imagePullPolicy: IfNotPresent
args:
- nats-operator
# Perform a cluster-scoped deployment.
- --feature-gates=ClusterScoped=true
ports:
- name: readyz
containerPort: 8080
env:
- name: MY_POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
- name: MY_POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
readinessProbe:
httpGet:
path: /readyz
port: readyz
initialDelaySeconds: 15
timeoutSeconds: 3
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "example-nats-1"
spec:
size: 3
serverImage: "synadia/nats-server"
version: "edge-2.0.0-RC5"
lameDuckDurationSeconds: 30 # seconds
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-cluster"
spec:
size: 3
version: "1.4.1"
tls:
enableHttps: true
serverSecret: "nats-clients-tls"
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-cluster"
spec:
size: 3
serverImage: "synadia/nats-server"
version: "edge-2.0.0-RC5"
tls:
serverSecret: "nats-clients-tls"
auth:
tlsVerifyAndMap: true
clientsAuthSecret: "nats-clients-auth"
pod.enableClientsHostPort parameter to make the NATS servers bind the port 4222 from the host (https://github.com/nats-io/nats-operator/pull/123)apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-dev"
spec:
size: 3
version: "1.4.0"
pod:
enableClientsHostPort: true
noAdvertise field to disable gossiping routes to clients (https://github.com/nats-io/nats-operator/pull/123)apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "example-nats-1"
spec:
size: 3
version: "1.4.0"
noAdvertise: true
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-dev"
spec:
size: 3
version: "1.4.0"
pod:
# Must use host port to be able to connect to external ip
enableClientsHostPort: true
advertiseExternalIP: true
bootconfigImage: "connecteverything/nats-boot-config"
bootconfigImageTag: "0.5.0"
# Required to be able to lookup public ip address from a server
template:
spec:
serviceAccountName: "nats-server"
Default NATS Server image is changed to v1.4.0
Add metrics port to mgmt service so that prometheus operator can discover it (https://github.com/nats-io/nats-operator/pull/112)
NATS Server pods that have reached the terminal state (https://github.com/nats-io/nats-operator/pull/108)
Setting advertise for clusters now enabled by default (https://github.com/nats-io/nats-operator/issues/73)
Fix operator reporting readiness only after becoming leader (https://github.com/nats-io/nats-operator/pull/107)
` kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.3.0/deployment.yaml `
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.3.0/deployment.yaml
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-cluster-metrics"
spec:
size: 3
version: "1.3.0"
serverImage: "nats"
pod:
enableMetrics: true
metricsImage: "synadia/prometheus-nats-exporter"
metricsImageTag: "0.1.0"
apiVersion: "nats.io/v1alpha2"
kind: "NatsCluster"
metadata:
name: "nats-cluster-custom"
spec:
size: 3
version: "1.3.0"
serverImage: "my-org/nats"
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.3/deployment-rbac.yaml
# RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.3/deployment-rbac.yaml
# Non RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.3/deployment.yaml
Check CRD existence before attempting to create (https://github.com/nats-io/nats-operator/pull/55)
Recover from unexpected EOF with API Server (https://github.com/nats-io/nats-operator/pull/54)
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.2/deployment-rbac.yaml
# RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.2/deployment-rbac.yaml
# Non RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.2/deployment.yaml
Static field from tls block from v1alpha1 API has been deprecated
# RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.0/deployment-rbac.yaml
# Non RBAC
kubectl apply -f https://github.com/nats-io/nats-operator/releases/download/v0.2.0/deployment.yaml
v1alpha2 version (https://github.com/nats-io/nats-operator/pull/29)apps/v1beta2 Deployment API (supported since k8s v1.8.0) https://github.com/nats-io/nats-operator/commit/8defe657619da4662d5e851585706d4f7ccb7eab#diff-e87d9ff03678a45cd0da2aca55f6fe9cStatic field from tls block from v1alpha1 API has been deprecatedOne column per quarter.