Skip to content
This repository has been archived by the owner on Nov 30, 2021. It is now read-only.

Commit

Permalink
feat(ingress): document deis-builder DNS records
Browse files Browse the repository at this point in the history
  • Loading branch information
Matthew Fisher committed Apr 5, 2017
1 parent 01deb40 commit 292a3d4
Show file tree
Hide file tree
Showing 4 changed files with 23 additions and 12 deletions.
29 changes: 20 additions & 9 deletions src/installing-workflow/experimental-native-ingress.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ Now that Workflow has been deployed with the `global.experimental_native_ingress
Here is an example of how to use [traefik](https://traefik.io/) as an ingress controller for Workflow. Of course, you are welcome to use any controller you wish.

```
$ helm install stable/traefik --name deis-ingress-001 --namespace kube-system
$ helm install stable/traefik --name ingress --namespace kube-system
```

## Configure DNS
Expand All @@ -60,22 +60,33 @@ The experimental ingress feature requires a user to set up a hostname, and assum
We need to point the `*.$host` record to the public IP address of your ingress controller. You can get the public IP using the following command. A wildcard entry is necessary here as apps will use the same rule after they are deployed.

```
$ kubectl get svc deis-ingress-001 --namespace kube-system
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
deis-ingress-001 10.23.253.220 104.154.159.184 80:30231/TCP,443:32264/TCP 19m
$ kubectl get svc ingress-traefik --namespace kube-system
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
ingress-traefik 10.0.25.3 138.91.243.152 80:31625/TCP,443:30871/TCP 33m
```

If we were using `deis.com` as a hostname we would need to create the following A DNS record.
Additionally, we need to point the `deis-builder.$host` record to the public IP address of the [Builder][].

| Name | Type | Value |
| ----------------- |:-------------:| ---------------:|
| deis.deis.com | A | 104.154.159.184 |
```
$ kubectl get svc deis-builder --namespace deis
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
deis-builder 10.0.165.140 40.86.182.187 2222:32488/TCP 33m
```

If we were using `deis.com` as a hostname, we would need to create the following A DNS records.

| Name | Type | Value |
| ---------------------------- |:-------------:| --------------:|
| *.deis.com | A | 138.91.243.152 |
| deis-builder.deis.com | A | 40.86.182.187 |

Once all of the pods are in the `READY` state, and `deis.$host` resolves to the external IP found above Workflow is up an running!
Once all of the pods are in the `READY` state, and `deis.$host` resolves to the external IP found above, Workflow is up and running!

After installing Workflow, [register a user and deploy an application](../quickstart/deploy-an-app.md).

##### Feedback

While this feature is experimental we welcome feedback on the issue. We would like to learn more about use cases, and user experience. Please [open a new issue](https://github.com/deis/workflow/issues/new) for feedback.


[builder]: ../understanding-workflow/components.md#builder
2 changes: 1 addition & 1 deletion src/quickstart/provider/aws/dns.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,5 +100,5 @@ You are now ready to [register an admin user and deploy your first app](../../de
[next: deploy your first app](../../deploy-an-app.md)


[builder]: ../../../understanding-workflow/components.md#builder-builder-slugbuilder-and-dockerbuilder
[builder]: ../../../understanding-workflow/components.md#builder
[router]: ../../../understanding-workflow/components.md#router
2 changes: 1 addition & 1 deletion src/troubleshooting/applications.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,6 @@ See [Custom Health Checks][healthchecks] for more information on how to customiz
health checks to better suit the application's needs.


[builder]: ../understanding-workflow/components.md#builder-builder-slugbuilder-and-dockerbuilder
[builder]: ../understanding-workflow/components.md#builder
[healthchecks]: ../applications/managing-app-configuration.md#custom-health-checks
[troubleshooting-kubectl]: kubectl.md
2 changes: 1 addition & 1 deletion src/understanding-workflow/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ majority of the platforms state. Backups and WAL files are pushed to object
storage via [WAL-E][]. When the database is restarted, backups are fetched and
replayed from object storage so no data is lost.

## Builder: builder, slugbuilder, and dockerbuilder
## Builder

**Project Location:** [deis/builder](https://github.com/deis/builder)

Expand Down

0 comments on commit 292a3d4

Please sign in to comment.