Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update external etcd section of clustering guide to cover auto-compaction #1638

Merged
merged 3 commits into from
Jul 30, 2019
Merged

update external etcd section of clustering guide to cover auto-compaction #1638

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d3148d0
update external etcd section of clustering guide to cover auto-compac…
Jul 25, 2019
ee0eb50
copy to all versions
apaskulin Jul 30, 2019
c10ebe0
Merge branch 'master' into etcd-tuning
apaskulin Jul 30, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions content/sensu-go/5.12/guides/clustering.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -435,7 +435,7 @@ backend-url:

## Using an external etcd cluster

To stand up an external etcd cluster, you can follow etcd's [clustering guide][12] using the same store configuration.
Using Sensu with an external etcd cluster requires etcd 3.3.2 or newer. To stand up an external etcd cluster, you can follow etcd's [clustering guide][12] using the same store configuration.

In this example, we will enable client-to-server and peer communication authentication [using self-signed TLS certificates][13]. Below is how you would start etcd for `backend-1` from our three node configuration example above.

Expand All @@ -455,9 +455,13 @@ etcd \
--peer-trusted-ca-file=./ca.pem \
--peer-cert-file=./backend-1.pem \
--peer-key-file=./backend-1-key.pem \
--peer-client-cert-auth
--peer-client-cert-auth \
--auto-compaction-mode revision \
--auto-compaction-retention 2
{{< /highlight >}}

_NOTE: The `auto-compaction-mode` and `auto-compaction-retention` flags are of particular significance. Without these settings your database may quickly reach etcd's maximum database size limit._

In order to inform Sensu that you'd like to use this external etcd data source, add the `sensu-backend` flag `--no-embed-etcd` to the original configuration, along with the path to a client certificate created using our CA.

{{< highlight shell >}}
Expand Down