418ab9fea1
* Update outdated packages and upgrade to Go 1.22 Signed-off-by: retornam <retornam@users.noreply.github.com> * Update outdated packages and upgrade to Go 1.24 Signed-off-by: retornam <retornam@users.noreply.github.com> --------- Signed-off-by: retornam <retornam@users.noreply.github.com> |
||
|---|---|---|
| handlers | ||
| http | ||
| integration | ||
| metrics | ||
| timeprefix | ||
| .gitignore | ||
| Dockerfile | ||
| OWNERS | ||
| README.md | ||
| cloudbuild.dev.yaml | ||
| cloudbuild.prod.yaml | ||
| discovery.go | ||
| go.mod | ||
| go.sum | ||
| tests.sh | ||
README.md
discovery.etcd.io
This code powers the public service at https://discovery.etcd.io. The API is documented in the etcd clustering documentation.
Building with Docker
Requirements
Docker, using one of the following configurations:
- macOS You can either use Docker for Mac or docker-machine. See installation instructions here.
- Linux with local Docker Install Docker according to the instructions for your OS.
To build the image with Docker run:
$ cd path/to/discoveryserver
$ docker build -t discoveryserver .
To create and execute the discoveryserver container run:
docker run discoveryserver
Building on a local OS/shell environment
Go
Discoveryserver is written in Go. If you don't have a Go development environment, please set one up.
| discoveryserver | requires Go |
|---|---|
| 0.1 | =>1.11 |
Go modules
Discovery server uses Go modules, so that we need a Go version greater than or equal to 1.11.
Build the binary:
go build -v -o ./bin/discovery .
Test
./test.sh
Configuration
The service has three configuration options, and can be configured with either runtime arguments or environment variables.
--addr/DISC_ADDR: the address to run the service on, including port.--host/DISC_HOST: the host url to prepend to/newrequests.--etcd/DISC_ETCD: the url of the etcd endpoint backing the instance.
Production Configuration
See https://github.com/etcd-io/discovery.etcd.io for how the service is run on Kubernetes.
History
This package implements a super minimal etcd v2 API built on the currently incomplete [v2v3 package]. We need to do this because the public etcd discovery service has been running on the inefficient v2 storage engine and causing operational burden.
Further, to solve operational issues using the v3 API will enable us to use the backup features of the etcd Operator.
Run Cloudbuild
Cloudbuild is a GCP service that can be used to build and deploy discoveryserver. cloudbuild.dev.yaml builds discoverserver, publishes the docker image, and deploys to the dev environment. Cloudbuild.prod.yaml deploys a built docker image to the production environment.
$ export ENV=(dev|prod)
$ gcloud builds submit . --config=cloudbuild.$ENV.yaml --substitutions=COMMIT_SHA=`git rev-parse HEAD`