MCPcopy Index your code
hub / github.com/agola-io/agola

github.com/agola-io/agola @v0.11.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.11.0 ↗ · + Follow
4,230 symbols 14,744 edges 410 files 178 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Agola

Build Status Discourse

CI/CD redefined

For an introduction to agola you can take a look at this post

Try it

See the agolademo example

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: 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 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) 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

See how to develop agola

Contributing to Agola

Agola is an open source project under the Apache 2.0 license, and contributions are gladly welcomed! To submit your changes please open a pull request.

Contacts

  • For bugs and feature requests file an issue
  • For general discussion about using and developing Agola, join the agola forum

Extension points exported contracts — how you extend this code

DB (Interface)
(no doc) [5 implementers]
internal/sqlg/manager/manager.go
GitSource (Interface)
(no doc) [4 implementers]
internal/gitsources/gitsource.go
Driver (Interface)
Driver is a generic interface around the pod concept (a group of "containers" sharing, at least, the same network namesp [2 …
internal/services/executor/driver/driver.go
UUIDGenerator (Interface)
(no doc) [3 implementers]
internal/util/uuid.go
ObjStorage (Interface)
(no doc) [2 implementers]
internal/objectstorage/objectstorage.go
RepoAbsPathFunc (FuncType)
RepoAbsPathFunc is a user defined functions that, given the repo path provided in the url request, will return the file
internal/git-handler/handler.go
CheckFunc (FuncType)
(no doc)
internal/testutil/utils.go
Step (Interface)
(no doc)
internal/config/config.go

Core symbols most depended-on inside this repo

NilError
called by 823
internal/testutil/errors.go
NewAPIError
called by 454
internal/util/errors.go
WithAPIErrorMsg
called by 282
internal/util/errors.go
WithAPIErrorMsgf
called by 279
internal/util/errors.go
Error
called by 198
internal/util/errors.go
ID
called by 193
internal/services/executor/driver/driver.go
Do
called by 169
internal/sqlg/manager/manager.go
HTTPError
called by 168
internal/util/http.go

Shape

Method 2,324
Function 998
Struct 771
TypeAlias 99
Interface 23
FuncType 15

Languages

Go100%

Modules by API surface

services/gateway/client/client.go102 symbols
services/configstore/client/client.go85 symbols
internal/services/configstore/db/dml.go78 symbols
internal/migration/destination/configstore/db/dml.go78 symbols
internal/migration/destination/configstore/db/db.go71 symbols
internal/services/gateway/api/user.go66 symbols
internal/services/errors/errors.go66 symbols
internal/services/configstore/db/fetch.go66 symbols
internal/migration/destination/configstore/db/fetch.go66 symbols
internal/services/configstore/db/db.go63 symbols
internal/migration/v0.7.x/source/runservice/types/types.go62 symbols
internal/services/configstore/api/user.go61 symbols

Datastores touched

agola_configstoreDatabase · 1 repos
agola_notificationDatabase · 1 repos
agola_runserviceDatabase · 1 repos

For agents

$ claude mcp add agola \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page