luxolus
/
open-consul
2
0
Fork 0
Code Issues 1 Pull Requests Packages Releases Wiki Activity

Adds a reference to the health endpoint in the intro. 

Fixes #1739.
This commit is contained in:
James Phillips 2016-03-09 16:42:15 -08:00
parent a860edc369
commit 9d38282db5
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
website/source/intro/getting-started/services.html.markdown
View File

@ -140,6 +140,17 @@ $ curl http://localhost:8500/v1/catalog/service/web
"ServiceName":"web","ServiceTags":["rails"],"ServicePort":80}]
```
The catalog API gives all nodes hosting a given service. As we will see later
with [health checks](/intro/getting-started/checks.html) you'll typically want
to query just for healthy instances where the checks are passing. This is what
DNS is doing under the hood. Here's a query to look for only healthy instances:
```text
$ curl 'http://localhost:8500/v1/health/service/web?passing'
[{"Node":"Armons-MacBook-Air","Address":"172.20.20.11","Service":{ \
"ID":"web", "Service":"web", "Tags":["rails"],"Port":80}, "Checks": ...}]
```
## Updating Services
Service definitions can be updated by changing configuration files and