README: Add "features" and "documentation" sections
This commit is contained in:
parent
44adad61a4
commit
e3e9e162cd
24
README.md
24
README.md
|
@ -13,6 +13,27 @@ For an introduction to agola you can take a look at [this post](https://sorintos
|
||||||
|
|
||||||
See [the agolademo example](https://agola.io/tryit)
|
See [the agolademo example](https://agola.io/tryit)
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
* Easy to install and manage.
|
||||||
|
* Scalable and High Available: go from a single instance (single process) deployment to a distributed deployment.
|
||||||
|
* Deploy anywhere: Kubernetes, IaaS, bare metal and execute the "tasks" anywhere (currently containers executors like docker or orchestrators and Kubernetes, but easily extensible to future technologies or VMs instead of containers).
|
||||||
|
* Support any language, deployment system etc... (just use the right image)
|
||||||
|
* Integrate with multiple git providers at the same time: you could add repos from github, gitlab, gitea (and more to come) inside the same agola installation.
|
||||||
|
* Use it to manage the full development lifecycle: from build to deploy.
|
||||||
|
* Tasks Workflows (that we called **Runs**) with ability to achieve fan-in, fan-out, matrixes etc..., everything containerized to achieve maximum reproducibility.
|
||||||
|
* Git based workflow: the run definition is committed inside the git repository (so everything is tracked and reproducible). A run execution is started by a git action (push, pull-request).
|
||||||
|
* Design it with the ability to achieve at most once runs: during a deployment to production we don't want multiple concurrent execution of the deploy...
|
||||||
|
* Restartable and reproducible Runs (restart a run from scratch or from failed tasks using the same source commit, variables etc...)
|
||||||
|
* [User Direct Runs](https://agola.io/doc/concepts/user_direct_runs.html): give every user the power to test their software using the same run definition used when pushing to git/opening a pull request inside the Agola installation with just one command like if they were running tests locally (without requiring a super powerful workstation).
|
||||||
|
* Testable "Runs" (what is a CI/CD environment if you cannot test your changes to the Runs definitions?): use the same run definition but use a powerful [secrets and variables system](https://agola.io/doc/concepts/secrets_variables.html) to access different resources (environments, docker registries etc...).
|
||||||
|
* Don't try to extend YAML to be a templating language but use a real templating language (as of now [jsonnet](https://jsonnet.org/)) to easily generate the run configuration without side effects.
|
||||||
|
* An advanced permissions system (work in progress).
|
||||||
|
* Dependency Caching to speed up tasks
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
https://agola.io/doc/
|
||||||
|
|
||||||
## Local development
|
## Local development
|
||||||
|
|
||||||
|
@ -24,6 +45,5 @@ Agola is an open source project under the Apache 2.0 license, and contributions
|
||||||
To submit your changes please open a pull request.
|
To submit your changes please open a pull request.
|
||||||
|
|
||||||
## Contacts
|
## Contacts
|
||||||
|
|
||||||
* For bugs and feature requests file an [issue](https://github.com/agola-io/agola/issues/new)
|
* For bugs and feature requests file an [issue](https://github.com/agola-io/agola/issues/new)
|
||||||
* For general discussion about using and developing Agola, join the [agola forum](https://talk.agola.io)
|
* For general discussion about using and developing Agola, join the [agola forum](https://talk.agola.io)
|
||||||
|
|
Loading…
Reference in New Issue