![]() |
Deis Workflow is no longer maintained. Please read the announcement for more detail. |
---|---|
09/07/2017 | Deis Workflow v2.18 final release before entering maintenance mode |
03/01/2018 | End of Workflow maintenance: critical patches no longer merged |
Hephy is a fork of Workflow that is actively developed and accepts code contributions. |
Deis (pronounced DAY-iss) Workflow is an open source Platform as a Service (PaaS) that adds a developer-friendly layer to any Kubernetes cluster, making it easy to deploy and manage applications on your own servers.
For more information about the Deis Workflow, please visit the main project page at https://github.com/deis/workflow.
We welcome your input! If you have feedback, please submit an issue. If you'd like to participate in development, please read the "Development" section below and submit a pull request.
This component is a PostgreSQL database for use in Kubernetes. It builds on the official postgres Docker image. While it's intended for use inside of the Deis Workflow open source PaaS, it's flexible enough to be used as a standalone pod on any Kubernetes cluster or even as a standalone Docker container.
The Deis project welcomes contributions from all developers. The high level process for development matches many other open source projects. See below for an outline.
In order to develop and test this component in a Deis cluster, you'll need the following:
kubectl
installed and configured to talk to the cluster
Once you have all the aforementioned prerequisites, you are ready to start writing code. Once you've finished building a new feature or fixed a bug, please write a unit or integration test for it if possible. See an existing test for an example test.
If your feature or bugfix doesn't easily lend itself to unit/integration testing, you may need to add tests at a higher level. Please consider adding a test to our end-to-end test suite in that case. If you do, please reference the end-to-end test pull request in your pull request for this repository.
Finally, we encourage you to dogfood this component while you're writing code on it. To do so, you'll need to build and push Docker images with your changes.
This project has a Makefile that makes these tasks significantly easier. It requires the following environment variables to be set:
DEIS_REGISTRY
- A Docker registry that you have push access to and your Kubernetes cluster can pull from
/
. For example, if you're using Quay.io, use quay.io/
IMAGE_PREFIX
- The organization in the Docker repository. This defaults to deis
, but if you don't have access to that organization, set this to one you have push access to.SHORT_NAME
(optional) - The name of the image. This defaults to postgres
VERSION
(optional) - The tag of the Docker image. This defaults to the current Git SHA (the output of git rev-parse --short HEAD
)Assuming you have these variables set correctly, run make docker-build
to build the new image, and make docker-push
to push it. Here is an example command that would push to quay.io/arschles/postgres:devel
:
export DEIS_REGISTRY=quay.io/
export IMAGE_PREFIX=arschles
export VERSION=devel
make docker-build docker-push
Note that you'll have to push your image to a Docker repository (make docker-push
) in order for your Kubernetes cluster to pull the image. This is important for testing in your cluster.