discovery-go

KO | EN

gitlite — search

#javascript #ai #llm #go #golang #android #machine-learning #deep-learning #awesome #cli #vue #pytorch #ios #mcp

(★ 13)

Programmatically find services

discovery-go Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# discovery-go

This library programmatically finds endpoints for dependencies. Similar to [discovery-node](https://github.com/Clever/discovery-node) and [disocvery-python](https://github.com/Clever/discovery-python).

See [Service Discovery](https://clever.atlassian.net/wiki/spaces/ENG/pages/116686857/Discovery) for more details.

## API

[Godoc Documentation](http://godoc.org/github.com/Clever/discovery-go)

### Examples

```go
gearmanAdminURLString, err := discovery.URL("gearman-admin", "http")
if err != nil {
    log.Fatal("ERROR: " + err.Error())
}

stokedHostPort, err := discovery.HostPort("stoked", "thrift")
if err != nil {
    logger.Fatal("ERROR: " + err.Error())
}

stokedHost, err := discovery.Host("stoked", "thrift")
if err != nil {
    logger.Fatal("ERROR: " + err.Error())
}

stokedPort, err := discovery.Port("stoked", "thrift")
if err != nil {
    logger.Fatal("ERROR: " + err.Error())
}

cleverComURL, err := discovery.ExternalURL("clever.com")
if err != nil {
    logger.Fatal("ERROR: " + err.Error())
}
```

### Implementation Details

Currently, `discovery-{go,node,python}` looks for environment variables with the following format:

```
SERVICE_{SERVICE_NAME}_{EXPOSE_NAME}_{PROTO,HOST,PORT}
```

These environment variables are autogenerated [catapult](http://github.com/Clever/catapult) during app deployment.  Three env-vars are created for each app listed in the `dependencies` section of caller's launch yaml.

For example, if an app lists `district-authorizations` as a dependency, catapult will generate this env-vars triplet:

```bash
SERVICE_DISTRICT_AUTHORIZATIONS_HTTP_PROTO = "http"
SERVICE_DISTRICT_AUTHORIZATIONS_HTTP_HOST = "district-authorizations.ops.clever.com"
SERVICE_DISTRICT_AUTHORIZATIONS_HTTP_PORT = "80"
```

It is also used to look for external urls with the format

```
EXTERNAL_URL_{URL_HOST}
```

For example for `schools.clever.com` catapult will set:

```bash
EXTERNAL_URL_SCHOOLS_CLEVER_COM = "https://schools.clever.com:443
```

discovery-go

discovery-go Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

discovery-go

discovery-go Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README