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

[docs] update documentation for connect-service-upstreams (#5422)

Browse source 
* update documentation for connect-service-upstreams

Adds documentation for services, multiple services, and prepared
query under connect-service-upstreams annotation.

* changing tone of voice

* active voice fix

* fixing spaces

* fixed order, added clarification for multiple upstreams

* Update website/source/docs/platform/k8s/connect.html.md

Co-Authored-By: s-christoff <sarah.christoff13@gmail.com>
This commit is contained in:
Sarah Christoff 2019-06-20 14:18:34 -05:00 committed by GitHub
parent 703981eea4
commit 352adf204c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 31 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
website/source/docs/platform/k8s/connect.html.md
View file

@ -174,10 +174,37 @@ Annotations can be used to configure the injection behavior.
* `consul.hashicorp.com/connect-service-upstreams` - The list of upstream
services that this pod needs to connect to via Connect along with a static
local port to listen for those connections. Example: `db:1234,auth:6789`
will start two local listeners for `db` on port 1234 and `auth` on port
6789, respectively. The name of the service is the name of the service
registered with Consul. This value defaults to no upstreams.
local port to listen for those connections.
* Services
The name of the service is the name of the service registered with Consul. You can optionally specify datacenters with this annotation.
```annotations:
"consul.hashicorp.com/connect-service-upstreams":"[service-name]:[port]:[optional datacenter]"
```
* [Prepared Query](https://www.consul.io/docs/connect/proxies.html#upstreams)
```annotations:
"consul.hashicorp.com/connect-service-upstreams": "prepared_query:[query name]:[port]"
````
* Multiple Upstreams
If you would like to specify multiple services or upstreams, delimit them with commas
```annotations:
"consul.hashicorp.com/connect-service-upstreams":"[service-name]:[port]:[optional datacenter],[service-name]:[port]:[optional datacenter]"
```
```annotations:
"consul.hashicorp.com/connect-service-upstreams":"[service-name]:[port]:[optional datacenter],prepared_query:[query name]:[port]"
```
* `consul.hashicorp.com/connect-service-protocol` - For pods that will be
registered with Consul's [central configuration](/docs/agent/config_entries.html)