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

Unclear volume:external documentation #19938

Open
1 task done
pkese opened this issue May 1, 2024 · 0 comments
Open
1 task done

Unclear volume:external documentation #19938

pkese opened this issue May 1, 2024 · 0 comments
Labels
area/compose Relates to docker-compose.yml spec or docker-compose binary

Comments

@pkese
Copy link

pkese commented May 1, 2024

Is this a docs issue?

  • My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

In the https://docs.docker.com/compose/compose-file/07-volumes/ in volumes section for external it says:

External
If set to true:

  • external specifies that this volume already exists on the platform and its lifecycle is managed outside of that of the application. Compose doesn't then create the volume, and returns an error if the volume doesn't exist.
  • All other attributes apart from name are irrelevant. If Compose detects any other attribute, it rejects the Compose file as invalid.

In the example below, instead of attempting to create a volume called {project_name}_db-data, Compose looks for an existing volume simply called db-data and mounts it into the backend service's containers.

It's unclear what are the steps required on user's side to get an external volume to work (and get populated).

Where does it mount it from?

Can I just copy (or bind-mount) my data directly into to /var/lib/docker/volumes/db-data and expect it to work?

Location

https://docs.docker.com/compose/compose-file/07-volumes/

Suggestion

No response

@pkese pkese added the status/triage Needs triage label May 1, 2024
@aevesdocker aevesdocker added area/compose Relates to docker-compose.yml spec or docker-compose binary and removed status/triage Needs triage labels May 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/compose Relates to docker-compose.yml spec or docker-compose binary
Projects
None yet
Development

No branches or pull requests

2 participants