The Kubernetes-native platform (v2).
The Package manager for Kubernetes.
The Kubernetes-native Service Broker.
For the rest of this example we will refer to a special variables called
$hostname. Please choose one of the two methods for building your
For a standard installation that includes deis-router, you can calculate the hostname value using its public IP address and a wildcard DNS record.
If your router IP is
$hostname will be
deis.126.96.36.199.nip.io. You can find your IP address by running:
kubectl --namespace=deis describe svc deis-router
If you do not have an load balancer IP, the router automatically forwards traffic from a kubernetes node to the router. In this case, use the IP of a kubernetes node and the node port that routes to port 80 on the controller.
Deis workflow requires a wildcard DNS record to dynamically map app names to the router.
In this example, the user should already have DNS set up pointing to their known host. The
$hostname value can be calculated by prepending
deis. to the value set in
The first user to register against Deis Workflow will automatically be given administrative privileges.
Use the controller
$hostname to register a user in the cluster.
$ deis register http://$hostname
Logged in as admin
$ deis whoami
You are admin at http://$hostname
You have now registered your first user and you are ready to deploy an application.
Deis Workflow supports three different types of applications, Buildpacks, Dockerfiles and Docker Images. Our first application will be a simple Docker Image-based application, so you don't have to wrestle with checking out code.
deis create to create a new application on Deis Workflow. If you do not
specify a name for your application, Workflow automatically generates a
friendly (and sometimes funny) name.
$ deis create --no-remote
Creating Application... done, created proper-barbecue
If you want to add a git remote for this app later, use `deis git:remote -a proper-barbecue`
Our application has been created and named
proper-barbecue. As with the
deis hostname, any HTTP traffic to
proper-barbecue will be automatically
routed to your application pods by the edge router.
Let's use the CLI to tell the platform to deploy an application and then use curl to send a request to the app:
$ deis pull deis/example-go -a proper-barbecue
Creating build... done
$ curl http://proper-barbecue.$hostname
Powered by Deis
If you see a 404 error, make sure you specified your application name with
Workflow's edge router knows all about application names and automatically
sends traffic to the right application. The router sends traffic for
proper-barbecue.188.8.131.52.nip.io to your app, just like
deis.184.108.40.206.nip.io was sent to the Workflow API service.
Next, let's change some configuration using the CLI. Our example app is built
to read configuration from the environment. By using
deis config:set we can
change how the application behaves:
$ deis config:set POWERED_BY="Docker Images + Kubernetes" -a proper-barbecue
Creating config... done
=== proper-barbecue Config
POWERED_BY Docker Images + Kubernetes
Behind the scenes, Workflow creates a new release for your application and uses Kubernetes to provide a zero-downtime rolling deploy to the new release!
Validate that our configuration change has worked:
$ curl http://proper-barbecue.220.127.116.11.nip.io
Powered by Docker Images + Kubernetes
Last, let's scale our application by adding more application processes. Using the CLI you can easily add and remove additional processes to service requests:
$ deis scale cmd=2 -a proper-barbecue
Scaling processes... but first, coffee!
done in 36s
=== proper-barbecue Processes
proper-barbecue-v18-cmd-rk644 up (v18)
proper-barbecue-v18-cmd-0ag04 up (v18)
Congratulations! You have deployed, configured, and scaled your first application using Deis Workflow.
There is a lot more you can do with Deis Workflow, play around with the CLI:
deis rollback -a proper-barbecue
deis logs -a proper-barbecue