https://github.com/vtex/act

A git-based configuration management and evolution tool
https://github.com/vtex/act

Last synced: about 1 month ago
JSON representation

A git-based configuration management and evolution tool

• Host: GitHub
• URL: https://github.com/vtex/act
• Owner: vtex
• Created: 2020-05-30T02:40:53.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-05-31T22:43:49.000Z (about 6 years ago)
• Last Synced: 2025-01-26T10:08:18.904Z (over 1 year ago)
• Language: TypeScript
• Size: 514 KB
• Stars: 2
• Watchers: 19
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: docs/README.md

Awesome Lists containing this project

README

          
# act - WORK IN PROGRESS 

> *~think~ act different*

*app config tree*  

*automatic config tool*  

*autonomy creates trust*  

*alignment causes transformation*  

*TODO: create a three-word image generator as WIP for act itself.*  

`act` is a CLI tool that manages service configuration in a predictable, explicit and versioned way. 

`act` helps **developers** make services configurable by allowing them to declare *builders* that build *configs* into an *immutable service state* for consumption by a *runtime*. 

`act` helps **application users** manage service configuration by allowing them to install and uninstall *apps* (packages of builders, configs or runtimes) in *tenants*, which result in different behaviours when combined. 

`act` treats *code as configuration*, inspired by [Facebook's `configerator`](https://research.fb.com/wp-content/uploads/2016/11/holistic-configuration-management-at-facebook.pdf) and VTEX IO [`apps and workspaces`](https://vtex.io/docs/concepts/workspace/).

`act` is based on `git` and `deno`. It uses `git` to version both tenants and apps. It uses `deno` to implement a DSL that defines the core concepts of `builders`, `runtimes`, `configs`, etc.

`act` is intended to be used as your **control plane**. It builds and versions state which must then be made available to a **runtime**. How you deploy said runtime and how do you store said state is up to you.

`act.pm` is the canonical `act` package manager. It follows the philosophy of `deno.land/x` and implements a rewriter for GitHub. 

![Act overview](act-overview.png)

Contents: 

- [Getting started](/docs/getting-started.md)

- [Architecture](/docs/architecture.md)