Skip to content

Commit

Permalink
Add acknowledgements (#7)
Browse files Browse the repository at this point in the history
  • Loading branch information
sadlil authored and tamalsaha committed Feb 10, 2017
1 parent 3a9bef4 commit 8429c4a
Show file tree
Hide file tree
Showing 4 changed files with 41 additions and 4 deletions.
18 changes: 17 additions & 1 deletion README.md
Expand Up @@ -43,17 +43,33 @@ To deploy voyager in Kubernetes follow this [guide](docs/user-guide/README.md).
1. Create `ingress.appscode.com` and `certificate.appscode.com` Third Party Resource
2. Deploy voyager to kubernetes.

## Running voyager alongside with other ingress controller
voyager can be configured to handle default kubernetes ingress or only ingress.appscode.com. voyager can also be run
along side with other controllers.

```sh
--ingress-class
// this flag can be set to 'voyager' to handle only ingress
// with annotation kubernetes.io/ingress.class=voyager.

// If unset, voyager will also handle ingress without ingress-class annotation.
```

## Developer Guide
Want to learn whats happening under the hood, read [the developer guide](docs/developer-guide/README.md).


## Contribution
If you're interested in being a contributor, read [the contribution guide](docs/contribution/README.md).


## Building voyager
Read [Build Instructions](docs/developer-guide/build.md) to build voyager.

## Acknowledgement
- kubernetes/contrib https://github.com/kubernetes/contrib/tree/master/service-loadbalancer
- xenolf/lego https://github.com/xenolf/lego
- kelseyhightower/kube-cert-manager https://github.com/kelseyhightower/kube-cert-manager
- PalmStoneGames/kube-cert-manager https://github.com/PalmStoneGames/kube-cert-manager

## Support
If you have any questions, you can reach out to us.
Expand Down
7 changes: 4 additions & 3 deletions docs/developer-guide/README.md
Expand Up @@ -33,7 +33,8 @@ voyager works by implementing third party resource data watcher for kubernetes.
for specific events as ADD, UPDATE and DELETE. and perform required operations.

Ingress watcher generates the configuration for HAProxy and stores it as a ConfigMaps and creates a RC with
specified HAProxy - that is configured with auto reload while any changes happens to ConfigMap data. voyager
keeps the ingress resource and the configuration in sync by performing processing on the resources.
specified HAProxy - that is configured with auto reload while any changes happens to ConfigMap data. This is handled via
[kloader](https://github.com/appscode/kloader). Voyager keeps the ingress resource and the configuration in sync
by performing processing on the resources.

Certificate watcher watch and process certificates third party data and obtain a ACME certificates.
Certificate watcher watch and process certificates third party data and obtain a ACME certificates.
6 changes: 6 additions & 0 deletions docs/developer-guide/build.md
Expand Up @@ -33,3 +33,9 @@ $ docker push <image>:<tag>
$ docker tag appscode/voyager:default sadlil/voyager:default
$ docker push sadlil/voyager:default
```

## Build HAProxy
```sh
$ ./hack/docker/haproxy/<version>/setup.sh
```
Specific version of HAProxy can be used with Voyager via `--haproxy-image`. This packages HAProxy and [kloader](https://github.com/appscode/kloader) into a Debian jessie Docker image.
14 changes: 14 additions & 0 deletions docs/user-guide/README.md
Expand Up @@ -167,3 +167,17 @@ certificate common name.

### Dive into Certificates
You Can Learn more about `certificate.appscode.com` by reading [this doc](../component/certificate.md).


## Running voyager alongside with other ingress controller
voyager can be configured to handle default kubernetes ingress or only ingress.appscode.com. voyager can also be run
along side with other controllers.

```sh
--ingress-class
// this flag can be set to 'voyager' to handle only ingress
// with annotation kubernetes.io/ingress.class=voyager.

// If unset, voyager will also handle ingress without ingress-class annotation.
```
Other ingress controller can be run alongside voyager to handle specific classed ingress.

0 comments on commit 8429c4a

Please sign in to comment.