docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Oss 5 (#22383) 

<!--Delete sections as needed -->

## Description

https://docker.atlassian.net/browse/OSS-5

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
This commit is contained in:
Allie Sadler 2025-04-14 11:09:33 +01:00 committed by GitHub
parent d111b09ddb
commit 013c3abd81
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
content/manuals/engine/storage/volumes.md
View File

@ -526,7 +526,7 @@ store data in the cloud, without changing the application logic.
When you create a volume using `docker volume create`, or when you start a When you create a volume using `docker volume create`, or when you start a
container which uses a not-yet-created volume, you can specify a volume driver. container which uses a not-yet-created volume, you can specify a volume driver.
The following examples use the `vieux/sshfs` volume driver, first when creating The following examples use the `rclone/docker-volume-rclone` volume driver, first when creating
a standalone volume, and then when starting a container which creates a new a standalone volume, and then when starting a container which creates a new
volume. volume.
@ -555,27 +555,29 @@ host and can connect to the second node using SSH.
On the Docker host, install the `vieux/sshfs` plugin: On the Docker host, install the `vieux/sshfs` plugin:
```console ```console
$ docker plugin install --grant-all-permissions vieux/sshfs $ docker plugin install --grant-all-permissions rclone/docker-volume-rclone --aliases rclone
``` ```
### Create a volume using a volume driver ### Create a volume using a volume driver
This example specifies an SSH password, but if the two hosts have shared keys This example mounts the `/remote` directory on host `1.2.3.4` into a
configured, you can exclude the password. Each volume driver may have zero or more volume named `rclonevolume`. Each volume driver may have zero or more
configurable options, you specify each of them using an `-o` flag. configurable options, you specify each of them using an `-o` flag.
```console ```console
$ docker volume create --driver vieux/sshfs \ $ docker volume create \
-o sshcmd=test@node2:/home/test \ -d rclone \
-o password=testpassword \ --name rclonevolume \
sshvolume -o type=sftp \
-o path=remote \
-o sftp-host=1.2.3.4 \
-o sftp-user=user \
-o "sftp-password=$(cat file_containing_password_for_remote_host)"
``` ```
### Start a container which creates a volume using a volume driver This volume can now be mounted into containers.
The following example specifies an SSH password. However, if the two hosts have ### Start a container which creates a volume using a volume driver
shared keys configured, you can exclude the password.
Each volume driver may have zero or more configurable options.
> [!NOTE] > [!NOTE]
> >
@ -584,8 +586,8 @@ Each volume driver may have zero or more configurable options.
```console ```console
$ docker run -d \ $ docker run -d \
--name sshfs-container \ --name rclone-container \
--mount type=volume,volume-driver=vieux/sshfs,src=sshvolume,target=/app,volume-opt=sshcmd=test@node2:/home/test,volume-opt=password=testpassword \ --mount type=volume,volume-driver=rclone,src=rclonevolume,target=/app,volume-opt=type=sftp,volume-opt=path=remote, volume-opt=sftp-host=1.2.3.4,volume-opt=sftp-user=user,volume-opt=-o "sftp-password=$(cat file_containing_password_for_remote_host)" \
nginx:latest nginx:latest
``` ```