Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add publish-service documentation #211

Merged
merged 2 commits into from
Sep 29, 2018
Merged

Add publish-service documentation #211

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e3557e5
Add publish-service documentation
danigrmartinez Aug 31, 2018
319c25e
Update README.md
danigrmartinez Sep 4, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -722,12 +722,14 @@ The following command-line arguments are supported:
||[`ingress-class`](#ingress-class)|name|`haproxy`|
||[`kubeconfig`](#kubeconfig)|/path/to/kubeconfig|in cluster config|
|`[0]`|[`max-old-config-files`](#max-old-config-files)|num of files|`0`|
||[`publish-service`](#publish-service)|namespace/servicename|``|
||[`rate-limit-update`](#rate-limit-update)|uploads per second (float)|`0.5`|
||[`reload-strategy`](#reload-strategy)|[native\|reusesocket]|`native`|
||[`sort-backends`](#sort-backends)|[true\|false]|`false`|
||[`tcp-services-configmap`](#tcp-services-configmap)|namespace/configmapname|no tcp svc|
||[`verify-hostname`](#verify-hostname)|[true\|false]|`true`|


### allow-cross-namespace

`--allow-cross-namespace` argument, if added, will allow reading secrets from one namespace to an
Expand Down Expand Up @@ -774,6 +776,20 @@ dynamic update is used. By default the same file is recreated and the old config
Use `--max-old-config-files` to configure after how much files Ingress controller should start to
remove old configuration files. If `0`, the default value, a single `haproxy.cfg` is used.

### publish-service

Some infrastructure tools like `external-DNS` relay in the ingress status to created access routes to the services exposed with ingress object.
```
apiVersion: extensions/v1beta1
kind: Ingress
...
status:
loadBalancer:
ingress:
- hostname: <ingressControllerLoadbalancerFQDN>
```
Use `--publish-service=namespace/servicename` to indicate the services fronting the ingress controller. The controller mirrors the address of this service's endpoints to the load-balancer status of all Ingress objects it satisfies.

### rate-limit-update

Use `--rate-limit-update` to change how much time to wait between HAProxy reloads. Note that the first
Expand Down