README
¶
moov-io/infra
This repository holds the configurion for moov.io's infrastructure. If you believe you have identified a security vulnerability please responsibly report the issue as via email to security@moov.io. Please do not post it to a public issue tracker.
Links: Graphs | Logs | Metrics | Alerts
Project Goals
This project aims to be the structure and runtime for a fully automated hosting of moov.io services.
Getting started
To get started working on this project, pull down (git clone git@github.com:moov-io/infra) the source code and setup some tools: Golang, Terraform, kubectl, etc. The following list consists of all tools used and expected by the infra repository.
- Golang
- Terraform 0.12+ | Download | Intro
- kubectl | Download | Intro
- Blackbox (Installed at
./lib/blackbox/bin, add this toPATH) - gcloud CLI
- Docker for either Linux or macOS.
On macOS these tools can be installed with the following homebrew command:
$ brew install gpg2 jq make terraform go
The project has the following directories:
cmd/- Various command line utilities used in this project and as testsdocs/- Human readable documentation.envs/envs/oss- Our Open Source environment
images/- Docker images we create and managelib/- Shared (Kubernetes) resources across environments
Local Development
We support a local development environment to allow anyone the ability to run Moov's application stack locally on a machine. This currently requires a few tools to be installed, such as:
Testing
We run several kinds of tests against this repository. Linters/validators (over Kubernetes, Terraform, Prometheus configs) as well as Docker image builds. To run all these:
$ make test
Note: To run these tests you need Docker installed.
Runbooks
- Alerting
- Google Cloud (GKE)
- In-repo Secrets (Blackbox)
- Kubernetes
- Load balancing / Routing (Traefik)
- Downloading fuzz data
Getting Help
| channel | info |
|---|---|
| Twitter @moov | You can follow Moov.io's Twitter feed to get updates on our project(s). You can also tweet us questions or just share blogs or stories. |
| GitHub Issue | If you are able to reproduce a problem please open a GitHub Issue under the specific project that caused the error. |
| moov-io slack | Join our slack channel to have an interactive discussion about the development of the project. |
Contributing
Yes please! Please review our Contributing guide and Code of Conduct to get started!
License
Apache License 2.0 See LICENSE for details.
Documentation
¶
Overview ¶
Package infra is a collection of libraries and CLI tools used to automate Moov.io's deployment and infrastructure services.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
dockertest
dockertest is a quick cli tool used to test docker image building in relative directories
|
dockertest is a quick cli tool used to test docker image building in relative directories |
|
images
|
|
|
pkg
|
|
|
gofuzz
gofuzz is a package to parse go-fuzz log lines.
|
gofuzz is a package to parse go-fuzz log lines. |