dotmesh - GitLite

KO | EN

gitlite — search

#ai #typescript #golang #machine-learning #rust #deep-learning #docker #macos #windows #awesome-list #pytorch #security #ios #openai

dotmesh

(★ 535)

dotmesh (dm) is like git for your data volumes (databases, files etc) in Docker and Kubernetes

File Explorer

Download Latest Version (.zip)

Showing a partial file list — download the zip above to see everything.

- - dotmesh.go
  - Gopkg.lock
  - Gopkg.toml
- - auth_handler.go
  - checkupdates.go
  - controller.go
  - controller_fsm.go
  - diff_handlers.go
  - docker.go
  - dockerclient.go
  - Dockerfile
  - etcd.go
  - etcd_filesystem_watchers.go
  - etcd_registry_watchers.go
  - etcd_server_watchers.go
  - Gopkg.lock
  - Gopkg.toml
  - http.go
  - http_test.go
  - kubernetes.go
  - liveness.go
  - main.go
  - messaging.go
  - replication.go
  - require_zfs.sh
  - rpc.go
  - s3_handlers.go
  - shutdown.sh
  - types.go
  - users.go
  - utils.go
- - dm-provisioner.go
  - Gopkg.lock
  - Gopkg.toml
.dockerignore
.gitignore
.gitlab-ci.yml
ISSUE_TEMPLATE.md
LICENSE
Makefile
README.md
Vagrantfile

# Installation Guide

1. Get the code

git clone https://github.com/dotmesh-io/dotmesh

Downloads the entire project code from GitHub to your computer.

cd dotmesh

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

Checking suitable Docker is installed... yes, got 17.12.0-ce.

Type this command into your terminal and run it.

Pulling dotmesh-server docker image...

Type this command into your terminal and run it.

docker run -d --volume-driver dm \

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

3. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make

Compiles the code based on the generated build configuration to produce an executable.

✅ If it finishes without errors, it worked. Try running the generated executable directly.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# dotmesh: git for data

[![pipeline status](https://gitlab.dotmesh.com/dotmesh/dotmesh/badges/master/pipeline.svg)](https://gitlab.dotmesh.com/dotmesh/dotmesh/commits/master)

Dotmesh is a **git-like CLI for capturing, organizing and sharing application states**.

In other words, it's a **snapshotting tool for databases** and other filesystem states.

The application states that dotmesh captures are stored in **datadots**.

It can capture the state of multiple databases, each one in a [subdot](https://docs.dotmesh.com/concepts/what-is-a-datadot/#subdots), in a single atomic commit.

## installing on docker (Mac or Ubuntu 16.04+)

Install the dotmesh client `dm`:

```plain
sudo curl -sSL -o /usr/local/bin/dm \
    https://get.dotmesh.io/$(uname -s)/dm
```

Make the client binary executable.
```plain
sudo chmod +x /usr/local/bin/dm
```

Then use the client to install `dotmesh-server`, assuming you have Docker installed and your user account has access to the Docker daemon.

```plain
dm cluster init
```

```plain
Checking suitable Docker is installed... yes, got 17.12.0-ce.
Checking dotmesh isn't running... done.
Pulling dotmesh-server docker image...
[...]
```

This will set up a single-instance cluster on your local machine.

Verify that the `dm` client can talk to the `dotmesh-server`:
```
dm version
```

If the installation fails, please [report an issue](https://github.com/dotmesh-io/dotmesh).
You can also experiment in our [online learning environment](https://dotmesh.com/try-dotmesh/).
Thanks!

See [the installation docs](https://docs.dotmesh.com/install-setup/) for more details, including installing dotmesh on Kubernetes.

## getting started guide

Try our [hosted tutorial](https://dotmesh.com/try-dotmesh/)!

Alternatively, try the [hello Dotmesh on Docker](https://docs.dotmesh.com/tutorials/hello-dotmesh-docker/) guided tutorial.

## what is a datadot?

A **datadot** allows you to capture your application's state and treat it like a `git` repo.

A simple example is to start a PostgreSQL container using a datadot called `myapp`:

```bash
docker run -d --volume-driver dm \
    -v myapp:/var/lib/postgresql/data --name postgres postgres:9.6.6
```

This creates a datadot called `myapp`, creates the writeable filesystem for the default `master` branch in that datadot, mounts the writeable filesystem for the `master` branch into `/var/lib/postgresql/data` in the `postgres` container, and starts the `postgres` container, like this:

![myapp dot with master branch and postgres container's /data volume attached](https://raw.githubusercontent.com/dotmesh-io/dotmesh/master/datadot.png "Diagram of a datadot")

First, switch to it, which, like `cd`'ing into a git repo, makes it the "current" dot -- the dot which later `dm` commands will operate on by default:

```bash
dm switch myapp
```

You can then see the `dm list` output:

```bash
dm list
```

```plain
  DOT      BRANCH  SERVER   CONTAINERS  SIZE       COMMITS  DIRTY
* myapp    master  a1b2c3d  /postgres   40.82 MiB  0        40.82 MiB
```
The current branch is shown in the `BRANCH` column and the current dot is marked with a `*` in the `dm list` output.

## what's next?

* Learn more in the [concept docs](https://docs.dotmesh.com/concepts/what-is-a-datadot/).
* Try another [tutorial](https://docs.dotmesh.com/tutorials/).