README

East PaaS is a universal package, following the #East programming philosophy, build on Teknoo East Foundation and Recipe to implement a custom PaaS manager like Platform.sh.

This library is able to fetch a project on a source repository (like Git) in a temporary folder, reads a deployment file (by default, called .paas.yaml) run some hooks to install vendors (with composer, npm, pip, etc..), compiles (make, symfony console), warmup cache, creates OCI image (with buildah or docker build) and deploy the project them in a cluster (kubernetes, but with non bundled driver, Docker Swarm).

The deployment on Kubernetes includes :

• Namespace
• ReplicaSets or Deployments (with Pods)
• ConfigMap and Secrets
• Service and Ingress
• Quota

Teknoo East PaaS is compatible with Docker or any OCI implementation (like BuildAh) and Kubernetes. Implementation of other cluster orchestration like Docker Swarm can be added.

Teknoo East PaaS is bundled with a default implementation with Symfony 6.4 or newer and Doctrine ODM MongoDB to persist data.

Documentation

The documentation, about the architecture of this library and its behavior is available here

Example with Symfony

An example of integration with Symfony file is available here

Example of .paas.yaml configuration file present into git repository to deploy

An example of the .paas.yaml file in v1.1 is available here An example of the .paas.yaml file in v1.0 is available here

Support this project

This project is free and will remain free. It is fully supported by the activities of the EIRL. If you like it and help me maintain it and evolve it, don't hesitate to support me on Patreon or Github.

Thanks :) Richard.

Credits

EIRL Richard Déloge - https://deloge.io - Lead developer. SASU Teknoo Software - https://teknoo.software

About Teknoo Software

Teknoo Software is a PHP software editor, founded by Richard Déloge, as part of EIRL Richard Déloge. Teknoo Software's goals : Provide to our partners and to the community a set of high quality services or software, sharing knowledge and skills.

License

Space is licensed under the 3-Clause BSD License - see the licenses folder for details.

Installation & Requirements

To install this library with composer, run this command :

composer require teknoo/east-paas

This library requires :

* PHP 8.2+
* A PHP autoloader (Composer is recommended)
* Teknoo/Immutable.
* Teknoo/States.
* Teknoo/Recipe.
* Teknoo/East-Foundation.
* Optional: Symfony 6.4+ (for administration)

Contribute :)

You are welcome to contribute to this project. Fork it on Github