https://github.com/jdenen/crucible
https://github.com/jdenen/crucible
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jdenen/crucible
- Owner: jdenen
- License: apache-2.0
- Created: 2018-12-12T16:06:17.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-04-02T01:33:35.000Z (about 6 years ago)
- Last Synced: 2025-01-21T22:45:06.595Z (5 months ago)
- Language: Elixir
- Size: 36.1 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Crucible
Code as infrastructure with Elixir
## Idea
"Infrastructure as code" is a misnomer.
We should call it "infrastructure as configuration" or "infrastructure as data"
because YAML (Ansible/CloudFormation) and glorified JSON (Terraform) are not code.
Just as functional languages enable us to treat
[code as data](https://blogs.mulesoft.com/dev/news-dev/code-is-data-data-is-code/),
I believe they give us the ability to treat code as infrastructure.
Crucible is going to explore this idea.
## Core concepts
1. Declarative and idempotent
2. Granular control of create/delete/rollback behavior
3. Rollbacks as a first class citizen
4. Testing as a first class citizen
5. Does not track state outside of execution
## Thought dump
```elixir
defmodule My.Vpc do
@moduledoc """
Some thoughts on what the end goal could look like.
"""
use Crucible.DSL
vpc(:my_vpc) do
subnet :my_subnet_1, cidr: "10.0.3.0/24" do
vm :jenkins do
end
vm :foobar do
end
end
subnet :my_subnet_2, cidr: "10.0.4.0/24" do
on_create fn x -> do_something(x) end
end
end
end
```
## Installation
If [available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `crucible` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:crucible, "~> 0.0.1"}
]
end
```
Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at [https://hexdocs.pm/crucible](https://hexdocs.pm/crucible).
## Contributing
1. Fork the project
2. Make change(s) on a feature branch of your fork
3. Run `docker build .` to validate formatting, style, and tests
4. Submit a PR