目录搜索
ComposeAbout versions and upgrading (Compose)ASP.NET Core + SQL Server on Linux (Compose)CLI environment variables (Compose)Command-line completion (Compose)Compose(组成)Compose command-line reference(组合命令行参考)Control startup order (Compose)Django and PostgreSQL (Compose)Docker stacks and distributed application bundles (Compose)docker-compose build(docker-compose构建)docker-compose bundledocker-compose configdocker-compose createdocker-compose downdocker-compose eventsdocker-compose execdocker-compose helpdocker-compose imagesdocker-compose killdocker-compose logsdocker-compose pausedocker-compose portdocker-compose psdocker-compose pulldocker-compose pushdocker-compose restartdocker-compose rmdocker-compose rundocker-compose scaledocker-compose startdocker-compose stopdocker-compose topdocker-compose unpausedocker-compose upEnvironment file (Compose)Environment variables in ComposeExtend services in ComposeFrequently asked questions (Compose)Getting started (Compose)Install ComposeLink environment variables (deprecated) (Compose)Networking in ComposeOverview of Docker ComposeOverview of docker-compose CLIQuickstart: Compose and WordPressRails and PostgreSQL (Compose)Sample apps with ComposeUsing Compose in productionUsing Compose with SwarmEngine.NET Core application (Engine)About images, containers, and storage drivers (Engine)Add nodes to the swarm (Engine)Apply custom metadata (Engine)Apply rolling updates (Engine)apt-cacher-ngBest practices for writing Dockerfiles (Engine)Binaries (Engine)Bind container ports to the host (Engine)Breaking changes (Engine)Build your own bridge (Engine)Configure container DNS (Engine)Configure container DNS in user-defined networks (Engine)CouchDB (Engine)Create a base image (Engine)Create a swarm (Engine)Customize the docker0 bridge (Engine)Debian (Engine)Default bridge networkDelete the service (Engine)Deploy a service (Engine)Deploy services to a swarm (Engine)Deprecated Engine featuresDocker container networking (Engine)Docker overview (Engine)Docker run reference (Engine)Dockerfile reference (Engine)Dockerize an applicationDrain a node (Engine)EngineFAQ (Engine)Fedora (Engine)Get started (Engine)Get started with macvlan network driver (Engine)Get started with multi-host networking (Engine)How nodes work (Engine)How services work (Engine)Image management (Engine)Inspect the service (Engine)Install Docker (Engine)IPv6 with Docker (Engine)Join nodes to a swarm (Engine)Legacy container links (Engine)Lock your swarm (Engine)Manage nodes in a swarm (Engine)Manage sensitive data with Docker secrets (Engine)Manage swarm security with PKI (Engine)Manage swarm service networks (Engine)Migrate to Engine 1.10Optional Linux post-installation steps (Engine)Overview (Engine)PostgreSQL (Engine)Raft consensus in swarm mode (Engine)Riak (Engine)Run Docker Engine in swarm modeScale the service (Engine)SDKs (Engine)Select a storage driver (Engine)Set up for the tutorial (Engine)SSHd (Engine)Storage driver overview (Engine)Store service configuration data (Engine)Swarm administration guide (Engine)Swarm mode key concepts (Engine)Swarm mode overlay network security model (Engine)Swarm mode overview (Engine)Understand container communication (Engine)Use multi-stage builds (Engine)Use swarm mode routing mesh (Engine)Use the AUFS storage driver (Engine)Use the Btrfs storage driver (Engine)Use the Device mapper storage driver (Engine)Use the OverlayFS storage driver (Engine)Use the VFS storage driver (Engine)Use the ZFS storage driver (Engine)Engine: Admin GuideAmazon CloudWatch logs logging driver (Engine)Bind mounts (Engine)Collect Docker metrics with Prometheus (Engine)Configuring and running Docker (Engine)Configuring logging drivers (Engine)Control and configure Docker with systemd (Engine)ETW logging driver (Engine)Fluentd logging driver (Engine)Format command and log output (Engine)Google Cloud logging driver (Engine)Graylog Extended Format (GELF) logging driver (Engine)Journald logging driver (Engine)JSON File logging driver (Engine)Keep containers alive during daemon downtime (Engine)Limit a container's resources (Engine)Link via an ambassador container (Engine)Log tags for logging driver (Engine)Logentries logging driver (Engine)PowerShell DSC usage (Engine)Prune unused Docker objects (Engine)Run multiple services in a container (Engine)Runtime metrics (Engine)Splunk logging driver (Engine)Start containers automatically (Engine)Storage overview (Engine)Syslog logging driver (Engine)tmpfs mountsTroubleshoot volume problems (Engine)Use a logging driver plugin (Engine)Using Ansible (Engine)Using Chef (Engine)Using Puppet (Engine)View a container's logs (Engine)Volumes (Engine)Engine: CLIDaemon CLI reference (dockerd) (Engine)dockerdocker attachdocker builddocker checkpointdocker checkpoint createdocker checkpoint lsdocker checkpoint rmdocker commitdocker configdocker config createdocker config inspectdocker config lsdocker config rmdocker containerdocker container attachdocker container commitdocker container cpdocker container createdocker container diffdocker container execdocker container exportdocker container inspectdocker container killdocker container logsdocker container lsdocker container pausedocker container portdocker container prunedocker container renamedocker container restartdocker container rmdocker container rundocker container startdocker container statsdocker container stopdocker container topdocker container unpausedocker container updatedocker container waitdocker cpdocker createdocker deploydocker diffdocker eventsdocker execdocker exportdocker historydocker imagedocker image builddocker image historydocker image importdocker image inspectdocker image loaddocker image lsdocker image prunedocker image pulldocker image pushdocker image rmdocker image savedocker image tagdocker imagesdocker importdocker infodocker inspectdocker killdocker loaddocker logindocker logoutdocker logsdocker networkdocker network connectdocker network createdocker network disconnectdocker network inspectdocker network lsdocker network prunedocker network rmdocker nodedocker node demotedocker node inspectdocker node lsdocker node promotedocker node psdocker node rmdocker node updatedocker pausedocker plugindocker plugin createdocker plugin disabledocker plugin enabledocker plugin inspectdocker plugin installdocker plugin lsdocker plugin pushdocker plugin rmdocker plugin setdocker plugin upgradedocker portdocker psdocker pulldocker pushdocker renamedocker restartdocker rmdocker rmidocker rundocker savedocker searchdocker secretdocker secret createdocker secret inspectdocker secret lsdocker secret rmdocker servicedocker service createdocker service inspectdocker service logsdocker service lsdocker service psdocker service rmdocker service scaledocker service updatedocker stackdocker stack deploydocker stack lsdocker stack psdocker stack rmdocker stack servicesdocker startdocker statsdocker stopdocker swarmdocker swarm cadocker swarm initdocker swarm joindocker swarm join-tokendocker swarm leavedocker swarm unlockdocker swarm unlock-keydocker swarm updatedocker systemdocker system dfdocker system eventsdocker system infodocker system prunedocker tagdocker topdocker unpausedocker updatedocker versiondocker volumedocker volume createdocker volume inspectdocker volume lsdocker volume prunedocker volume rmdocker waitUse the Docker command line (Engine)Engine: ExtendAccess authorization plugin (Engine)Docker log driver pluginsDocker network driver plugins (Engine)Extending Engine with pluginsManaged plugin system (Engine)Plugin configuration (Engine)Plugins API (Engine)Volume plugins (Engine)Engine: SecurityAppArmor security profiles for Docker (Engine)Automation with content trust (Engine)Content trust in Docker (Engine)Delegations for content trust (Engine)Deploying Notary (Engine)Docker security (Engine)Docker security non-events (Engine)Isolate containers with a user namespace (Engine)Manage keys for content trust (Engine)Play in a content trust sandbox (Engine)Protect the Docker daemon socket (Engine)Seccomp security profiles for Docker (Engine)Secure EngineUse trusted imagesUsing certificates for repository client verification (Engine)Engine: TutorialsEngine tutorialsNetwork containers (Engine)Get StartedPart 1: OrientationPart 2: ContainersPart 3: ServicesPart 4: SwarmsPart 5: StacksPart 6: Deploy your appMachineAmazon Web Services (Machine)Digital Ocean (Machine)docker-machine activedocker-machine configdocker-machine createdocker-machine envdocker-machine helpdocker-machine inspectdocker-machine ipdocker-machine killdocker-machine lsdocker-machine provisiondocker-machine regenerate-certsdocker-machine restartdocker-machine rmdocker-machine scpdocker-machine sshdocker-machine startdocker-machine statusdocker-machine stopdocker-machine upgradedocker-machine urlDriver options and operating system defaults (Machine)Drivers overview (Machine)Exoscale (Machine)Generic (Machine)Get started with a local VM (Machine)Google Compute Engine (Machine)IBM Softlayer (Machine)Install MachineMachineMachine CLI overviewMachine command-line completionMachine concepts and helpMachine overviewMicrosoft Azure (Machine)Microsoft Hyper-V (Machine)Migrate from Boot2Docker to MachineOpenStack (Machine)Oracle VirtualBox (Machine)Provision AWS EC2 instances (Machine)Provision Digital Ocean Droplets (Machine)Provision hosts in the cloud (Machine)Rackspace (Machine)VMware Fusion (Machine)VMware vCloud Air (Machine)VMware vSphere (Machine)NotaryClient configuration (Notary)Common Server and signer configurations (Notary)Getting started with NotaryNotary changelogNotary configuration filesRunning a Notary serviceServer configuration (Notary)Signer configuration (Notary)Understand the service architecture (Notary)Use the Notary client
文字

编写卷插件

Docker Engine卷插件使引擎部署能够与Amazon EBS等外部存储系统集成,并使数据卷在单个Docker主机的生命周期之后持续存在。有关更多信息,请参阅插件文档。

更新日志

1.13.0

  • 如果用作v2插件体系结构的一部分,则作为插件返回路径一部分的挂载点必须安装在PropagatedMount插件配置(#26398)指定的目录下1.12.0

  • Status字段添加到VolumeDriver.Get响应(#21006)

  • 添加VolumeDriver.Capabilities以获得卷驱动程序的功能(#22077)

1.10.0

  • 添加VolumeDriver.Get获取有关卷的详细信息(#16534)

  • 添加VolumeDriver.List列出驱动程序拥有的所有卷(#16534)

1.8.0

  • 对卷驱动程序插件的初始支持(#14659)

命令行更改

要为容器提供对卷的访问权限,请在命令中使用--volume--volume-driver标志docker container run--volume(或-v)标志接受主机上卷名称和路径,以及--volume-driver标志接受驱动程序类型。

$ docker volume create --driver=flocker volumename

$ docker container run -it --volume volumename:/data busybox sh

--volume

--volume(或-v)标志取值是在格式 <volume_name>:<mountpoint>。值的两部分用冒号(:)分隔。

  • 卷名称是卷的可读的名称,不能以/性格。它被称为volume_name在本主题的其余部分。

  • Mountpoint是主机(v1)或插件(v2)中卷的可用路径。

volumedriver

通过volumedrivervolumename联合指定,您可以使用插件(如Flocker)来管理单个主机(例如EBS上的那些主机)的外部卷。

创建一个VolumeDriver

容器创建endpoint(/containers/create)接受允许指定驱动程序名称的VolumeDriver类型字段string。如果未指定,则默认为"local"(本地卷的默认驱动程序)。

卷插件协议

如果插件将自己注册为VolumeDriver激活时,它必须为主机文件系统上的可写路径提供Docker守护程序。Docker守护进程提供了这些路径以供容器使用。Docker守护进程通过将提供的路径绑定到容器中来使这些卷可用。

:音量插件应该将数据写入到/var/lib/docker/目录,包括/var/lib/docker/volumes。该/var/lib/docker/目录是为Docker保留的。

/VolumeDriver.Create

请求

{    "Name": "volume_name",    "Opts": {}}

指定插件用户想要创建一个卷,给定用户指定的卷名称。该插件不需要在文件系统上实际显示音量(直到Mount被调用)。Opts是从用户请求传递的驱动程序特定选项的映射。

响应

{    "Err": ""}

如果发生错误,则返回字符串错误。

/VolumeDriver.Remove

请求

{    "Name": "volume_name"}

从磁盘删除指定的卷。当用户调用docker rm -v删除与容器关联的卷时,会发出此请求。

响应

{    "Err": ""}

如果发生错误,则返回字符串错误。

/VolumeDriver.Mount

请求

{    "Name": "volume_name",    "ID": "b87d7442095999a92b65b3d9691e697b61713829cc0ffd1bb72e4ccd51aa4d6c"}

给定用户指定的卷名,Docker需要该插件提供卷。Mount在每个容器启动时调用一次。如果volume_name多次请求相同,则插件可能需要跟踪第一个安装请求中的每个新的安装请求和供应,并在最后一个相应的卸载请求处取消配置。

ID 是请求挂载的呼叫者的唯一ID。

响应

  • v1: {     "Mountpoint": "/path/to/directory/on/host",     "Err": "" }

  • v2:

{     "Mountpoint": "/path/under/PropagatedMount",     "Err": "" }

Mountpoint 是主机(v1)或插件(v2)中卷的可用路径。

Err 是空的或包含错误字符串。

/VolumeDriver.Path

请求

{    "Name": "volume_name"}

用给定的方式请求卷的路径volume_name

响应

  • v1: {     "Mountpoin": "/path/to/directory/on/host",     "Err": "" }

  • v2:

{     "Mountpoint": "/path/under/PropagatedMount",     "Err": "" }

响应主机(v1)上的路径或插件(v2)中可用的卷的路径,和/或发生错误时的字符串错误。

Mountpoint是可选的。但是,如果没有提供插件,稍后可能会再次查询该插件。

/VolumeDriver.Unmount

请求

{    "Name": "volume_name",    "ID": "b87d7442095999a92b65b3d9691e697b61713829cc0ffd1bb72e4ccd51aa4d6c"}

Docker不再使用指定的卷。Unmount每集装箱停靠一次。插件可能会推断出在这个时候取消配置音量是安全的。

ID 是请求挂载的调用者的唯一ID。

响应

{    "Err": ""}

如果发生错误,则返回字符串错误。

/VolumeDriver.Get

请求

{    "Name": "volume_name"}

获取有关信息volume_name

响应

  • v1: {   "Volume": {     "Name": "volume_name",     "Mountpoint": "/path/to/directory/on/host",     "Status": {}   },   "Err": "" }

  • v2:

{   "Volume": {     "Name": "volume_name",     "Mountpoint": "/path/under/PropagatedMount",     "Status": {}   },   "Err": "" }

如果发生错误,则返回字符串错误。Mountpoint并且Status是可选的。

/VolumeDriver.List

Request:

{}

获取插件注册的卷列表。

响应:

  • v1: {   "Volumes":      {       "Name": "volume_name",       "Mountpoint": "/path/to/directory/on/host"     }   ,   "Err": "" }

  • v2:

{   "Volumes":      {       "Name": "volume_name",       "Mountpoint": "/path/under/PropagatedMount"     }   ,   "Err": "" }

如果发生错误,则返回字符串错误。Mountpoint是可选的。

/VolumeDriver.Capabilities

请求

{}

获取驱动程序支持的功能列表。

司机不需要执行Capabilities。如果未实施,则使用默认值。

响应

{  "Capabilities": {    "Scope": "global"  }}

受支持的范围是globallocal。其他任何值都Scope将被忽略,并被local使用。Scope允许集群管理者以不同的方式处理卷。例如,作用域的global信号告诉集群管理器只需创建一次卷而不是在每台Docker主机上创建卷。未来可能会增加更多功能。

上一篇:下一篇: