Skip to content

Glossary

Recipe

A recipe is what we call the configuration files that are used to deploy an app. When you run abra app deploy <domain>, abra is reading a recipe configuration, such as the gitea recipe, in order to know how to deploy a new Gitea instance. When we speak of a "digital configuraiton commons", we're primarily referring to the growing collection of recipes.

App

An app is a website, tool or otherwise libre software that you use. E.g. Wordpress, Gitea, Jitsi, Nextcloud, etc.

Abra

A command-line tool that has been developed specifically in the context of the Co-op Cloud project for the purpose of making day-to-day operations for operators and maintainers as convenient as possible. It is libre software, written in Go and maintained and extended by the community. You can find the source here.

Container

TODO.

Stack

One or more services running together to provide a functionality. An app

Docker

TODO.

Service

A single Docker container that is a part of a stack.

Deployment

The act of assembling a Docker stack described by a recipe configuration.

Image

A template for creating containers, describing their file structure and installed binaries.

Container

An instance of an image, running processes that are isolated from the host system.

Environment variables

Variables passed from the shell to processes invoked by it. They are used for configuring services.

The .env file

A file contained in a recipe describing the contents of environmental variables.

Proxy network

A virtual network created on the server machine used for communicating between services. Any service can be plugged into more than one network, allowing for control over data sharing between them.

Secret

Docker uses those for securely storing data such as passwords. They are stored encrypted on disk and mounted inside the containers as files that can be read that contain the secret.

Volume

A directory that can be mounted inside a Docker container to store data. Because containers are meant to be non-changeable and disposable, any data that is supposed to not be lost between updates or restarts is stored in volumes.