Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use docker volumes in docker instructions #9185

Closed
jbowens opened this issue Dec 15, 2020 · 1 comment · Fixed by #9216
Closed

Use docker volumes in docker instructions #9185

jbowens opened this issue Dec 15, 2020 · 1 comment · Fixed by #9216

Comments

@jbowens
Copy link

jbowens commented Dec 15, 2020

In the Start a Cluster in Docker (Insecure) instructions, we provide instructions for starting three nodes in docker containers all writing through to the host filesystem. There is a bug (see cockroachdb/cockroach#57192, docker/for-mac#5124) in the current default Docker for Mac implementation of file sharing. The bug causes missing files and permanent crashes of the nodes.

Disabling the gRPC FUSE file sharing option in Docker for Mac is one workaround. Another workaround, recommended by a Docker engineer, is to use docker volumes: docker/for-mac#5124 (comment) . This is also expected to be more performant.

I think we should update the documentation to instruct users to create a separate volume per container:

docker volume create roach1
docker volume create roach2
docker volume create roach3

And then update the -v flag to pass the volume identifer:

-v "roach1:/cockroach/cockroach-data" \
@jseldess
Copy link
Contributor

@taroface, this fixes a bad UX problem running us in docker on mac. Can you squeeze in this fix?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants