{"id":16880009,"url":"https://github.com/aledbf/deis-workflow","last_synced_at":"2026-04-11T08:34:49.690Z","repository":{"id":149109831,"uuid":"60663407","full_name":"aledbf/deis-workflow","owner":"aledbf","description":null,"archived":false,"fork":false,"pushed_at":"2016-06-22T19:54:01.000Z","size":15738,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-25T05:24:53.228Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aledbf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-08T02:51:27.000Z","updated_at":"2016-06-08T02:59:21.000Z","dependencies_parsed_at":"2023-05-01T14:01:46.219Z","dependency_job_id":null,"html_url":"https://github.com/aledbf/deis-workflow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aledbf%2Fdeis-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aledbf%2Fdeis-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aledbf%2Fdeis-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aledbf%2Fdeis-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aledbf","download_url":"https://codeload.github.com/aledbf/deis-workflow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244538571,"owners_count":20468740,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T15:56:56.553Z","updated_at":"2026-04-11T08:34:49.626Z","avatar_url":"https://github.com/aledbf.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deis Controller\n\n[![Build Status](https://travis-ci.org/deis/controller.svg?branch=master)](https://travis-ci.org/deis/controller)\n[![codecov.io](https://codecov.io/github/deis/controller/coverage.svg?branch=master)](https://codecov.io/github/deis/controller?branch=master)\n[![Docker Repository on Quay](https://quay.io/repository/deisci/controller/status \"Docker Repository on Quay\")](https://quay.io/repository/deisci/controller)\n[![Dependency Status](https://www.versioneye.com/user/projects/5728e1dba0ca350034be67be/badge.svg?style=flat)](https://www.versioneye.com/user/projects/5728e1dba0ca350034be67be)\n\nDeis (pronounced DAY-iss) Workflow is an open source Platform as a Service (PaaS) that adds a developer-friendly layer to any [Kubernetes](http://kubernetes.io) cluster, making it easy to deploy and manage applications on your own servers.\n\nFor more information about the Deis Workflow, please visit the main project page at https://github.com/deis/workflow.\n\nWe welcome your input! If you have feedback, please [submit an issue][issues]. If you'd like to participate in development, please read the \"Development\" section below and [submit a pull request][prs].\n\n# About\n\nThe Controller is the central API server for [Deis Workflow][workflow]. It is installed on a [Kubernetes](http://kubernetes.io) cluster, making it easy to deploy and manage applications on your own cluster. Below is a non-exhaustive list of things it can do:\n\n* Create a new application\n* Delete an application\n* Scale an application\n* Configure an application\n* Create a new user\n\n# Development\n\nThe Deis project welcomes contributions from all developers. The high level process for development matches many other open source projects. See below for an outline.\n\n* Fork this repository\n* Make your changes\n* [Submit a pull request][prs] (PR) to this repository with your changes, and unit tests whenever possible.\n  * If your PR fixes any [issues][issues], make sure you write Fixes #1234 in your PR description (where #1234 is the number of the issue you're closing)\n* The Deis core contributors will review your code. After each of them sign off on your code, they'll label your PR with LGTM1 and LGTM2 (respectively). Once that happens, the contributors will merge it\n\n## Prerequisites\n\n### Kubernetes\n\nIn order to do development on this component, you'll need a working Kubernetes cluster. If you don't have one, follow the [installation instructions][install-k8s] and note that Controller currently targets version 1.2 and higher with the following requirements:\n\n* Docker's `insecure-registry` parameter must include the subnets used by your Kubernetes installation\n\n### Helm Classic\n\nAfter you have a working Kubernetes cluster, install [helm classic](http://helm.sh) and run the following commands to add the Deis chart repository and install Deis to your new cluster:\n\n```console\nhelmc repo add deis https://github.com/deis/charts\nhelmc fetch deis/workflow-dev\nhelmc generate -x manifests workflow-dev\nhelmc install workflow-dev\n```\n\n### Python\n\nPython 3.5 is a minimum requirement and can be installed via [Homebrew](http://brew.sh) for OS X or the package manager of choice on your OS.\n\nWith the correct Python in place the quickest way to get up and running is to run `make setup-venv` which will install the Python specific dependencies via [PIP](https://pip.pypa.io/en/stable/) inside an isolated (virtualenv)[https://docs.python.org/3/library/venv.html].\nRunning `python --version` to verify the correct version is recommend.\n\nFollow the linked documentation to learn about (virtualenv)[https://docs.python.org/3/library/venv.html] and how to `activate` and `deactivate` the environment.\n\n## Testing Your Code\n\nWhen you've built your new feature or fixed a bug, make sure you've added appropriate unit tests and run `make test` to ensure your code works properly.\n\nAlso, since this component is central to the platform, it's recommended that you manually test and verify that your feature or fix works as expected. To do so, ensure the following environment variables are set:\n\n* `DEIS_REGISTRY` - A Docker registry that you have push access to and your Kubernetes cluster can pull from\n  * If this is [Docker Hub](https://hub.docker.com/), leave this variable empty\n  * Otherwise, ensure it has a trailing `/`. For example, if you're using [Quay.io](https://quay.io), use `quay.io/`\n* `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.\n* `SHORT_NAME` (optional) - The name of the image. This defaults to `controller`\n* `VERSION` (optional) - The tag of the Docker image. This defaults to the current Git SHA (the output of `git rev-parse --short HEAD`)\n\nThen, run `make deploy` to build and push a new Docker image with your changes and replace the existing one with your new one in the Kubernetes cluster. See below for an example with appropriate environment variables.\n\n```console\nexport DEIS_REGISTRY=quay.io/\nexport IMAGE_PREFIX=arschles\nmake deploy\n```\n\nAfter the `make deploy` finishes, a new pod will be launched but may not be running. You'll need to wait until the pod is listed as `Running` and the value in its `Ready` column is `1/1`. Use the following command watch the pod's status:\n\n```console\nkubectl get pod --namespace=deis -w | grep deis-controller\n```\n\n## License\n\nCopyright 2013, 2014, 2015, 2016 Engine Yard, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at \u003chttp://www.apache.org/licenses/LICENSE-2.0\u003e\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n\n\n[install-k8s]: http://kubernetes.io/gettingstarted/\n[repl-controller]: http://kubernetes.io/docs/user-guide/replication-controller/\n[issues]: https://github.com/deis/controller/issues\n[prs]: https://github.com/deis/controller/pulls\n[workflow]: https://github.com/deis/workflow\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faledbf%2Fdeis-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faledbf%2Fdeis-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faledbf%2Fdeis-workflow/lists"}