Looking for a "hello world" tutorial for convoy

mathuin · June 17, 2016, 6:43am

rancher/convoy/blob/master/README.md

# Convoy [![Build Status](https://drone.rancher.io/api/badges/rancher/convoy/status.svg)](https://drone.rancher.io/rancher/convoy)

## Overview
Convoy is a  Docker volume plugin for a variety of storage back-ends. It's designed to be a simple Docker volume plug-ins that supports vendor-specific extensions such as snapshots, backups and restore. It's written in Go and can be deployed as a standalone binary.

[![Convoy_DEMO](https://asciinema.org/a/9y5nbp3h97vyyxnzuax9f568e.png)](https://asciinema.org/a/9y5nbp3h97vyyxnzuax9f568e?autoplay=1&loop=1&size=medium&speed=2)

## Why we need Convoy?
Docker has various drivers(aufs, device mapper, etc) for container's root image, but not for volumes. User can create volume through ```docker run -v volname```, but it's disposable, cannot be easily reused for new containers or containers on the other hosts. For example, if you start a wordpress container with database, add some posts, remove the container, then the modified database would lost.

Before volume plugin, the only way to reuse the volume is using host bind mount feature of Docker, as ```docker run -v /host_path:/container_path```, then maintain the content of the volume at ```/host_path```. You can also use ```--volume-from``` but that would require original container still exists on the same host.

Convoy used Docker volume plugin mechanism to provide persistent volume for Docker containers, and supports various of backends(e.g. device mapper, NFS, EBS) and more features like snapshot/backup/restore. So user would able to migrate the volumes between the hosts, share the same volume across the hosts, make scheduled snapshots of as well as recover to previous version of volume. It's much easier for user to manage data with Docker volumes with Convoy.

### Backends supported by Convoy currently
* Device Mapper
* Virtual File System(VFS)/Network File System(NFS)
* Amazon Elastic Block Store(EBS)

## Quick Start Guide

This file has been truncated. show original

This file has enough information for me to add Convoy to one of my Rancher hosts, but I’m getting errors when I try to create a Convoy volume.

My docker-compose.yml has the same information as this example, but I’m getting errors:

Error (500 Server Error: Internal Server Error ("Failed to execute: mount [/dev/mapper/mcdata /var/lib/rancher/convoy/devicemapper/mounts/mcdata], output mount: mounting /dev/mapper/mcdata on /var/lib/rancher/convoy/devicemapper/mounts/mcdata failed: Invalid argument , error exit status 255"))

And because there’s no simple example, I can’t tell if I’m doing something wrong or if there’s some kind of bug in Rancher or in Convoy. Help!

If supplying more details will help diagnose my specific issue, let me know. I think a general up to date tutorial would be helpful for all.

mathuin · June 21, 2016, 11:38pm

An update to my personal progress with Convoy:

I was able to get Convoy working with EBS on AWS, but not devicemapper.
Convoy is not production-ready. There’s three or four relatively obvious issues but they’re adequately mentioned in the repository so I won’t go into them in great detail here, but getting it into a container with a Docker volume for configuration would solve 99% of my issues.
Once it’s containerized, a new tutorial will make all the difference for everyone.

Thank you for making such an interesting product. Convoy has a lot of potential, but right now it introduces too many variables into my setup. Looking forward to seeing it develop!

BenjaminBower · September 28, 2021, 3:29pm

I agree with you. I’m also waiting for its development!

Topic		Replies	Views
Is convoy project deprecated? Convoy	2	3569	September 7, 2018
Docker volumes backup Rancher 1.x	9	3188	November 9, 2016
Replacement for Convoy Convoy	0	1815	August 17, 2016
Using convoy device mapper, gluster, for snapshots, volume managment Convoy	1	2221	June 14, 2016
Can't find any Convoy in the catalog Convoy	4	2497	January 29, 2019

Looking for a "hello world" tutorial for convoy

Related Topics