From 210cde826d0906e5e838b2e24e42b17c12ede3f8 Mon Sep 17 00:00:00 2001 From: Ginger Collison Date: Thu, 18 Mar 2021 14:16:27 +0000 Subject: [PATCH 1/6] GitBook: [master] 4 pages modified --- SUMMARY.md | 2 +- developing-with-nats/tutorials/README.md | 2 +- developing-with-nats/tutorials/jwt.md | 2 +- nats-server/configuration/monitoring.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/SUMMARY.md b/SUMMARY.md index dd36294..f04c6ed 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -65,7 +65,7 @@ * [Explore NATS Request/Reply](developing-with-nats/tutorials/reqreply.md) * [Explore NATS Queueing](developing-with-nats/tutorials/queues.md) * [Advanced Connect and Custom Dialer in Go](developing-with-nats/tutorials/custom_dialer.md) - * [In Depth JWT guide](developing-with-nats/tutorials/jwt.md) + * [In Depth JWT Guide](developing-with-nats/tutorials/jwt.md) ## NATS Server diff --git a/developing-with-nats/tutorials/README.md b/developing-with-nats/tutorials/README.md index 74d7658..1b5a8a2 100644 --- a/developing-with-nats/tutorials/README.md +++ b/developing-with-nats/tutorials/README.md @@ -6,5 +6,5 @@ Tutorials are provided to give guidance on commonly used aspects of NATS. * [Explore NATS Request/Reply](reqreply.md) * [Explore NATS Queueing](queues.md) * [Advanced Connect and Custom Dialer in Go](custom_dialer.md) -* [In depth JWT guide](jwt.md) +* [In Depth JWT Guide](jwt.md) diff --git a/developing-with-nats/tutorials/jwt.md b/developing-with-nats/tutorials/jwt.md index 5ed193d..b7493fe 100644 --- a/developing-with-nats/tutorials/jwt.md +++ b/developing-with-nats/tutorials/jwt.md @@ -1,4 +1,4 @@ -# In Depth JWT guide +# In Depth JWT Guide This document provides a step by step deep dive into JWT usage within NATS. Starting with related concepts, it will introduce JWTs and how they can be used in NATS. This will NOT list every JWT/nsc option, but will focus on the important options and concepts. diff --git a/nats-server/configuration/monitoring.md b/nats-server/configuration/monitoring.md index c39e43a..5bffe94 100644 --- a/nats-server/configuration/monitoring.md +++ b/nats-server/configuration/monitoring.md @@ -528,7 +528,7 @@ The `/accountz` endpoint reports information on a server's active accounts. The **Endpoint:** `http://server:port/accountz` -| Result | Return Code | +| Result | Return Code | | :--- | :--- | | Success | 200 \(OK\) | | Error | 400 \(Bad Request\) | From 57a77ffcb46abf51978fe271a0cb98ed97e668ab Mon Sep 17 00:00:00 2001 From: Alberto Ricart Date: Thu, 18 Mar 2021 09:46:05 -0500 Subject: [PATCH 2/6] pointed at the nsc 2.2.0 release notes, as the new version of the tooling is not compatible with older servers. --- nats-tools/nsc/README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/nats-tools/nsc/README.md b/nats-tools/nsc/README.md index 9708d2c..464727f 100644 --- a/nats-tools/nsc/README.md +++ b/nats-tools/nsc/README.md @@ -40,6 +40,11 @@ nsc/ 5 directories, 1 file ``` +**IMPORTANT**: `nsc` version 2.2.0 has been released. This version of nsc only supports +`nats-server` v2.2.0 and `nats-account-server` v1.0.0. For more information please refer +to [nsc's 2.2.0 release notes](https://github.com/nats-io/nsc/releases/tag/2.2.0). + + ## Tutorials You can find various task-oriented tutorials to working with the tool here: From 59b31ef6ef612f43a890121d19ba4fb37244fa43 Mon Sep 17 00:00:00 2001 From: Ginger Collison Date: Thu, 18 Mar 2021 10:06:34 -0500 Subject: [PATCH 3/6] Update README.md --- nats-tools/nsc/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nats-tools/nsc/README.md b/nats-tools/nsc/README.md index 464727f..a144c32 100644 --- a/nats-tools/nsc/README.md +++ b/nats-tools/nsc/README.md @@ -42,7 +42,7 @@ nsc/ **IMPORTANT**: `nsc` version 2.2.0 has been released. This version of nsc only supports `nats-server` v2.2.0 and `nats-account-server` v1.0.0. For more information please refer -to [nsc's 2.2.0 release notes](https://github.com/nats-io/nsc/releases/tag/2.2.0). +to the [nsc 2.2.0 release notes](https://github.com/nats-io/nsc/releases/tag/2.2.0). ## Tutorials From 377b50279c0383d01e3f6f32134eb5d4f18bbec9 Mon Sep 17 00:00:00 2001 From: Ginger Collison Date: Fri, 19 Mar 2021 15:22:11 +0000 Subject: [PATCH 4/6] GitBook: [master] 2 pages modified --- jetstream/monitoring.md | 4 ++-- nats-tools/nsc/README.md | 5 +---- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/jetstream/monitoring.md b/jetstream/monitoring.md index f647bc1..9825d98 100644 --- a/jetstream/monitoring.md +++ b/jetstream/monitoring.md @@ -2,11 +2,11 @@ ## Server Metrics -Typically, NATS is monitored via HTTP endpoints like `/varz`, we do not at this moment have a JetStream equivelant, but it's planned that server and account level metrics will be made available. +JetStream has a /[jsz ](../nats-server/configuration/monitoring.md#jetstream-information)HTTP endpoint and advisories available. ## Advisories -JetStream publish a number of advisories that can inform operations about health and state of the Streams. These advisories are published to normal NATS subjects below `$JS.EVENT.ADVISORY.>` and one can store these advisories in JetStream Streams if desired. +JetStream publishes a number of advisories that can inform operations about the health and the state of the Streams. These advisories are published to normal NATS subjects below `$JS.EVENT.ADVISORY.>` and one can store these advisories in JetStream Streams if desired. The command `nats event --js-advisory` can view all these events on your console. The Golang package [jsm.go](https://github.com/nats-io/jsm.go) can consume and render these events and have data types for each of these events. diff --git a/nats-tools/nsc/README.md b/nats-tools/nsc/README.md index a144c32..7ac9e00 100644 --- a/nats-tools/nsc/README.md +++ b/nats-tools/nsc/README.md @@ -40,10 +40,7 @@ nsc/ 5 directories, 1 file ``` -**IMPORTANT**: `nsc` version 2.2.0 has been released. This version of nsc only supports -`nats-server` v2.2.0 and `nats-account-server` v1.0.0. For more information please refer -to the [nsc 2.2.0 release notes](https://github.com/nats-io/nsc/releases/tag/2.2.0). - +**IMPORTANT**: `nsc` version 2.2.0 has been released. This version of nsc only supports `nats-server` v2.2.0 and `nats-account-server` v1.0.0. For more information please refer to the [nsc 2.2.0 release notes](https://github.com/nats-io/nsc/releases/tag/2.2.0). ## Tutorials From 255f33d9b4ea5ec2323f734cffec1483b106f2fa Mon Sep 17 00:00:00 2001 From: Ginger Collison Date: Mon, 22 Mar 2021 09:11:15 -0500 Subject: [PATCH 5/6] Update jwt.md --- developing-with-nats/tutorials/jwt.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/developing-with-nats/tutorials/jwt.md b/developing-with-nats/tutorials/jwt.md index b7493fe..f3ffd52 100644 --- a/developing-with-nats/tutorials/jwt.md +++ b/developing-with-nats/tutorials/jwt.md @@ -489,11 +489,11 @@ resolver: URL(http://localhost:9090/jwt/v1/accouts/) 9. Server verifies that a user JWT issuer is either identical to the account JWT subject or part of the account JWT signing keys. 10. If all of the above holds true, the above invocation will succeed, only if the user JWT does not contain permissions or limits restricting the operation otherwise. - \`\`\`text + ```text > nats -s localhost:4222 "--creds=user.creds" pub "foo" "hello world" 16:56:02 Published 11 bytes to "foo" > - > \`\`\`text + ```text 11. Output if `user.creds` where to contain a JWT where the maximum message payload is limited to 5 bytes From 8932aeb438270bc27ad8c1584631be0a478a8204 Mon Sep 17 00:00:00 2001 From: Ginger Collison Date: Mon, 22 Mar 2021 09:16:17 -0500 Subject: [PATCH 6/6] Update jwt.md --- developing-with-nats/tutorials/jwt.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/developing-with-nats/tutorials/jwt.md b/developing-with-nats/tutorials/jwt.md index f3ffd52..7902271 100644 --- a/developing-with-nats/tutorials/jwt.md +++ b/developing-with-nats/tutorials/jwt.md @@ -491,9 +491,10 @@ resolver: URL(http://localhost:9090/jwt/v1/accouts/) ```text - > nats -s localhost:4222 "--creds=user.creds" pub "foo" "hello world" 16:56:02 Published 11 bytes to "foo" + > nats -s localhost:4222 "--creds=user.creds" pub "foo" "hello world" + > 16:56:02 Published 11 bytes to "foo" > - ```text + ``` 11. Output if `user.creds` where to contain a JWT where the maximum message payload is limited to 5 bytes