What is Etcd

etcd is a distributed reliable key-value store for the most critical data of a distributed system, with a focus on being:

  • Simple: well-defined, user-facing API (gRPC)
  • Secure: automatic TLS with optional client cert authentication
  • Fast: benchmarked 10,000 writes/sec
  • Reliable: properly distributed using Raft

etcd is written in Go and uses the Raft consensus algorithm to manage a highly-available replicated log.

Github repository

https://github.com/etcd-io/etcd

Use Etcd

With Caddy

You have to build your caddy instance including Souin and Etcd using xcaddy (refer to the build caddy section).

  xcaddy build --with github.com/darkweak/souin/plugins/caddy --with github.com/darkweak/storages/etcd/caddy
  

You will be able to use etcd in your Caddyfile or JSON configuration file.

  {
    cache {
        ttl 1h
        etcd
    }
}

route {
    cache
    respond "Hello HTTP cache"
}
  

Configuration

You can find the configuration for Etcd here or check the values table below.

Values

Key nametyperequired
Endpoints[]string
AutoSyncIntervaltime.Duration
DialTimeouttime.Duration
DialKeepAliveTimetime.Duration
DialKeepAliveTimeouttime.Duration
MaxCallSendMsgSizeint
MaxCallRecvMsgSizeint
Usernamestring
Passwordstring
RejectOldClusterbool
PermitWithoutStreambool